// Qa Lab plugin module implements shared Mantis option parsing helpers.

export function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

export function isTruthyOptIn(value: string | undefined) {

const normalized = value?.trim().toLowerCase();

return normalized === "1" || normalized === "true" || normalized === "yes";

}

import { spawn, type SpawnOptions } from "node:child_process";

import path from "node:path";

import { pathExists } from "openclaw/plugin-sdk/security-runtime";

import { trimToValue } from "../mantis-options.runtime.js";

export type CommandResult = {

stderr: string;

state?: string;

};

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

export async function defaultCommandRunner(

command: string,

args: readonly string[],

import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";

import { pathExists } from "openclaw/plugin-sdk/security-runtime";

import { ensureRepoBoundDirectory, resolveRepoRelativeOutputDir } from "../cli-paths.js";

import { isTruthyOptIn, trimToValue } from "../mantis-options.runtime.js";

import {

type CommandRunner,

type CrabboxInspect,

const BROWSER_PROFILE_DIR_ENV = "OPENCLAW_MANTIS_BROWSER_PROFILE_DIR";

const DEFAULT_VIDEO_DURATION_SECONDS = 10;

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

function isTruthyOptIn(value: string | undefined) {

const normalized = value?.trim().toLowerCase();

return normalized === "1" || normalized === "true" || normalized === "yes";

}

function defaultOutputDir(repoRoot: string, startedAt: Date) {

const stamp = startedAt.toISOString().replace(/[:.]/gu, "-");

return path.join(repoRoot, ".artifacts", "qa-e2e", "mantis", `desktop-browser-${stamp}`);

import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";

import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";

import { ensureRepoBoundDirectory, resolveRepoRelativeOutputDir } from "../cli-paths.js";

import { isTruthyOptIn, trimToValue } from "../mantis-options.runtime.js";

export type MantisDiscordSmokeOptions = {

channelId?: string;

const DEFAULT_CHANNEL_ID_ENV = "OPENCLAW_QA_DISCORD_CHANNEL_ID";

const QA_REDACT_PUBLIC_METADATA_ENV = "OPENCLAW_QA_REDACT_PUBLIC_METADATA";

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

function isTruthyOptIn(value: string | undefined) {

const normalized = value?.trim().toLowerCase();

return normalized === "1" || normalized === "true" || normalized === "yes";

}

function assertDiscordSnowflake(value: string, label: string) {

if (!/^\d{17,20}$/u.test(value)) {

throw new Error(`${label} must be a Discord snowflake.`);

import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";

import { ensureRepoBoundDirectory, resolveRepoRelativeOutputDir } from "../cli-paths.js";

import { QA_EVIDENCE_FILENAME, validateQaEvidenceSummaryJson } from "../evidence-summary.js";

import { trimToValue } from "../mantis-options.runtime.js";

export type MantisBeforeAfterOptions = {

allowFailures?: boolean;

},

};

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

function normalizeRequiredLiteral<T extends string>(

value: string | undefined,

defaultValue: T,

acquireQaCredentialLease,

startQaCredentialLeaseHeartbeat,

} from "../live-transports/shared/credential-lease.runtime.js";

import { isTruthyOptIn, trimToValue } from "../mantis-options.runtime.js";

import { createPhaseTimer, type MantisPhaseTimings } from "../mantis-phase-timer.runtime.js";

import {

type CommandRunner,

type CrabboxInspect,

stopCrabbox,

warmupCrabbox,

} from "./crabbox-runtime.js";

import { createPhaseTimer, type MantisPhaseTimings } from "../mantis-phase-timer.runtime.js";

export type MantisSlackDesktopSmokeOptions = {

alternateModel?: string;

const SLACK_URL_ENV = "OPENCLAW_MANTIS_SLACK_URL";

const SLACK_CHANNEL_ID_ENV = "OPENCLAW_MANTIS_SLACK_CHANNEL_ID";

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

function isTruthyOptIn(value: string | undefined) {

const normalized = value?.trim().toLowerCase();

return normalized === "1" || normalized === "true" || normalized === "yes";

}

function normalizeHydrateMode(

value: string | undefined,

): MantisSlackDesktopHydrateMode | undefined {

acquireQaCredentialLease,

startQaCredentialLeaseHeartbeat,

} from "../live-transports/shared/credential-lease.runtime.js";

import { isTruthyOptIn, trimToValue } from "../mantis-options.runtime.js";

import { createPhaseTimer, type MantisPhaseTimings } from "../mantis-phase-timer.runtime.js";

import {

type CommandRunner,

type CrabboxInspect,

stopCrabbox,

warmupCrabbox,

} from "./crabbox-runtime.js";

import { createPhaseTimer, type MantisPhaseTimings } from "../mantis-phase-timer.runtime.js";

export type MantisTelegramDesktopBuilderOptions = {

commandRunner?: CommandRunner;

"OPENCLAW_MANTIS_TELEGRAM_DESKTOP_PROFILE_ARCHIVE_ENV";

const TELEGRAM_PROFILE_DIR_ENV = "OPENCLAW_MANTIS_TELEGRAM_DESKTOP_PROFILE_DIR";

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

function isTruthyOptIn(value: string | undefined) {

const normalized = value?.trim().toLowerCase();

return normalized === "1" || normalized === "true" || normalized === "yes";

}

function normalizeHydrateMode(

value: string | undefined,

): MantisTelegramDesktopHydrateMode | undefined {

import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";

import { pathExists, writeExternalFileWithinRoot } from "openclaw/plugin-sdk/security-runtime";

import { ensureRepoBoundDirectory, resolveRepoRelativeOutputDir } from "../cli-paths.js";

import { isTruthyOptIn, trimToValue } from "../mantis-options.runtime.js";

import {

type CommandRunner,

type CrabboxInspect,

const CRABBOX_IDLE_TIMEOUT_ENV = "OPENCLAW_MANTIS_CRABBOX_IDLE_TIMEOUT";

const CRABBOX_TTL_ENV = "OPENCLAW_MANTIS_CRABBOX_TTL";

function trimToValue(value: string | undefined) {

const trimmed = value?.trim();

return trimmed && trimmed.length > 0 ? trimmed : undefined;

}

function isTruthyOptIn(value: string | undefined) {

const normalized = value?.trim().toLowerCase();

return normalized === "1" || normalized === "true" || normalized === "yes";

}

function defaultOutputDir(repoRoot: string, startedAt: Date) {

const stamp = startedAt.toISOString().replace(/[:.]/gu, "-");

return path.join(repoRoot, ".artifacts", "qa-e2e", "mantis", `visual-task-${stamp}`);