@avi770/testteam 1.2.0

package/dist/core/report-upload.js

@@ -0,0 +1,124 @@
+import { readFile, copyFile, mkdir, stat } from 'node:fs/promises';
+import { basename, join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+/**
+ * Dynamically load an optional npm package at runtime.
+ * Uses createRequire to avoid TypeScript static module resolution errors.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function optionalRequire(packageName) {
+    const require = createRequire(import.meta.url);
+    return require(packageName);
+}
+function generateReportFilename(originalPath) {
+    const base = basename(originalPath, '.html');
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    return `${base}-${ts}.html`;
+}
+async function uploadLocal(htmlPath, config) {
+    const prefix = config.prefix ?? 'testteam-reports/';
+    const reportsDir = resolve(prefix);
+    await mkdir(reportsDir, { recursive: true });
+    const filename = generateReportFilename(htmlPath);
+    const destPath = join(reportsDir, filename);
+    await copyFile(htmlPath, destPath);
+    const fileStat = await stat(destPath);
+    const absoluteDest = resolve(destPath);
+    return {
+        url: `file://${absoluteDest.replace(/\\/g, '/')}`,
+        provider: 'local',
+        size: fileStat.size,
+        timestamp: Date.now(),
+    };
+}
+async function uploadS3(htmlPath, config) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let sdk;
+    try {
+        sdk = await optionalRequire('@aws-sdk/client-s3');
+    }
+    catch {
+        throw new Error('Install @aws-sdk/client-s3 to use S3 uploads: npm install @aws-sdk/client-s3');
+    }
+    if (!config.bucket) {
+        throw new Error('S3 upload requires a bucket name in config.bucket');
+    }
+    const prefix = config.prefix ?? 'testteam-reports/';
+    const filename = generateReportFilename(htmlPath);
+    const key = `${prefix}${filename}`;
+    const body = await readFile(htmlPath);
+    const client = new sdk.S3Client({
+        region: config.region ?? 'us-east-1',
+    });
+    await client.send(new sdk.PutObjectCommand({
+        Bucket: config.bucket,
+        Key: key,
+        Body: body,
+        ContentType: 'text/html',
+    }));
+    const region = config.region ?? 'us-east-1';
+    const url = `https://${config.bucket}.s3.${region}.amazonaws.com/${key}`;
+    return {
+        url,
+        provider: 's3',
+        size: body.byteLength,
+        timestamp: Date.now(),
+    };
+}
+async function uploadAzureBlob(htmlPath, config) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let sdk;
+    try {
+        sdk = await optionalRequire('@azure/storage-blob');
+    }
+    catch {
+        throw new Error('Install @azure/storage-blob to use Azure Blob uploads: npm install @azure/storage-blob');
+    }
+    if (!config.connectionString) {
+        throw new Error('Azure Blob upload requires a connectionString in config.connectionString');
+    }
+    if (!config.bucket) {
+        throw new Error('Azure Blob upload requires a container name in config.bucket');
+    }
+    const prefix = config.prefix ?? 'testteam-reports/';
+    const filename = generateReportFilename(htmlPath);
+    const blobName = `${prefix}${filename}`;
+    const body = await readFile(htmlPath);
+    const blobServiceClient = sdk.BlobServiceClient.fromConnectionString(config.connectionString);
+    const containerClient = blobServiceClient.getContainerClient(config.bucket);
+    await containerClient.createIfNotExists({ access: 'blob' });
+    const blockBlobClient = containerClient.getBlockBlobClient(blobName);
+    await blockBlobClient.upload(body, body.byteLength, {
+        blobHTTPHeaders: { blobContentType: 'text/html' },
+    });
+    return {
+        url: blockBlobClient.url,
+        provider: 'azure-blob',
+        size: body.byteLength,
+        timestamp: Date.now(),
+    };
+}
+export async function uploadReport(htmlPath, config) {
+    const absolutePath = resolve(htmlPath);
+    // Verify file exists before attempting upload
+    await stat(absolutePath);
+    switch (config.provider) {
+        case 'local':
+            return uploadLocal(absolutePath, config);
+        case 's3':
+            return uploadS3(absolutePath, config);
+        case 'azure-blob':
+            return uploadAzureBlob(absolutePath, config);
+        default: {
+            const exhaustive = config.provider;
+            throw new Error(`Unknown upload provider: ${String(exhaustive)}`);
+        }
+    }
+}
+export function getDefaultUploadConfig() {
+    return {
+        provider: 'local',
+        prefix: 'testteam-reports/',
+    };
+}
+//# sourceMappingURL=report-upload.js.map

package/dist/core/report-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-upload.js","sourceRoot":"","sources":["../../core/report-upload.ts"],"names":[],"mappings":"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"}

package/dist/core/run-counter.d.ts

@@ -0,0 +1,40 @@
+export interface RunRecord {
+    timestamp: number;
+    phase: string;
+    configName: string;
+}
+export interface RunCounterState {
+    periodStart: number;
+    periodEnd: number;
+    runs: RunRecord[];
+    totalRuns: number;
+}
+export interface RunLimitCheck {
+    allowed: boolean;
+    used: number;
+    remaining: number;
+    warning: boolean;
+}
+/** Return Unix timestamp (ms) for midnight UTC on the 1st of the given date's month. */
+declare function periodStartFor(date: Date): number;
+/** Return Unix timestamp (ms) for 23:59:59.999 UTC on the last day of the given date's month. */
+declare function periodEndFor(date: Date): number;
+/** Returns the absolute path to the run-counter file inside `configDir`. */
+export declare function getRunCounterPath(configDir: string): string;
+/**
+ * Load the run counter state from disk.
+ * If the file does not exist or the current billing period has expired,
+ * a fresh state for the current month is returned (and persisted).
+ */
+export declare function loadRunCounter(configDir: string): RunCounterState;
+/** Record a pipeline run in the current billing period. */
+export declare function recordRun(configDir: string, phase: string, configName: string): void;
+/**
+ * Check whether a new run is allowed under the given monthly limit.
+ * `warning` is `true` when usage has reached 80 % or more of the limit.
+ */
+export declare function checkRunLimit(configDir: string, maxRuns: number): RunLimitCheck;
+/** Manually reset the run counter (admin / support use). */
+export declare function resetRunCounter(configDir: string): void;
+export { periodStartFor as _periodStartFor, periodEndFor as _periodEndFor };
+//# sourceMappingURL=run-counter.d.ts.map

package/dist/core/run-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-counter.d.ts","sourceRoot":"","sources":["../../core/run-counter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wFAAwF;AACxF,iBAAS,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE1C;AAED,iGAAiG;AACjG,iBAAS,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASxC;AAmCD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAgCjE;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,IAAI,CAaN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,aAAa,CAQf;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGvD;AAUD,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,YAAY,IAAI,aAAa,EAAE,CAAC"}

package/dist/core/run-counter.js

@@ -0,0 +1,120 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const RUN_COUNTER_FILENAME = '.testteam-runs.json';
+// ── Period helpers ───────────────────────────────────────────────────
+/** Return Unix timestamp (ms) for midnight UTC on the 1st of the given date's month. */
+function periodStartFor(date) {
+    return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1);
+}
+/** Return Unix timestamp (ms) for 23:59:59.999 UTC on the last day of the given date's month. */
+function periodEndFor(date) {
+    // Month + 1, day 0 gives last day of current month
+    const lastDay = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 1, 0));
+    return Date.UTC(lastDay.getUTCFullYear(), lastDay.getUTCMonth(), lastDay.getUTCDate(), 23, 59, 59, 999);
+}
+function createFreshState(now) {
+    return {
+        periodStart: periodStartFor(now),
+        periodEnd: periodEndFor(now),
+        runs: [],
+        totalRuns: 0,
+    };
+}
+// ── Type guard ──────────────────────────────────────────────────────
+function isRunCounterState(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    if (typeof obj['periodStart'] !== 'number')
+        return false;
+    if (typeof obj['periodEnd'] !== 'number')
+        return false;
+    if (typeof obj['totalRuns'] !== 'number')
+        return false;
+    if (!Array.isArray(obj['runs']))
+        return false;
+    return obj['runs'].every((r) => {
+        if (typeof r !== 'object' || r === null)
+            return false;
+        const rec = r;
+        return (typeof rec['timestamp'] === 'number' &&
+            typeof rec['phase'] === 'string' &&
+            typeof rec['configName'] === 'string');
+    });
+}
+// ── Public API ──────────────────────────────────────────────────────
+/** Returns the absolute path to the run-counter file inside `configDir`. */
+export function getRunCounterPath(configDir) {
+    return path.join(configDir, RUN_COUNTER_FILENAME);
+}
+/**
+ * Load the run counter state from disk.
+ * If the file does not exist or the current billing period has expired,
+ * a fresh state for the current month is returned (and persisted).
+ */
+export function loadRunCounter(configDir) {
+    const filePath = getRunCounterPath(configDir);
+    const now = new Date();
+    try {
+        if (!fs.existsSync(filePath)) {
+            const fresh = createFreshState(now);
+            saveRunCounter(configDir, fresh);
+            return fresh;
+        }
+        const raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        if (!isRunCounterState(raw)) {
+            const fresh = createFreshState(now);
+            saveRunCounter(configDir, fresh);
+            return fresh;
+        }
+        // Auto-reset if past the billing period
+        if (now.getTime() > raw.periodEnd) {
+            const fresh = createFreshState(now);
+            saveRunCounter(configDir, fresh);
+            return fresh;
+        }
+        return raw;
+    }
+    catch {
+        const fresh = createFreshState(now);
+        saveRunCounter(configDir, fresh);
+        return fresh;
+    }
+}
+/** Record a pipeline run in the current billing period. */
+export function recordRun(configDir, phase, configName) {
+    const state = loadRunCounter(configDir);
+    const record = {
+        timestamp: Date.now(),
+        phase,
+        configName,
+    };
+    state.runs.push(record);
+    state.totalRuns = state.runs.length;
+    saveRunCounter(configDir, state);
+}
+/**
+ * Check whether a new run is allowed under the given monthly limit.
+ * `warning` is `true` when usage has reached 80 % or more of the limit.
+ */
+export function checkRunLimit(configDir, maxRuns) {
+    const state = loadRunCounter(configDir);
+    const used = state.totalRuns;
+    const remaining = Math.max(0, maxRuns - used);
+    const allowed = used < maxRuns;
+    const warning = used >= maxRuns * 0.8;
+    return { allowed, used, remaining, warning };
+}
+/** Manually reset the run counter (admin / support use). */
+export function resetRunCounter(configDir) {
+    const fresh = createFreshState(new Date());
+    saveRunCounter(configDir, fresh);
+}
+// ── Internal helpers ────────────────────────────────────────────────
+function saveRunCounter(configDir, state) {
+    const filePath = getRunCounterPath(configDir);
+    fs.writeFileSync(filePath, JSON.stringify(state, null, 2), 'utf8');
+}
+// Exported for testing only
+export { periodStartFor as _periodStartFor, periodEndFor as _periodEndFor };
+//# sourceMappingURL=run-counter.js.map

package/dist/core/run-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-counter.js","sourceRoot":"","sources":["../../core/run-counter.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -0,0 +1,53 @@
+export type Phase = 'alpha' | 'beta' | 'uat' | 'release';
+export type AgentStatus = 'pending' | 'running' | 'passed' | 'failed' | 'skipped';
+export type FindingType = 'test-bug' | 'code-bug-cosmetic' | 'code-bug-logic' | 'code-bug-security' | 'infra-issue';
+export type FindingSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+export interface AgentResult {
+    agentId: number;
+    agentName: string;
+    phase: Phase;
+    status: AgentStatus;
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    findings: Finding[];
+    evidence: EvidenceItem[];
+    summary: string;
+}
+export interface Finding {
+    id: string;
+    type: FindingType;
+    severity: FindingSeverity;
+    agentId: number;
+    module: string;
+    description: string;
+    file?: string;
+    line?: number;
+    screenshot?: string;
+    consoleError?: string;
+    stackTrace?: string;
+    suggestedFix?: string;
+}
+export interface EvidenceItem {
+    type: 'screenshot' | 'log' | 'report' | 'video' | 'snapshot';
+    path: string;
+    description: string;
+}
+export interface PhaseGateResult {
+    phase: Phase;
+    passed: boolean;
+    blockingResults: AgentResult[];
+    advisoryResults: AgentResult[];
+    failedBlockingAgents: number[];
+    timestamp: string;
+}
+export interface RunState {
+    runId: string;
+    startedAt: string;
+    currentPhase: Phase;
+    phaseAttempt: number;
+    agentResults: Map<number, AgentResult>;
+    gateResults: PhaseGateResult[];
+    totalCost: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,aAAa,CAAC;AACpH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../core/types.ts"],"names":[],"mappings":""}

package/dist/helpers/api-client.d.ts

@@ -0,0 +1,30 @@
+export interface ApiResponse {
+    status: number;
+    body: unknown;
+    headers: Record<string, string>;
+    durationMs: number;
+}
+/**
+ * Lightweight HTTP client for integration and API tests.
+ * Automatically attaches Authorization headers when a token is present
+ * and records response duration for every request.
+ */
+export declare class ApiClient {
+    private readonly baseUrl;
+    private token?;
+    constructor(baseUrl: string, token?: string | undefined);
+    /**
+     * Creates an authenticated ApiClient by POSTing credentials to /api/auth/login
+     * and storing the returned JWT for subsequent requests.
+     */
+    static createAuthenticated(baseUrl: string, credentials: {
+        email: string;
+        password: string;
+    }): Promise<ApiClient>;
+    get(path: string): Promise<ApiResponse>;
+    post(path: string, body?: unknown): Promise<ApiResponse>;
+    put(path: string, body?: unknown): Promise<ApiResponse>;
+    delete(path: string): Promise<ApiResponse>;
+    private request;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/helpers/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../helpers/api-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD;;;;GAIG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,KAAK,CAAC;gBADG,OAAO,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE,MAAM,YAAA;IAGxB;;;OAGG;WACU,mBAAmB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,SAAS,CAAC;IAgBf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAIlC,OAAO;CA+CtB"}

package/dist/helpers/api-client.js

@@ -0,0 +1,77 @@
+/**
+ * Lightweight HTTP client for integration and API tests.
+ * Automatically attaches Authorization headers when a token is present
+ * and records response duration for every request.
+ */
+export class ApiClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+    }
+    /**
+     * Creates an authenticated ApiClient by POSTing credentials to /api/auth/login
+     * and storing the returned JWT for subsequent requests.
+     */
+    static async createAuthenticated(baseUrl, credentials) {
+        const client = new ApiClient(baseUrl);
+        const response = await client.post('/api/auth/login', credentials);
+        const body = response.body;
+        const jwt = body?.access_token ?? body?.accessToken ?? body?.token;
+        if (!jwt) {
+            throw new Error(`Authentication failed: no token in response (status ${response.status})`);
+        }
+        return new ApiClient(baseUrl, String(jwt));
+    }
+    async get(path) {
+        return this.request('GET', path);
+    }
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    async put(path, body) {
+        return this.request('PUT', path, body);
+    }
+    async delete(path) {
+        return this.request('DELETE', path);
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        const init = {
+            method,
+            headers,
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const start = Date.now();
+        const response = await fetch(url, init);
+        const durationMs = Date.now() - start;
+        const responseHeaders = {};
+        response.headers.forEach((value, key) => {
+            responseHeaders[key] = value;
+        });
+        let responseBody;
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            responseBody = await response.json();
+        }
+        else {
+            responseBody = await response.text();
+        }
+        return {
+            status: response.status,
+            body: responseBody,
+            headers: responseHeaders,
+            durationMs,
+        };
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/helpers/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../helpers/api-client.ts"],"names":[],"mappings":"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"}

package/dist/helpers/element-discovery.d.ts

@@ -0,0 +1,18 @@
+import type { Page } from 'playwright';
+export interface DiscoveredElement {
+    selector: string;
+    type: 'button' | 'link' | 'input' | 'select' | 'textarea' | 'tab' | 'menuitem' | 'other';
+    text: string;
+    isDestructive: boolean;
+    ariaLabel?: string;
+}
+/**
+ * Returns true when the given text (lowercased) contains any destructive keyword.
+ */
+export declare function classifyAsDestructive(text: string): boolean;
+/**
+ * Discovers all interactive elements on the given Playwright page and returns
+ * a deduplicated, classified list with unique selectors.
+ */
+export declare function discoverInteractiveElements(page: Page): Promise<DiscoveredElement[]>;
+//# sourceMappingURL=element-discovery.d.ts.map

package/dist/helpers/element-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-discovery.d.ts","sourceRoot":"","sources":["../../helpers/element-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAyCD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwC1F"}

package/dist/helpers/element-discovery.js

@@ -0,0 +1,82 @@
+// Keywords that indicate a destructive action
+const DESTRUCTIVE_KEYWORDS = ['delete', 'remove', 'archive', 'destroy', 'clear', 'reset'];
+/**
+ * Returns true when the given text (lowercased) contains any destructive keyword.
+ */
+export function classifyAsDestructive(text) {
+    const lower = text.toLowerCase();
+    return DESTRUCTIVE_KEYWORDS.some((keyword) => lower.includes(keyword));
+}
+// CSS selectors targeting all interactive element categories
+const INTERACTIVE_SELECTORS = [
+    'button',
+    'a[href]',
+    'input',
+    'select',
+    'textarea',
+    '[role="button"]',
+    '[role="tab"]',
+    '[role="menuitem"]',
+    '[data-testid]',
+    '[aria-haspopup]',
+].join(', ');
+function resolveType(tag, role) {
+    if (role === 'tab')
+        return 'tab';
+    if (role === 'menuitem')
+        return 'menuitem';
+    if (role === 'button' || tag === 'button')
+        return 'button';
+    if (tag === 'a')
+        return 'link';
+    if (tag === 'input')
+        return 'input';
+    if (tag === 'select')
+        return 'select';
+    if (tag === 'textarea')
+        return 'textarea';
+    return 'other';
+}
+function buildSelector(testId, ariaLabel, tag, text) {
+    if (testId)
+        return `[data-testid="${testId}"]`;
+    if (ariaLabel)
+        return `[aria-label="${ariaLabel}"]`;
+    const safeSuffix = text.trim().slice(0, 40).replace(/"/g, '\\"');
+    return safeSuffix ? `${tag}:text("${safeSuffix}")` : tag;
+}
+/**
+ * Discovers all interactive elements on the given Playwright page and returns
+ * a deduplicated, classified list with unique selectors.
+ */
+export async function discoverInteractiveElements(page) {
+    const rawElements = await page.evaluate((selector) => {
+        const nodes = Array.from(document.querySelectorAll(selector));
+        return nodes.map((el) => ({
+            tag: el.tagName.toLowerCase(),
+            role: el.getAttribute('role') ?? '',
+            text: (el.textContent ?? '').trim(),
+            ariaLabel: el.getAttribute('aria-label'),
+            testId: el.getAttribute('data-testid'),
+        }));
+    }, INTERACTIVE_SELECTORS);
+    const seenSelectors = new Set();
+    const discovered = [];
+    for (const raw of rawElements) {
+        const selector = buildSelector(raw.testId, raw.ariaLabel, raw.tag, raw.text);
+        if (seenSelectors.has(selector))
+            continue;
+        seenSelectors.add(selector);
+        const labelText = raw.ariaLabel ?? raw.text;
+        const discovered_element = {
+            selector,
+            type: resolveType(raw.tag, raw.role),
+            text: raw.text,
+            isDestructive: classifyAsDestructive(labelText),
+            ...(raw.ariaLabel !== null ? { ariaLabel: raw.ariaLabel } : {}),
+        };
+        discovered.push(discovered_element);
+    }
+    return discovered;
+}
+//# sourceMappingURL=element-discovery.js.map

package/dist/helpers/element-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-discovery.js","sourceRoot":"","sources":["../../helpers/element-discovery.ts"],"names":[],"mappings":"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"}

package/dist/helpers/env-resolver.d.ts

@@ -0,0 +1,29 @@
+import type { ValidatedConfig } from '../core/config';
+import type { Phase } from '../core/types';
+interface EnvironmentConfig {
+    baseUrl: string;
+    seed?: boolean;
+}
+interface ResolvedEnvironment {
+    env: EnvironmentConfig;
+    /** True when the phase's configured URL was unreachable and we fell back to alpha. */
+    fallback: boolean;
+}
+/**
+ * Check whether a URL responds with a non-5xx status within a timeout.
+ * Exported so agents can use it directly without duplicating the function.
+ */
+export declare function isUrlReachable(url: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Resolve the environment for a given phase with automatic fallback.
+ *
+ * 1. Try the phase's configured environment (`config.environments[phase]`).
+ * 2. If the URL is reachable → return `{ env, fallback: false }`.
+ * 3. If unreachable → try `config.environments['alpha']` (localhost).
+ * 4. If alpha is reachable → return `{ env: alphaEnv, fallback: true }`.
+ * 5. If neither is reachable → return the phase's env with `fallback: false`
+ *    so the agent can decide how to handle the failure.
+ */
+export declare function resolveEnvironment(config: ValidatedConfig, phase: Phase): Promise<ResolvedEnvironment>;
+export {};
+//# sourceMappingURL=env-resolver.d.ts.map

package/dist/helpers/env-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-resolver.d.ts","sourceRoot":"","sources":["../../helpers/env-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,mBAAmB;IAC3B,GAAG,EAAE,iBAAiB,CAAC;IACvB,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpF;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,mBAAmB,CAAC,CAyB9B"}