@copado/agentia-cli 1.1.0 → 1.2.0

package/dist/commands/testing/{logs.js → job/runs/logs.js}

@@ -1,17 +1,19 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../lib/agentia-command.js';
-import { testingJobFlag, testingLogOptionFlags, testingOutputFlags, testingProjectFlag, } from '../../lib/testing-flags.js';
-import { getTestingBuildLogs } from '../../lib/testing-operations.js';
-export default class TestingLogs extends AgentiaCommand {
+import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { testingJobFlag, testingLogOptionFlags, testingOutputFlags, testingProjectFlag, } from '../../../../lib/testing-flags.js';
+import { getTestingBuildLogs } from '../../../../lib/testing-operations.js';
+export default class TestingJobRunsLogs extends AgentiaCommand {
     static args = {
         id: Args.integer({
             description: 'CRT build/run ID.',
             required: true,
         }),
     };
-    static description = 'Get logs for a Copado Robotic Testing run';
+    static deprecateAliases = true;
+    static description = 'Get logs for a Copado Robotic Testing job run';
     static examples = [
         '<%= config.bin %> <%= command.id %> <build-id> --project <project-id> --job <job-id>',
+        '<%= config.bin %> <%= command.id %> <build-id> --project <project-id> --job <job-id> --tail-lines 200',
         '<%= config.bin %> <%= command.id %> <build-id> --project <project-id> --job <job-id> --output log.html --json',
     ];
     static flags = {
@@ -20,8 +22,9 @@ export default class TestingLogs extends AgentiaCommand {
         ...testingLogOptionFlags,
         ...testingOutputFlags,
     };
+    static hiddenAliases = ['testing:logs', 'testing:test:logs', 'testing:build:logs'];
     async run() {
-        const { args, flags } = await this.parse(TestingLogs);
+        const { args, flags } = await this.parse(TestingJobRunsLogs);
         const result = await this.withSpinner('Fetching testing run logs', () => getTestingBuildLogs({
             buildId: args.id,
             container: flags.container,

package/dist/commands/testing/{build → job/runs}/search.js

@@ -1,10 +1,11 @@
 import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingJobFlag, testingProjectFlag } from '../../../lib/testing-flags.js';
-import { searchTestingBuilds } from '../../../lib/testing-operations.js';
-import { formatTestingBuildTable, TESTING_RUN_TYPES, } from '../../../lib/testing-types.js';
-export default class TestingBuildSearch extends AgentiaCommand {
-    static description = 'Search Copado Robotic Testing build metrics';
+import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { testingJobFlag, testingProjectFlag } from '../../../../lib/testing-flags.js';
+import { searchTestingBuilds } from '../../../../lib/testing-operations.js';
+import { formatTestingBuildTable, TESTING_RUN_TYPES, } from '../../../../lib/testing-types.js';
+export default class TestingJobRunsSearch extends AgentiaCommand {
+    static deprecateAliases = true;
+    static description = 'Search Copado Robotic Testing job run metrics';
     static examples = [
         '<%= config.bin %> <%= command.id %> --project <project-id> --job <job-id> --status failed',
         '<%= config.bin %> <%= command.id %> --project <project-id> --job <job-id> --run-type regression --count --json',
@@ -27,8 +28,9 @@ export default class TestingBuildSearch extends AgentiaCommand {
         status: Flags.string({ description: 'Status filter. Can be provided multiple times.', multiple: true }),
         to: Flags.string({ description: 'Include builds at or before this ISO-8601 date or epoch value.' }),
     };
+    static hiddenAliases = ['testing:build:search'];
     async run() {
-        const { flags } = await this.parse(TestingBuildSearch);
+        const { flags } = await this.parse(TestingJobRunsSearch);
         const result = await this.withSpinner('Searching testing builds', () => searchTestingBuilds({
             count: flags.count,
             from: flags.from,

package/dist/commands/testing/job/schedule/get.js

@@ -1,13 +1,13 @@
 import { Args } from '@oclif/core';
 import { AgentiaCommand } from '../../../../lib/agentia-command.js';
 import { testingProjectFlag } from '../../../../lib/testing-flags.js';
-import { getTestingJobSchedule } from '../../../../lib/testing-schedule.js';
+import { getTestingJobScheduleStatus } from '../../../../lib/testing-operations.js';
 import { formatTestingRecord } from '../../../../lib/testing-types.js';
 export default class TestingJobScheduleGet extends AgentiaCommand {
     static args = {
-        id: Args.integer({ description: 'CRT job/test ID.', required: true }),
+        id: Args.integer({ description: 'CRT job ID.', required: true }),
     };
-    static description = 'Get the schedule for a Copado Robotic Testing job/test';
+    static description = 'Get the schedule for a Copado Robotic Testing job';
     static examples = [
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id>',
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --json',
@@ -15,15 +15,9 @@ export default class TestingJobScheduleGet extends AgentiaCommand {
     static flags = { ...testingProjectFlag };
     async run() {
         const { args, flags } = await this.parse(TestingJobScheduleGet);
-        const schedule = await this.withSpinner('Getting testing schedule', () => getTestingJobSchedule({ jobId: args.id, projectId: flags.project }));
-        const result = {
-            configured: schedule !== undefined,
-            jobId: args.id,
-            projectId: flags.project,
-            ...(schedule === undefined ? {} : { schedule }),
-        };
+        const result = await this.withSpinner('Getting testing schedule', () => getTestingJobScheduleStatus({ jobId: args.id, projectId: flags.project }));
         this.display(() => {
-            this.log(schedule === undefined ? 'No schedule configured.' : formatTestingRecord(schedule));
+            this.log(result.schedule === undefined ? 'No schedule configured.' : formatTestingRecord(result.schedule));
         });
         return result;
     }

package/dist/commands/testing/job/schedule/remove.js

@@ -2,12 +2,12 @@ import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../../lib/agentia-command.js';
 import { confirmTestingAction } from '../../../../lib/testing-confirmation.js';
 import { testingProjectFlag } from '../../../../lib/testing-flags.js';
-import { removeTestingJobSchedule } from '../../../../lib/testing-schedule.js';
+import { removeTestingJobSchedule } from '../../../../lib/testing-operations.js';
 export default class TestingJobScheduleRemove extends AgentiaCommand {
     static args = {
-        id: Args.integer({ description: 'CRT job/test ID.', required: true }),
+        id: Args.integer({ description: 'CRT job ID.', required: true }),
     };
-    static description = 'Remove the schedule from a Copado Robotic Testing job/test';
+    static description = 'Remove the schedule from a Copado Robotic Testing job';
     static examples = [
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --yes',
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --yes --json',

package/dist/commands/testing/job/schedule/set.js

@@ -1,13 +1,13 @@
 import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../../lib/agentia-command.js';
 import { testingProjectFlag } from '../../../../lib/testing-flags.js';
-import { setTestingJobSchedule } from '../../../../lib/testing-schedule.js';
+import { setTestingJobSchedule } from '../../../../lib/testing-operations.js';
 import { TESTING_RECORD_BUILD_OPTIONS } from '../../../../lib/testing-types.js';
 export default class TestingJobScheduleSet extends AgentiaCommand {
     static args = {
-        id: Args.integer({ description: 'CRT job/test ID.', required: true }),
+        id: Args.integer({ description: 'CRT job ID.', required: true }),
     };
-    static description = 'Create or update a Copado Robotic Testing job/test schedule';
+    static description = 'Create or update a Copado Robotic Testing job schedule';
     static examples = [
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --cron "0 6 * * 1-5"',
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --cron "0 6 * * *" --timezone Europe/Helsinki --record failed --json',

package/dist/commands/testing/job/update.js

@@ -1,17 +1,17 @@
 import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingGitStorageFlags, testingProjectFlag, } from '../../../lib/testing-flags.js';
-import { buildTestingGitStorageUpdate, updateTestingJob } from '../../../lib/testing-operations.js';
+import { testingGitStorageFlags, testingProjectFlag } from '../../../lib/testing-flags.js';
+import { updateTestingJob } from '../../../lib/testing-operations.js';
 import { resolveTestingSecretInput } from '../../../lib/testing-secret-input.js';
 import { formatTestingRecord, TESTING_JOB_PARALLEL_MODES, TESTING_JOB_SUITE_TYPES, } from '../../../lib/testing-types.js';
 export default class TestingJobUpdate extends AgentiaCommand {
     static args = {
         id: Args.integer({
-            description: 'CRT job/test ID.',
+            description: 'CRT job ID.',
             required: true,
         }),
     };
-    static description = 'Update Copado Robotic Testing job/test metadata';
+    static description = 'Update Copado Robotic Testing job metadata';
     static examples = [
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --name "Smoke"',
         '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --git-url https://github.com/acme/crt-tests.git --git-branch main',
@@ -22,26 +22,21 @@ export default class TestingJobUpdate extends AgentiaCommand {
         ...testingProjectFlag,
         ...testingGitStorageFlags,
         'case-duration-change-detection': Flags.boolean({
-            description: 'Enable case duration change detection analytics.',
+            allowNo: true,
+            description: 'Enable or disable duration analytics.',
         }),
         description: Flags.string({
-            description: 'Job/test description.',
-        }),
-        'hide-video-params': Flags.boolean({
-            description: 'Hide video parameters.',
+            description: 'Job description.',
         }),
         name: Flags.string({
-            description: 'Job/test name.',
-        }),
-        'no-case-duration-change-detection': Flags.boolean({
-            description: 'Disable case duration change detection analytics.',
+            description: 'Job name.',
         }),
         'parallel-mode': Flags.option({
             description: 'Parallel execution mode.',
             options: [...TESTING_JOB_PARALLEL_MODES],
         })(),
         robot: Flags.integer({
-            description: 'CRT robot ID that should execute this job/test.',
+            description: 'CRT robot ID that should execute this job.',
         }),
         'screen-depth': Flags.integer({
             description: 'Screen color depth. Must be provided with --screen-width and --screen-height.',
@@ -53,7 +48,8 @@ export default class TestingJobUpdate extends AgentiaCommand {
             description: 'Screen width. Must be provided with --screen-height and --screen-depth.',
         }),
         'show-video-params': Flags.boolean({
-            description: 'Show video parameters.',
+            allowNo: true,
+            description: 'Enable or disable video streaming and recording capabilities when running the test job.',
         }),
         'suite-type': Flags.option({
             description: 'CRT suite/job type.',
@@ -65,33 +61,30 @@ export default class TestingJobUpdate extends AgentiaCommand {
     };
     async run() {
         const { args, flags } = await this.parse(TestingJobUpdate);
-        const screen = this.screenFromFlags(flags);
-        const showVideoParams = this.videoParamsFromFlags(flags);
-        const caseDurationChangeDetection = this.analyticsFromFlags(flags);
         const gitPassword = await resolveTestingSecretInput({
             value: flags['git-password'],
             valueFile: flags['git-password-file'],
             valueStdin: flags['git-password-stdin'],
         }, { label: 'CRT Git password', required: false });
         const job = await this.withSpinner('Updating testing job', () => updateTestingJob({
-            analytics: caseDurationChangeDetection === undefined ? undefined : { caseDurationChangeDetection },
+            caseDurationChangeDetection: flags['case-duration-change-detection'],
             description: flags.description,
             domainCredentialId: flags['git-domain-credential'],
+            gitBranch: flags['git-branch'],
+            gitPassword,
+            gitTag: flags['git-tag'],
+            gitUrl: flags['git-url'],
+            gitUseCallerCredentials: flags['git-use-caller-credentials'],
+            gitUsername: flags['git-username'],
             jobId: args.id,
             name: flags.name,
             parallelExecution: flags['parallel-mode'],
             projectId: flags.project,
             robotId: flags.robot,
-            screen,
-            showVideoParams,
-            storage: buildTestingGitStorageUpdate({
-                gitBranch: flags['git-branch'],
-                gitPassword,
-                gitTag: flags['git-tag'],
-                gitUrl: flags['git-url'],
-                gitUseCallerCredentials: flags['git-use-caller-credentials'],
-                gitUsername: flags['git-username'],
-            }),
+            screenDepth: flags['screen-depth'],
+            screenHeight: flags['screen-height'],
+            screenWidth: flags['screen-width'],
+            showVideoParams: flags['show-video-params'],
             suiteType: flags['suite-type'],
             timeout: flags.timeout,
         }));
@@ -101,41 +94,5 @@ export default class TestingJobUpdate extends AgentiaCommand {
         });
         return job;
     }
-    analyticsFromFlags(flags) {
-        if (flags['case-duration-change-detection'] === true && flags['no-case-duration-change-detection'] === true) {
-            this.error('Use either --case-duration-change-detection or --no-case-duration-change-detection, not both.', {
-                exit: 2,
-            });
-        }
-        if (flags['case-duration-change-detection'] === true)
-            return true;
-        if (flags['no-case-duration-change-detection'] === true)
-            return false;
-        return undefined;
-    }
-    screenFromFlags(flags) {
-        const values = [flags['screen-depth'], flags['screen-height'], flags['screen-width']];
-        const supplied = values.filter((value) => value !== undefined);
-        if (supplied.length === 0)
-            return undefined;
-        if (supplied.length !== values.length) {
-            this.error('Provide --screen-width, --screen-height, and --screen-depth together.', { exit: 2 });
-        }
-        const [depth, height, width] = values;
-        if (depth <= 0 || height <= 0 || width <= 0) {
-            this.error('Screen dimensions and depth must be positive integers.', { exit: 2 });
-        }
-        return { depth, height, width };
-    }
-    videoParamsFromFlags(flags) {
-        if (flags['show-video-params'] === true && flags['hide-video-params'] === true) {
-            this.error('Use either --show-video-params or --hide-video-params, not both.', { exit: 2 });
-        }
-        if (flags['show-video-params'] === true)
-            return true;
-        if (flags['hide-video-params'] === true)
-            return false;
-        return undefined;
-    }
 }
 //# sourceMappingURL=update.js.map

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

@@ -1,21 +1,16 @@
-import { Args } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-command.js';
-import { controlTestingLive } from '../../../lib/testing-live-operations.js';
+import { runTestingLiveControlCommand, testingLiveCommonFlags, testingLiveOptionalJobArg, } from '../../../lib/testing-live-command.js';
 export default class TestingLiveContinue extends AgentiaCommand {
-    static args = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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);
-        const result = await controlTestingLive('continue', {
-            jobId: args['job-id'],
-            projectId: flags.project,
-            sessionId: flags['session-id'],
+        return runTestingLiveControlCommand('continue', args, flags, {
+            display: (fn) => this.display(fn),
+            log: (msg) => this.log(msg),
         });
-        this.display(() => this.log(result.message));
-        return result;
     }
 }
 //# sourceMappingURL=continue.js.map

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

@@ -1,9 +1,9 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-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 = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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',

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

@@ -4,13 +4,18 @@ 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/test ID; defaults to the active session.', required: false }) };
+    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'] })(),
+        status: Flags.option({
+            description: 'Execution status filter.',
+            options: ['completed', 'failed', 'recorded'],
+        })(),
     };
     async run() {
         const { args, flags } = await this.parse(TestingLiveHistory);

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

@@ -1,9 +1,10 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-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 = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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',
@@ -23,7 +24,7 @@ export default class TestingLiveInspect extends AgentiaCommand {
             projectId: flags.project,
             sessionId: flags['session-id'],
         }));
-        this.display(() => this.log(flags.dom ? `DOM written to ${String(result.path)}.` : JSON.stringify(result, null, 2)));
+        this.display(() => this.log(flags.dom ? `DOM written to ${String(result.path)}.` : formatTestingRecord(result)));
         return result;
     }
 }

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

@@ -1,21 +1,16 @@
-import { Args } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-command.js';
-import { controlTestingLive } from '../../../lib/testing-live-operations.js';
+import { runTestingLiveControlCommand, testingLiveCommonFlags, testingLiveOptionalJobArg, } from '../../../lib/testing-live-command.js';
 export default class TestingLiveInterrupt extends AgentiaCommand {
-    static args = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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);
-        const result = await controlTestingLive('interrupt', {
-            jobId: args['job-id'],
-            projectId: flags.project,
-            sessionId: flags['session-id'],
+        return runTestingLiveControlCommand('interrupt', args, flags, {
+            display: (fn) => this.display(fn),
+            log: (msg) => this.log(msg),
         });
-        this.display(() => this.log(result.message));
-        return result;
     }
 }
 //# sourceMappingURL=interrupt.js.map

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

@@ -1,134 +1,42 @@
-/* eslint-disable no-bitwise -- Node secure append flags are a bitmask. */
-import { Args, Flags } from '@oclif/core';
-import { randomUUID } from 'node:crypto';
-import { closeSync, constants, mkdirSync, openSync, writeSync } from 'node:fs';
-import { dirname, extname, resolve } from 'node:path';
+import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { resolveTestingCredentials } from '../../../lib/testing-config.js';
-import { appendTestingLiveHistory } from '../../../lib/testing-live-history.js';
-import { loadTestingLiveConnection, setTestingLiveOptions } from '../../../lib/testing-live-operations.js';
-import { acquireTestingLiveRecorderLock, connectTestingLiveWebSocket, parseTestingLiveRecorderFrame, robotLinesFromRecorderEvent, } from '../../../lib/testing-live-recorder.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 = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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 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.' }),
-        project: Flags.integer({ char: 'p', description: 'CRT project ID.', required: true }),
-        'session-id': Flags.integer({ description: 'Guard that must match the active CRT live session.', min: 1 }),
     };
     async run() {
         const { args, flags } = await this.parse(TestingLiveRecorder);
-        const connection = await loadTestingLiveConnection({
-            jobId: args['job-id'],
-            projectId: flags.project,
-            sessionId: flags['session-id'],
-        });
-        const lock = acquireTestingLiveRecorderLock(connection.metadata.sessionId);
-        const descriptor = flags.output === undefined ? undefined : openRobotOutput(flags.output);
-        let recorded = 0;
+        const controller = new AbortController();
+        const stop = () => controller.abort();
+        process.once('SIGINT', stop);
         try {
-            if (!flags['no-enable']) {
-                await setTestingLiveOptions({
-                    jobId: connection.metadata.jobId,
-                    projectId: connection.metadata.projectId,
-                    recorder: emptyOptions(true),
-                    sessionId: connection.metadata.sessionId,
-                });
-            }
-            const socket = connectTestingLiveWebSocket(connection.metadata.sessionPath, resolveTestingCredentials().domain, connection.session);
-            await new Promise((resolvePromise, reject) => {
-                const heartbeat = setInterval(() => {
-                    if (socket.readyState === socket.OPEN)
-                        socket.send('true');
-                }, 3000);
-                const stop = () => socket.close();
-                process.once('SIGINT', stop);
-                socket.once('error', () => reject(new Error('CRT live recorder connection failed.')));
-                socket.once('open', () => this.log('Recording CRT interactions. Press Ctrl-C to stop.'));
-                socket.on('message', (frame) => {
-                    try {
-                        const event = parseTestingLiveRecorderFrame(frame);
-                        if (event === undefined)
-                            return;
-                        if (flags.debug) {
-                            const type = typeof event.type === 'string' && /^[a-z-]{1,32}$/u.test(event.type)
-                                ? event.type
-                                : 'unknown';
-                            this.warn(`Recorder event ${type} (${Buffer.byteLength(frame.toString())} bytes).`);
-                        }
-                        const lines = robotLinesFromRecorderEvent(event);
-                        if (lines.length === 0)
-                            return;
-                        for (const line of lines)
-                            this.log(line);
-                        if (descriptor !== undefined) {
-                            writeSync(descriptor, `${lines.join('\n')}\n\n`, undefined, 'utf8');
-                        }
-                        const now = new Date().toISOString();
-                        appendTestingLiveHistory({
-                            completedAt: now,
-                            id: randomUUID(),
-                            jobId: connection.metadata.jobId,
-                            lines,
-                            projectId: connection.metadata.projectId,
-                            startedAt: now,
-                            status: 'recorded',
-                        });
-                        recorded += lines.length;
-                    }
-                    catch (error) {
-                        this.warn(error.message);
-                    }
-                });
-                socket.once('close', () => resolvePromise());
-                socket.once('error', () => resolvePromise());
-                socket.once('close', cleanup);
-                socket.once('error', cleanup);
-                function cleanup() {
-                    clearInterval(heartbeat);
-                    process.removeListener('SIGINT', stop);
-                }
+            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 {
-            if (descriptor !== undefined)
-                closeSync(descriptor);
-            lock.release();
-            if (!flags['no-enable']) {
-                await setTestingLiveOptions({
-                    jobId: connection.metadata.jobId,
-                    projectId: connection.metadata.projectId,
-                    recorder: emptyOptions(false),
-                    sessionId: connection.metadata.sessionId,
-                }).catch(() => { });
-            }
+            process.removeListener('SIGINT', stop);
         }
-        return { recorded, sessionId: connection.metadata.sessionId };
     }
 }
-function emptyOptions(enabled) {
-    return {
-        enabled,
-        enableHealingContext: false,
-        enableHoverText: false,
-        enableScrollText: false,
-        enableSystemState: false,
-        enableVerifyText: false,
-        preferTableKeywords: false,
-    };
-}
-function openRobotOutput(path) {
-    if (path.includes('\0') || extname(path).toLowerCase() !== '.robot') {
-        throw new Error('CRT recorder output must be an explicit .robot path.');
-    }
-    const target = resolve(path);
-    mkdirSync(dirname(target), { mode: 0o700, recursive: true });
-    return openSync(target, constants.O_APPEND | constants.O_CREAT | constants.O_NOFOLLOW | constants.O_WRONLY, 0o600);
-}
 //# sourceMappingURL=recorder.js.map

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

@@ -1,9 +1,9 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-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 = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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>',

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

@@ -1,9 +1,9 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-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 = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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 = {

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

@@ -1,9 +1,8 @@
-import { Args } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveRecorderOptionFlags, testingLiveRecorderOptions, } from '../../../lib/testing-live-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 = { 'job-id': Args.integer({ description: 'Optional CRT job/test ID guard.', required: false }) };
+    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',
@@ -11,7 +10,15 @@ export default class TestingLiveSetOptions extends AgentiaCommand {
     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'];
+        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.');
         }