@vostride/agent-qa-dashboard 0.1.21 → 0.2.1

package/dist/index-ygQLgXzT.d.ts

@@ -1,1168 +0,0 @@
-import { Server, IncomingMessage, ServerResponse } from 'node:http';
-import { RunAttributes, RunArtifactKind, RunArtifactStageInput, RunArtifactPayload, RunArtifactFinalizeInput, LogEntry, ResolvedWorkspacePaths, ModelConfig, ResolvedAppiumExecutable, SecretStore, SecretRedactor, HookDefinition, ConsoleLogEntry, NetworkLogEntry, StepAnnotation, StepPhaseEvent, StepResult, AuthStateMetadata, buildAnalyticsEvent, captureAnalytics, resolveAnalyticsStandardProperties } from '@vostride/agent-qa-core';
-import { LocalMcpEndpointConfig, LocalMcpTransport } from '@vostride/agent-qa-mcp';
-import { Document } from 'yaml';
-import { EventEmitter } from 'node:events';
-import { ChildProcess } from 'node:child_process';
-
-interface RunRow {
-    id: string;
-    name: string;
-    filePath: string | null;
-    status: string;
-    priority: number;
-    duration: number;
-    attributes: RunAttributes;
-    environment: string | null;
-    metadata: Record<string, unknown> | null;
-    startedAt: string | null;
-    endedAt: string | null;
-    videoPath: string | null;
-    failureSummary: string | null;
-    errorLog: string | null;
-    memoryLog: string | null;
-    testId: string | null;
-    suiteId: string | null;
-    platform: string;
-    testFileContent: string | null;
-    modelName: string | null;
-    llmProvider: string | null;
-    parallel: boolean;
-    parentRunId: string | null;
-    attemptNumber: number;
-    retryCount: number;
-    maxRetries: number;
-    createdAt: string;
-}
-interface RunArtifactRow {
-    runId: string;
-    kind: RunArtifactKind;
-    schemaVersion: number;
-    payload: RunArtifactPayload;
-    finalizedAt: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface RunArtifactBundle {
-    artifact: RunArtifactRow | null;
-    children: Array<{
-        run: RunRow;
-        artifact: RunArtifactRow | null;
-    }>;
-}
-interface StepRow {
-    id: string;
-    runId: string;
-    name: string;
-    status: string;
-    duration: number;
-    action: unknown | null;
-    observation: string | null;
-    reasoning: string | null;
-    plannedAction: unknown | null;
-    result: string | null;
-    error: string | null;
-    screenshotPath: string | null;
-    screenshotBeforePath: string | null;
-    healingAttempts: unknown[] | null;
-    retryCount: number;
-    capturedVariables: Record<string, string> | null;
-    stepOrder: number;
-    annotationData: unknown | null;
-    healingScreenshotPaths: string[] | null;
-    accessibilityViolations: unknown[] | null;
-    confidence: number | null;
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    subActionsData: unknown[] | null;
-    consoleLogs: unknown[] | null;
-    networkLogs: unknown[] | null;
-    variableSnapshot: Record<string, {
-        value: string;
-        source: string;
-    }> | null;
-    originalStepName: string | null;
-    screenContextBefore: string | null;
-    screenContextAfter: string | null;
-    createdAt: string;
-}
-interface ReasoningTraceRow {
-    id: string;
-    stepId: string;
-    observeText: string | null;
-    observeDuration: number | null;
-    planReasoning: string | null;
-    planConfidence: number | null;
-    planAction: unknown | null;
-    planDuration: number | null;
-    executeAction: unknown | null;
-    executeDuration: number | null;
-    verifyReasoning: string | null;
-    verifySuccess: boolean | null;
-    verifyDuration: number | null;
-    healAttempts: unknown[] | null;
-    totalDuration: number | null;
-    screenStateBefore: string | null;
-    screenStateAfter: string | null;
-    createdAt: string;
-}
-interface ExecutionLogRow {
-    id: string;
-    runId: string;
-    stepId: string | null;
-    type: 'hook' | 'appium-script' | 'runjs';
-    name: string;
-    hookId: string | null;
-    phase: 'setup' | 'teardown' | 'inline';
-    status: 'passed' | 'failed';
-    duration: number;
-    stdout: string | null;
-    stderr: string | null;
-    returnData: unknown | null;
-    variables: Record<string, string> | null;
-    createdAt: string;
-}
-interface InsertExecutionLogInput {
-    id: string;
-    runId: string;
-    stepId?: string | null;
-    type: 'hook' | 'appium-script' | 'runjs';
-    name: string;
-    hookId?: string | null;
-    phase: 'setup' | 'teardown' | 'inline';
-    status: 'passed' | 'failed';
-    duration: number;
-    stdout?: string | null;
-    stderr?: string | null;
-    returnData?: unknown | null;
-    variables?: Record<string, string> | null;
-}
-interface RunsFilter {
-    status?: string;
-    name?: string;
-    platform?: string;
-    from?: string;
-    to?: string;
-    attributePredicates?: AttributePredicate[];
-    limit?: number;
-    offset?: number;
-}
-interface StatsOptions {
-    from?: string;
-    to?: string;
-    attributePredicates?: AttributePredicate[];
-}
-type InsightsBreakdownDimension = 'test' | 'suite' | 'platform';
-interface InsightsBreakdownRow {
-    key: string;
-    label: string;
-    runs: number;
-    passRate: number;
-    flakeRate: number;
-    avgDuration: number;
-    passed: number;
-    failed: number;
-    filePath?: string;
-    suiteId?: string;
-}
-interface DeleteRunResult {
-    deleted: boolean;
-    deletedRunIds: string[];
-    screenshotPaths: string[];
-    videoPaths: string[];
-}
-interface AttributePredicate {
-    key: string;
-    value: string;
-    mode: 'exact' | 'regex';
-}
-interface AttributeKeySuggestion {
-    key: string;
-    count: number;
-}
-interface AttributeValueSuggestion {
-    value: string;
-    count: number;
-}
-declare class DashboardDatabase {
-    private db;
-    constructor({ dbPath }?: {
-        dbPath?: string;
-    });
-    private runMigrations;
-    insertRun(run: {
-        id?: string;
-        name: string;
-        filePath?: string;
-        status: string;
-        duration: number;
-        attributes?: RunAttributes;
-        environment?: string;
-        metadata?: Record<string, unknown>;
-        startedAt: string;
-        endedAt: string;
-        videoPath?: string;
-        failureSummary?: string;
-        platform?: string;
-        testFileContent?: string;
-        modelName?: string;
-        llmProvider?: string;
-        parentRunId?: string;
-        attemptNumber?: number;
-        retryCount?: number;
-        maxRetries?: number;
-        testId?: string;
-        suiteId?: string;
-    }): string;
-    updateRun(id: string, updates: {
-        name?: string;
-        status?: string;
-        duration?: number;
-        startedAt?: string;
-        endedAt?: string;
-        failureSummary?: string;
-        errorLog?: string;
-        memoryLog?: string;
-        videoPath?: string;
-        attributes?: RunAttributes;
-        platform?: string;
-        testId?: string;
-        suiteId?: string;
-    }): void;
-    updateRunMetadata(id: string, updates: {
-        attributes?: RunAttributes;
-        metadata?: Record<string, unknown>;
-        platform?: string;
-        testFileContent?: string;
-        modelName?: string;
-        llmProvider?: string;
-    }): void;
-    insertPendingRun(run: {
-        id?: string;
-        name: string;
-        filePath?: string;
-        attributes?: RunAttributes;
-        priority?: number;
-        platform?: string;
-        testFileContent?: string;
-        modelName?: string;
-        llmProvider?: string;
-        metadata?: Record<string, unknown>;
-        parallel?: boolean;
-        maxRetries?: number;
-    }): string;
-    getNextPendingRun(): RunRow | undefined;
-    getPendingRuns(): RunRow[];
-    updateRunStatus(id: string, status: string): void;
-    insertStep(step: {
-        id?: string;
-        runId: string;
-        name: string;
-        status: string;
-        duration: number;
-        action?: unknown;
-        observation?: string;
-        reasoning?: string;
-        plannedAction?: unknown;
-        result?: string;
-        error?: string;
-        screenshotPath?: string;
-        screenshotBeforePath?: string;
-        healingAttempts?: unknown[];
-        retryCount?: number;
-        capturedVariables?: Record<string, string>;
-        stepOrder: number;
-        annotationData?: unknown;
-        healingScreenshotPaths?: string[];
-        accessibilityViolations?: unknown[];
-        confidence?: number;
-        promptTokens?: number;
-        completionTokens?: number;
-        totalTokens?: number;
-        subActionsData?: unknown[];
-        consoleLogs?: unknown[];
-        networkLogs?: unknown[];
-        variableSnapshot?: Record<string, unknown>;
-        originalStepName?: string;
-        screenContextBefore?: string;
-        screenContextAfter?: string;
-    }): string;
-    private appendAttributePredicateConditions;
-    private applyRegexAttributePredicates;
-    private queryRunsWithAttributePredicates;
-    private buildTrendsFromRuns;
-    getRuns(opts?: RunsFilter): RunRow[];
-    getRun(id: string): RunRow | undefined;
-    listRunAttributeKeys(opts?: {
-        limit?: number;
-        q?: string;
-    }): AttributeKeySuggestion[];
-    listRunAttributeValues(key: string, opts?: {
-        limit?: number;
-        q?: string;
-    }): AttributeValueSuggestion[];
-    deleteRun(id: string): DeleteRunResult;
-    getSteps(runId: string): StepRow[];
-    getCapturedVariableNames(testId: string): string[];
-    getRunsByParent(parentRunId: string): RunRow[];
-    insertRunArtifact(input: {
-        runId: string;
-        kind?: RunArtifactKind;
-        payload?: RunArtifactStageInput;
-    }): RunArtifactRow;
-    stageRunArtifact(runId: string, patch: RunArtifactStageInput): RunArtifactRow;
-    finalizeRunArtifact(runId: string, updates?: RunArtifactFinalizeInput): RunArtifactRow;
-    getRunArtifact(runId: string): RunArtifactRow | null;
-    getRunArtifactBundle(runId: string): RunArtifactBundle;
-    updateRunRetryInfo(id: string, info: {
-        retryCount: number;
-        maxRetries: number;
-    }): void;
-    private isSuccessfulRunStatus;
-    private getHealedRunIds;
-    private summarizeAnalyticsRuns;
-    private listRunsForInsights;
-    getStats(opts?: StatsOptions): {
-        totalRuns: number;
-        passed: number;
-        failed: number;
-        flaky: number;
-        flakeRate: number;
-        avgDuration: number;
-        totalTokens: number;
-        runs: {
-            date: string;
-            passed: number;
-            failed: number;
-            healed: number;
-            duration: number;
-        }[];
-        memory: {
-            runs: number;
-            added: number;
-            confirmed: number;
-            deprecated: number;
-            deleted: number;
-            curatorTokens: number;
-        };
-    };
-    getCostStats(opts?: StatsOptions): {
-        runs: {
-            runId: string;
-            name: string;
-            startedAt: string | null;
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
-        }[];
-        totals: {
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
-        };
-    };
-    insertTokenEvent(event: {
-        modelName: string;
-        promptTokens: number;
-        completionTokens: number;
-        source: 'test-run' | 'live-editor';
-    }): string;
-    getTokenEventStats(opts?: {
-        from?: string;
-        to?: string;
-    }): {
-        byModel: {
-            date: string;
-            model: string;
-            promptTokens: number;
-            completionTokens: number;
-        }[];
-        bySource: Record<string, {
-            promptTokens: number;
-            completionTokens: number;
-        }>;
-        totals: {
-            promptTokens: number;
-            completionTokens: number;
-        };
-    };
-    getRunsByTestName(name: string, opts?: {
-        limit?: number;
-        offset?: number;
-        attributePredicates?: AttributePredicate[];
-    }): RunRow[];
-    getRunsByTestNameCount(name: string, opts?: {
-        attributePredicates?: AttributePredicate[];
-    }): number;
-    getTestTrends(name: string, opts?: {
-        from?: string;
-        attributePredicates?: AttributePredicate[];
-    }): {
-        daily: {
-            date: string;
-            passed: number;
-            failed: number;
-            total: number;
-            avgDuration: number;
-        }[];
-        passRate: number;
-        totalRuns: number;
-        avgDuration: number;
-    };
-    getRunsBySuiteId(suiteId: string, opts?: {
-        limit?: number;
-        offset?: number;
-        attributePredicates?: AttributePredicate[];
-    }): RunRow[];
-    getRunsBySuiteIdCount(suiteId: string, opts?: {
-        attributePredicates?: AttributePredicate[];
-    }): number;
-    getSuiteTrends(suiteId: string, opts?: {
-        from?: string;
-        attributePredicates?: AttributePredicate[];
-    }): {
-        daily: {
-            date: string;
-            passed: number;
-            failed: number;
-            total: number;
-            avgDuration: number;
-        }[];
-        passRate: number;
-        totalRuns: number;
-        avgDuration: number;
-    };
-    getInsightsBreakdown(dimension: InsightsBreakdownDimension, opts?: StatsOptions & {
-        limit?: number;
-    }): InsightsBreakdownRow[];
-    getFlakyTests(opts?: {
-        minRuns?: number;
-        limit?: number;
-    }): {
-        name: string;
-        filePath: string | null;
-        totalRuns: number;
-        passRate: number;
-        flakyScore: number;
-    }[];
-    getAccessibilitySummary(runId: string): {
-        enabled: boolean | null;
-        total: number;
-        bySeverity: Record<string, number>;
-        byRule: {
-            count: number;
-            impact: string;
-            ruleId: string;
-        }[];
-        stepsWithViolations: number;
-        scannedSteps: number;
-        unscannedSteps: number;
-        totalSteps: number;
-    };
-    private getRunAccessibilityEnabled;
-    getStep(stepId: string): StepRow | undefined;
-    insertReasoningTrace(trace: {
-        stepId: string;
-        observeText?: string;
-        observeDuration?: number;
-        planReasoning?: string;
-        planConfidence?: number;
-        planAction?: unknown;
-        planDuration?: number;
-        executeAction?: unknown;
-        executeDuration?: number;
-        verifyReasoning?: string;
-        verifySuccess?: boolean;
-        verifyDuration?: number;
-        healAttempts?: unknown[];
-        totalDuration?: number;
-        screenStateBefore?: string;
-        screenStateAfter?: string;
-    }): string;
-    getReasoningTrace(runId: string, stepOrder: number): ReasoningTraceRow | undefined;
-    insertLogs(entries: LogEntry[]): void;
-    getLogs(opts?: {
-        runId?: string;
-        stepId?: string;
-        level?: string;
-        source?: string;
-        limit?: number;
-        offset?: number;
-    }): LogEntry[];
-    insertExecutionLog(data: InsertExecutionLogInput): void;
-    getExecutionLogs(filter: {
-        runId?: string;
-        stepId?: string;
-        type?: string;
-    }): ExecutionLogRow[];
-    close(): void;
-    private parseRunAttributes;
-    private mapRunRow;
-    private mapRunArtifactRow;
-    private mapStepRow;
-    private mapLogRow;
-    private mapReasoningTraceRow;
-}
-
-interface StartServerOptions {
-    db: DashboardDatabase;
-    port?: number;
-    uiDir?: string;
-    artifactsDir?: string;
-    workspacePaths?: ResolvedWorkspacePaths;
-    configPath?: string;
-    mcp?: LocalMcpEndpointConfig;
-    llmConfig?: Pick<ModelConfig, 'provider' | 'model' | 'apiKey' | 'authToken' | 'baseURL' | 'providerHeaders'> & {
-        screenshotSize?: number;
-        effectiveResolution?: number;
-    };
-    authFetch?: typeof globalThis.fetch;
-}
-interface McpStartupInfo {
-    enabled: boolean;
-    transport: LocalMcpTransport;
-    host?: string;
-    port?: number;
-    path?: string;
-    url?: string;
-}
-declare function startServer(opts: StartServerOptions): Promise<{
-    server: Server;
-    port: number;
-    mcp: McpStartupInfo;
-    close: () => void;
-}>;
-
-interface AppiumLeaseOwner {
-    runId: string;
-    platform: 'android' | 'ios';
-}
-interface AppiumLease extends AppiumLeaseOwner {
-    acquiredAt: string;
-}
-declare class AppiumManager {
-    private process;
-    private port;
-    private ready;
-    private startPromise;
-    private managed;
-    private startupTimeoutMs;
-    private pollIntervalMs;
-    private anonymousRefCount;
-    private leases;
-    private logLevel;
-    private appiumResolver;
-    constructor(opts?: {
-        port?: number;
-        startupTimeoutMs?: number;
-        pollIntervalMs?: number;
-        logLevel?: 'normal' | 'debug';
-        appiumResolver?: () => ResolvedAppiumExecutable;
-    });
-    acquire(): Promise<void>;
-    release(): void;
-    acquireLease(owner: AppiumLeaseOwner): Promise<void>;
-    releaseLease(runId: string, reason?: string): boolean;
-    releaseAllLeases(reason?: string): string[];
-    ensureRunning(): Promise<void>;
-    checkStatus(): Promise<boolean>;
-    private startAndWait;
-    private performShutdown;
-    private maybeShutdownAfterRelease;
-    shutdown(): void;
-    getUrl(): string;
-    getPort(): number;
-    isManaged(): boolean;
-    getRefCount(): number;
-    getLeaseCount(): number;
-    getLeases(): AppiumLease[];
-    hasLease(runId: string): boolean;
-}
-
-declare class ConfigManager {
-    private configPath;
-    constructor(configPath: string);
-    read(): Promise<Record<string, unknown>>;
-    readMasked(): Promise<Record<string, unknown>>;
-    private sectionPath;
-    updateSection(section: string, value: Record<string, unknown>): Promise<void>;
-    replaceSection(section: string, value: Record<string, unknown>): Promise<void>;
-    replaceSectionRaw(section: string, value: unknown): Promise<void>;
-    deleteSectionRaw(section: string): Promise<void>;
-    readDocument(): Promise<Document>;
-}
-
-type LiveSessionLLMConfig = Pick<ModelConfig, 'provider' | 'model' | 'apiKey' | 'authToken' | 'baseURL' | 'providerHeaders'> & {
-    screenshotSize?: number;
-    effectiveResolution?: number;
-};
-interface LiveDraftMetadata {
-    testName: string;
-    testContext?: string;
-}
-interface EntityRef {
-    type: 'suite' | 'test';
-    id: string;
-}
-interface LiveExecutionLog {
-    id: string;
-    type: 'hook' | 'appium-script' | 'runjs';
-    name: string;
-    hookId?: string | null;
-    phase: 'setup' | 'teardown' | 'inline';
-    status: 'passed' | 'failed';
-    duration: number;
-    stdout: string | null;
-    stderr: string | null;
-    returnData: unknown | null;
-    variables: Record<string, string> | null;
-    createdAt: string;
-}
-interface LiveSubActionData {
-    index: number;
-    observation: string;
-    reasoning: string;
-    plannedAction: unknown;
-    result: 'success' | 'failure' | 'in-progress';
-    error?: string;
-    screenStateBefore: string;
-    screenStateAfter?: string;
-    confidence?: number;
-    verifierReasoning?: string;
-    cached: boolean;
-    tokenUsage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-    phaseDurations?: {
-        observe?: number;
-        plan?: number;
-        execute?: number;
-        verify?: number;
-    };
-    annotation?: StepAnnotation;
-    screenContextBefore?: string;
-    screenContextAfter?: string;
-    data?: unknown;
-}
-interface LiveStepResultPayload {
-    status: 'passed' | 'failed' | 'cancelled';
-    duration?: number;
-    error?: string;
-    capturedVariables?: Record<string, string>;
-    variableSnapshot?: Record<string, {
-        value: string;
-        source: string;
-    }>;
-    originalStepName?: string;
-    consoleLogs?: ConsoleLogEntry[];
-    networkLogs?: NetworkLogEntry[];
-    executionLogs?: LiveExecutionLog[];
-    subActionsData?: LiveSubActionData[];
-}
-interface LiveSuiteHookOwner {
-    scope: 'suite';
-}
-interface LiveTestOwner {
-    scope: 'test';
-    testExecutionId: string;
-    testIndex: number;
-    testId: string;
-    testName: string;
-}
-type LiveHookOwner = LiveSuiteHookOwner | LiveTestOwner;
-interface LiveHookPayload {
-    executionId: string;
-    hookId: string;
-    hookName: string;
-    phase: 'setup' | 'teardown';
-    owner: LiveHookOwner;
-    status: 'running' | 'passed' | 'failed';
-    duration?: number;
-    stdout?: string | null;
-    stderr?: string | null;
-    variables?: Record<string, string> | null;
-    error?: string;
-    createdAt: string;
-}
-interface LiveTestExecutionPayload {
-    testExecutionId: string;
-    testIndex: number;
-    testId: string;
-    testName: string;
-}
-interface LiveTestStepPayload extends LiveTestExecutionPayload {
-    stepIndex: number;
-    stepInstruction: string;
-}
-interface LiveTestResultPayload {
-    status: 'passed' | 'failed' | 'cancelled';
-    duration: number;
-    error?: string;
-    setupHookExecutions: LiveHookPayload[];
-    stepResults: LiveStepResultPayload[];
-    teardownHookExecutions: LiveHookPayload[];
-}
-type ServerMessage = {
-    type: 'session-ready';
-    sessionId: string;
-    platform: string;
-    interactive: boolean;
-    error?: string | null;
-} | {
-    type: 'hook-start';
-    hook: LiveHookPayload;
-} | {
-    type: 'hook-complete';
-    hook: LiveHookPayload;
-} | {
-    type: 'step-phase';
-    phase: string;
-    data?: unknown;
-} | {
-    type: 'step-complete';
-    result: LiveStepResultPayload;
-} | {
-    type: 'step-cancelled';
-} | {
-    type: 'step-error';
-    error: string;
-} | {
-    type: 'test-start';
-    test: LiveTestExecutionPayload;
-} | {
-    type: 'test-step-start';
-    step: LiveTestStepPayload;
-} | {
-    type: 'test-step-phase';
-    step: LiveTestStepPayload;
-    phase: string;
-    data?: unknown;
-} | {
-    type: 'test-step-complete';
-    step: LiveTestStepPayload;
-    result: LiveStepResultPayload;
-} | {
-    type: 'test-step-cancelled';
-    step: LiveTestStepPayload;
-} | {
-    type: 'test-step-error';
-    step: LiveTestStepPayload;
-    error: string;
-} | {
-    type: 'test-complete';
-    test: LiveTestExecutionPayload;
-    result: LiveTestResultPayload;
-} | {
-    type: 'test-error';
-    test: LiveTestExecutionPayload;
-    error: string;
-} | {
-    type: 'screenshot';
-    data: string;
-} | {
-    type: 'session-state';
-    state: SessionState;
-} | {
-    type: 'session-terminated';
-} | {
-    type: 'browser-disconnected';
-} | {
-    type: 'error';
-    message: string;
-} | {
-    type: 'step-busy';
-    currentStep: string;
-} | {
-    type: 'navigate-complete';
-    url: string | null;
-} | {
-    type: 'device-logs';
-    entries: Array<{
-        level: string;
-        message: string;
-        timestamp: number;
-    }>;
-} | {
-    type: 'aria-tree';
-    tree: string;
-};
-interface SessionState {
-    sessionId: string;
-    platform: 'web' | 'android' | 'ios';
-    targetName?: string | null;
-    status: 'idle' | 'executing' | 'disconnected';
-    currentStep: string | null;
-    currentUrl: string | null;
-    stepsExecuted: number;
-    createdAt: number;
-    interactive: boolean;
-    terminalError: string | null;
-}
-interface LiveSessionConfig {
-    platform: 'web' | 'android' | 'ios';
-    targetName?: string;
-    llmConfig: LiveSessionLLMConfig;
-    authFetch?: typeof globalThis.fetch;
-    agentRules?: string;
-    envVars?: Record<string, string>;
-    secretStore?: SecretStore;
-    secretRedactor?: SecretRedactor;
-    setupHooks?: string[];
-    teardownHooks?: string[];
-    resolvedHooks?: Map<string, HookDefinition>;
-    hookRegistryError?: string;
-    url?: string;
-    headless?: boolean;
-    useDeviceName?: string;
-    appState?: 'preserve' | 'reset';
-    bundleId?: string;
-    appPackage?: string;
-    appActivity?: string;
-    device?: {
-        name: string;
-        platformVersion?: string;
-        appPath?: string;
-        browserName?: string;
-        appPackage?: string;
-        appActivity?: string;
-        bundleId?: string;
-        udid?: string;
-        avd?: string;
-        appiumUrl?: string;
-    };
-}
-
-interface LiveSessionDeps {
-    appiumManager?: AppiumManager;
-    configManager?: ConfigManager;
-    configPath?: string;
-}
-interface LiveStepExecutionResult extends StepResult {
-    executionLogs?: LiveExecutionLog[];
-    subActionsData?: LiveSubActionData[];
-}
-declare class LiveSession {
-    private deps;
-    readonly sessionId: string;
-    status: 'idle' | 'executing' | 'disconnected' | 'terminated';
-    private abortController;
-    stepsExecuted: number;
-    createdAt: number;
-    private adapter;
-    private planner;
-    private verifier;
-    private model;
-    private variableStore;
-    private previousSteps;
-    private currentStep;
-    private platform;
-    private targetName;
-    private currentUrl;
-    private executing;
-    private idleTimer;
-    private _modelName;
-    private screenshotSize;
-    private effectiveResolution;
-    private readyForInteraction;
-    private terminalError;
-    private setupHooks;
-    private teardownHooks;
-    private resolvedHooks;
-    private hookRegistryError;
-    private pendingMessages;
-    private messageSink;
-    private mobileAppiumLease;
-    private secretStore;
-    private secretRedactor;
-    constructor(sessionId: string, deps?: LiveSessionDeps);
-    get modelName(): string;
-    attachMessageSink(sink: ((message: ServerMessage) => void) | null): void;
-    private dispatch;
-    private redact;
-    private resolveSecrets;
-    private emitHookStart;
-    private emitHookComplete;
-    private emitTestStepStart;
-    private emitTestStepPhase;
-    private emitTestStepComplete;
-    private emitTestStepError;
-    private getHookEnvVars;
-    private runLifecycleHooks;
-    executeHookCommand(phase: 'setup' | 'teardown', hookId: string): Promise<LiveExecutionLog>;
-    private releaseMobileAppiumLease;
-    private legacyMobilePlatformConfig;
-    private resolveMobilePlatformConfig;
-    private setupMobileAdapter;
-    initialize(config: LiveSessionConfig): Promise<void>;
-    private resolveStepInstruction;
-    private buildPreparationFailureResult;
-    private executeStepInternal;
-    executeStepCommand(stepInstruction: string, stepIndex?: number, onPhase?: (event: StepPhaseEvent) => void, draft?: LiveDraftMetadata): Promise<LiveStepExecutionResult>;
-    executeTestCommand(testExecutionId: string, testDraft: {
-        testIndex: number;
-        testId: string;
-        testName: string;
-        testContext?: string;
-        steps: string[];
-        setup: string[];
-        teardown: string[];
-    }, onPhase?: (event: StepPhaseEvent) => void): Promise<LiveTestResultPayload>;
-    private runLifecycleHooksCapturing;
-    captureWebAuthState(name: string, options?: {
-        replace?: boolean;
-    }): Promise<AuthStateMetadata>;
-    cancelStep(): void;
-    navigate(url: string): Promise<string | null>;
-    refreshPage(): Promise<string | null>;
-    goBack(): Promise<string | null>;
-    goForward(): Promise<string | null>;
-    drainDeviceLogs(): Promise<Array<{
-        level: string;
-        message: string;
-        timestamp: number;
-    }>>;
-    getState(): SessionState;
-    getScreenshot(): Promise<Buffer | undefined>;
-    getAriaTree(): Promise<string | null>;
-    startIdleTimer(onExpire: () => void): void;
-    clearIdleTimer(): void;
-    cleanup(): Promise<void>;
-}
-
-interface SessionManagerDeps {
-    appiumManager?: AppiumManager;
-    configManager?: ConfigManager;
-    configPath?: string;
-}
-declare class SessionManager {
-    private deps;
-    private sessions;
-    private counters;
-    constructor(deps?: SessionManagerDeps);
-    createSession(config: LiveSessionConfig, entity?: EntityRef): Promise<{
-        sessionId: string;
-        sessionNumber: number | null;
-    }>;
-    getSession(sessionId: string): LiveSession | undefined;
-    listSessions(): SessionState[];
-    terminateSession(sessionId: string): Promise<boolean>;
-    cleanupAll(): Promise<void>;
-    getCounter(entity: EntityRef): number;
-    get size(): number;
-}
-
-interface ExecuteOptions {
-    runId: string;
-    args: string[];
-    source: string;
-    attributes?: RunAttributes;
-    timeout?: number;
-    maxRetries?: number;
-    env?: Record<string, string>;
-}
-interface ExecutionBackend extends EventEmitter {
-    execute(opts: ExecuteOptions): void;
-    kill(runId: string): boolean;
-    killAll(): void;
-    getActiveExecutions(): {
-        runId: string;
-        status: string;
-        startedAt: string;
-        duration: number;
-    }[];
-}
-
-interface LiveExecutionEvent {
-    id: number;
-    type: string;
-    [key: string]: unknown;
-}
-interface TestRunHandle {
-    runId: string;
-    process: ChildProcess;
-    status: 'running' | 'completed' | 'failed' | 'cancelled' | 'timeout';
-    output: string[];
-    startedAt: Date;
-    lastEventAt: number;
-    completionReason?: string;
-}
-declare class TestRunner extends EventEmitter implements ExecutionBackend {
-    private cliBin;
-    private defaultTimeout;
-    private handles;
-    private eventBuffers;
-    private eventCounters;
-    private onProcessClose?;
-    private heartbeatTimer;
-    private heartbeatIntervalMs;
-    private staleThresholdMs;
-    constructor(opts: {
-        cliBin: string;
-        defaultTimeout?: number;
-        onProcessClose?: (runId: string, status: 'completed' | 'failed' | 'cancelled' | 'timeout') => void;
-        heartbeatIntervalMs?: number;
-        staleThresholdMs?: number;
-    });
-    static resolveCliBin(): string;
-    execute(opts: ExecuteOptions): void;
-    getBufferedEvents(runId: string): LiveExecutionEvent[];
-    getHandle(runId: string): TestRunHandle | undefined;
-    getActiveExecutions(): {
-        runId: string;
-        status: string;
-        startedAt: string;
-        duration: number;
-        testName?: string;
-    }[];
-    kill(runId: string): boolean;
-    killAll(): void;
-    private startHeartbeatChecker;
-    private pushEvent;
-    private signalHandle;
-}
-
-interface EnqueueOptions {
-    name: string;
-    filePath?: string;
-    kind?: RunArtifactKind;
-    attributes?: RunAttributes;
-    priority?: number;
-    platform?: string;
-    testFileContent?: string;
-    modelName?: string;
-    llmProvider?: string;
-    metadata?: Record<string, unknown>;
-    parallel?: boolean;
-}
-declare class JobQueue extends EventEmitter {
-    private db;
-    private pollInterval;
-    private isProcessing;
-    private concurrency;
-    private activeCount;
-    private activePlatforms;
-    private activeRuns;
-    constructor(opts: {
-        db: DashboardDatabase;
-        concurrency?: number;
-    });
-    start(intervalMs?: number): void;
-    stop(): void;
-    enqueue(opts: EnqueueOptions): string;
-    processNext(): void;
-    onSlotFreed(runId: string): void;
-    getActiveCount(): number;
-    getConcurrency(): number;
-    cancel(runId: string): boolean;
-    private cancelChildRuns;
-    private findNextEligible;
-}
-
-interface TestFileInfo {
-    path: string;
-    name: string;
-    testId: string | null;
-    targetName: string | null;
-    platform: string | null;
-    modified: string;
-}
-interface TestValidationError {
-    message: string;
-    line?: number;
-    column?: number;
-    suggestion?: string;
-}
-interface TestValidationResult {
-    valid: boolean;
-    errors: TestValidationError[];
-}
-declare class TestFileManager {
-    private readonly workspace;
-    constructor(workspace: ResolvedWorkspacePaths);
-    list(): Promise<TestFileInfo[]>;
-    read(relativePath: string): Promise<string>;
-    findByTestId(testId: string): Promise<{
-        path: string;
-        content: string;
-    } | null>;
-    write(relativePath: string, content: string): Promise<void>;
-    delete(relativePath: string): Promise<void>;
-    validate(content: string): Promise<TestValidationResult>;
-    private resolveTarget;
-}
-
-interface SuiteFileInfo {
-    path: string;
-    suiteId: string | null;
-    name: string;
-    testCount: number;
-    modified: string;
-    platform: string | null;
-}
-interface SuiteValidationResult {
-    valid: boolean;
-    errors: {
-        message: string;
-        line?: number;
-        column?: number;
-        suggestion?: string;
-    }[];
-    missingTests?: Array<{
-        index: number;
-        test: string;
-        id: string;
-    }>;
-}
-declare class SuiteFileManager {
-    private readonly workspace;
-    private testFileManager;
-    constructor(workspace: ResolvedWorkspacePaths, testFileManager?: TestFileManager);
-    list(): Promise<SuiteFileInfo[]>;
-    findBySuiteId(suiteId: string): Promise<{
-        path: string;
-        content: string;
-    } | null>;
-    resolvePath(filePath: string, requireExisting?: boolean): Promise<{
-        storagePath: string;
-        executionPath: string;
-    }>;
-    read(relativePath: string): Promise<string>;
-    write(relativePath: string, content: string): Promise<void>;
-    delete(relativePath: string): Promise<void>;
-    validate(content: string): Promise<SuiteValidationResult>;
-    private resolveTarget;
-}
-
-type DashboardRuntimeLLMConfig = Pick<ModelConfig, 'provider' | 'model' | 'apiKey' | 'authToken' | 'baseURL' | 'providerHeaders'> & {
-    screenshotSize?: number;
-    effectiveResolution?: number;
-    modelAdapter?: 'openai-responses' | 'anthropic-messages';
-};
-interface RouterDeps {
-    db: DashboardDatabase;
-    artifactsDir?: string;
-    workspacePaths?: ResolvedWorkspacePaths;
-    testRunner?: TestRunner;
-    jobQueue?: JobQueue;
-    testFileManager?: TestFileManager;
-    suiteFileManager?: SuiteFileManager;
-    configManager?: ConfigManager;
-    configPath?: string;
-    llmConfig?: DashboardRuntimeLLMConfig;
-    authFetch?: typeof globalThis.fetch;
-    sessionManager?: SessionManager;
-    analyticsBridge?: {
-        buildAnalyticsEvent: typeof buildAnalyticsEvent;
-        captureAnalytics: typeof captureAnalytics;
-        resolveAnalyticsStandardProperties: typeof resolveAnalyticsStandardProperties;
-    };
-}
-declare function createRouter(deps: RouterDeps): (req: IncomingMessage, res: ServerResponse) => void;
-declare function createRouter(db: DashboardDatabase, artifactsDir?: string): (req: IncomingMessage, res: ServerResponse) => void;
-
-declare function readJsonBody<T>(req: IncomingMessage, maxBytes?: number): Promise<T>;
-
-export { AppiumManager as A, ConfigManager as C, DashboardDatabase as D, type LiveExecutionEvent as L, type RunRow as R, type StepRow as S, type TestFileInfo as T, TestFileManager as a, type TestRunHandle as b, TestRunner as c, type TestValidationError as d, type TestValidationResult as e, createRouter as f, readJsonBody as r, startServer as s };