testdriverai 7.2.64 → 7.2.69

package/mcp-server/dist/session.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Session state management for TestDriver MCP Server
+ * Tracks sandbox sessions for MCP server
+ */
+export interface SessionState {
+    sessionId: string;
+    sandboxId: string | null;
+    status: "initializing" | "active" | "expired" | "error";
+    os: "linux" | "windows";
+    resolution: string;
+    createdAt: number;
+    expiresAt: number;
+    keepAlive: number;
+    testFile: string | null;
+    lastScreenshot: string | null;
+    errorMessage?: string;
+}
+/**
+ * Session Manager - handles session state for MCP server
+ */
+export declare class SessionManager {
+    private sessions;
+    private currentSessionId;
+    /**
+     * Create a new session
+     */
+    createSession(options: {
+        sandboxId?: string;
+        os?: "linux" | "windows";
+        resolution?: string;
+        keepAlive?: number;
+        testFile?: string;
+    }): SessionState;
+    /**
+     * Get the current active session
+     */
+    getCurrentSession(): SessionState | null;
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): SessionState | null;
+    /**
+     * Update session state
+     */
+    updateSession(sessionId: string, updates: Partial<SessionState>): SessionState | null;
+    /**
+     * Mark session as active with sandbox ID
+     */
+    activateSession(sessionId: string, sandboxId: string): SessionState | null;
+    /**
+     * Extend session expiry time by adding additional milliseconds
+     */
+    extendSession(sessionId: string, additionalMs: number): SessionState | null;
+    /**
+     * Refresh session expiry to reset the keepAlive timer from now
+     * Called on each command to keep session alive during active use
+     */
+    refreshSession(sessionId: string): SessionState | null;
+    /**
+     * Check if session is still valid
+     */
+    isSessionValid(sessionId: string): boolean;
+    /**
+     * Get time remaining until session expires
+     */
+    getTimeRemaining(sessionId: string): number;
+    /**
+     * Mark session as expired/ended
+     */
+    endSession(sessionId: string): void;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): boolean;
+    /**
+     * Get session summary for status reporting
+     */
+    getSessionSummary(sessionId: string): {
+        sessionId: string;
+        status: string;
+        sandboxId: string | null;
+        timeRemaining: number;
+    } | null;
+}
+export declare const sessionManager: SessionManager;

package/mcp-server/dist/session.js

@@ -0,0 +1,152 @@
+/**
+ * Session state management for TestDriver MCP Server
+ * Tracks sandbox sessions for MCP server
+ */
+// Generate unique session ID
+function generateSessionId() {
+    return `td-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Session Manager - handles session state for MCP server
+ */
+export class SessionManager {
+    sessions = new Map();
+    currentSessionId = null;
+    /**
+     * Create a new session
+     */
+    createSession(options) {
+        const sessionId = generateSessionId();
+        const keepAlive = options.keepAlive ?? 300000; // Default 5 minutes
+        const session = {
+            sessionId,
+            sandboxId: options.sandboxId ?? null,
+            status: "initializing",
+            os: options.os ?? "linux",
+            resolution: options.resolution ?? "1366x768",
+            createdAt: Date.now(),
+            expiresAt: Date.now() + keepAlive,
+            keepAlive,
+            testFile: options.testFile ?? null,
+            lastScreenshot: null,
+        };
+        this.sessions.set(sessionId, session);
+        this.currentSessionId = sessionId;
+        return session;
+    }
+    /**
+     * Get the current active session
+     */
+    getCurrentSession() {
+        if (!this.currentSessionId)
+            return null;
+        return this.sessions.get(this.currentSessionId) ?? null;
+    }
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId) ?? null;
+    }
+    /**
+     * Update session state
+     */
+    updateSession(sessionId, updates) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        const updated = { ...session, ...updates };
+        this.sessions.set(sessionId, updated);
+        return updated;
+    }
+    /**
+     * Mark session as active with sandbox ID
+     */
+    activateSession(sessionId, sandboxId) {
+        return this.updateSession(sessionId, {
+            sandboxId,
+            status: "active",
+        });
+    }
+    /**
+     * Extend session expiry time by adding additional milliseconds
+     */
+    extendSession(sessionId, additionalMs) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        return this.updateSession(sessionId, {
+            expiresAt: session.expiresAt + additionalMs,
+        });
+    }
+    /**
+     * Refresh session expiry to reset the keepAlive timer from now
+     * Called on each command to keep session alive during active use
+     */
+    refreshSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        return this.updateSession(sessionId, {
+            expiresAt: Date.now() + session.keepAlive,
+        });
+    }
+    /**
+     * Check if session is still valid
+     */
+    isSessionValid(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return false;
+        if (session.status === "expired" || session.status === "error")
+            return false;
+        if (Date.now() > session.expiresAt) {
+            this.updateSession(sessionId, { status: "expired" });
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get time remaining until session expires
+     */
+    getTimeRemaining(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return 0;
+        return Math.max(0, session.expiresAt - Date.now());
+    }
+    /**
+     * Mark session as expired/ended
+     */
+    endSession(sessionId) {
+        this.updateSession(sessionId, { status: "expired" });
+        if (this.currentSessionId === sessionId) {
+            this.currentSessionId = null;
+        }
+    }
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId) {
+        if (this.currentSessionId === sessionId) {
+            this.currentSessionId = null;
+        }
+        return this.sessions.delete(sessionId);
+    }
+    /**
+     * Get session summary for status reporting
+     */
+    getSessionSummary(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        return {
+            sessionId: session.sessionId,
+            status: session.status,
+            sandboxId: session.sandboxId,
+            timeRemaining: this.getTimeRemaining(sessionId),
+        };
+    }
+}
+// Singleton instance
+export const sessionManager = new SessionManager();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.2.64",
+  "version": "7.2.69",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "types": "sdk.d.ts",
@@ -30,16 +30,18 @@
     "./presets": "./lib/presets/index.mjs"
   },
   "bin": {
-    "testdriverai": "bin/testdriverai.js"
+    "testdriverai": "bin/testdriverai.js",
+    "testdriverai-mcp": "mcp-server/dist/server.js"
   },
   "scripts": {
     "start": "node bin/testdriverai.js",
     "dev": "DEV=true node bin/testdriverai.js",
     "debug": "DEV=true VERBOSE=true node bin/testdriverai.js",
-    "docs": "cd docs && npx mint@latest dev",
+    "docs": "npm run docs:skills && cd docs && npx mint@latest dev",
     "docs:dev": "cd docs && npx mint dev",
-    "docs:build": "cd docs && npx mint@latest build",
+    "docs:build": "npm run docs:skills && cd docs && npx mint@latest build",
     "docs:links": "node docs/_scripts/link-replacer.js",
+    "docs:skills": "node docs/_scripts/generate-skills.js",
     "bundle": "node build.mjs",
     "test": "mocha test/*",
     "test:sdk": "vitest run",
@@ -58,11 +60,15 @@
     "test-assert": "node index.js run --path=testdriver/acceptance/assert.yaml",
     "generate-report": "junit-viewer --results=out.xml --save=report.html",
     "serve-report": "npx http-server . -p 8080 -o report.html",
-    "report": "npm run generate-report && npm run serve-report"
+    "report": "npm run generate-report && npm run serve-report",
+    "generate:skills": "node scripts/generate-skills.js",
+    "prepack": "cd mcp-server && npm ci && npm run build"
   },
   "author": "",
   "license": "ISC",
   "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.24.0",
     "@npmcli/redact": "^3.2.2",
     "@oclif/core": "^4.5.0",
     "@oclif/plugin-commands": "^4.1.28",
@@ -96,7 +102,8 @@
     "tmp": "^0.2.3",
     "winston": "^3.13.0",
     "winston-transport": "^4.9.0",
-    "ws": "^8.18.1"
+    "ws": "^8.18.1",
+    "zod": "^3.24.0"
   },
   "overrides": {
     "glob": "^11.0.1",
@@ -124,7 +131,8 @@
     "mocha": "^10.8.2",
     "node-addon-api": "^8.0.0",
     "prettier": "3.3.3",
-    "vitest": "^4.0.16"
+    "testdriverai": "^7.2.60",
+    "vitest": "^4.0.18"
   },
   "optionalDependencies": {
     "@esbuild/linux-x64": "^0.21.5"
@@ -137,6 +145,19 @@
       "@oclif/plugin-*"
     ],
     "topicSeparator": " ",
-    "default": "edit"
-  }
+    "default": "init"
+  },
+  "files": [
+    "agent/",
+    "bin/",
+    "ai/skills/",
+    "ai/agents/",
+    "interfaces/",
+    "lib/",
+    "mcp-server/dist/",
+    "sdk.js",
+    "sdk.d.ts",
+    "index.js",
+    "schema.json"
+  ]
 }

package/sdk.d.ts

@@ -14,6 +14,13 @@ export type ScrollDirection = "up" | "down" | "left" | "right";
 export type ScrollMethod = "keyboard" | "mouse";
 export type TextMatchMethod = "ai" | "turbo";
 export type ExecLanguage = "js" | "pwsh" | "sh";
+/**
+ * Preview mode for live test visualization
+ * - "browser": Opens debugger in default browser (default)
+ * - "ide": Opens preview in IDE panel (VSCode, Cursor, etc.)
+ * - "none": Headless mode, no visual preview
+ */
+export type PreviewMode = "browser" | "ide" | "none";
 export type KeyboardKey =
   | "\t"
   | "\n"
@@ -232,7 +239,17 @@ export interface TestDriverOptions {
   };
   /** Force creation of a new sandbox (default: true) */
   newSandbox?: boolean;
-  /** Run in headless mode (default: false) */
+  /**
+   * Preview mode for live test visualization (default: "browser")
+   * - "browser": Opens debugger in default browser
+   * - "ide": Opens preview in IDE panel (VSCode, Cursor, etc.)
+   * - "none": Headless mode, no visual preview
+   */
+  preview?: PreviewMode;
+  /**
+   * @deprecated Use `preview: "none"` instead. Run in headless mode (default: false)
+   * For backward compatibility: headless: true maps to preview: "none"
+   */
   headless?: boolean;
   /** Direct IP address to connect to a running sandbox instance */
   ip?: string;
@@ -280,7 +297,17 @@ export interface ConnectOptions {
   sandboxInstance?: string;
   /** Operating system for the sandbox (default: 'linux') */
   os?: "windows" | "linux";
-  /** Run in headless mode (default: false) */
+  /**
+   * Preview mode for live test visualization (default: "browser")
+   * - "browser": Opens debugger in default browser
+   * - "ide": Opens preview in IDE panel (VSCode, Cursor, etc.)
+   * - "none": Headless mode, no visual preview
+   */
+  preview?: PreviewMode;
+  /**
+   * @deprecated Use `preview: "none"` instead. Run in headless mode (default: false)
+   * For backward compatibility: headless: true maps to preview: "none"
+   */
   headless?: boolean;
   /** Reuse recent connection if available (default: true) */
   reuseConnection?: boolean;

package/sdk.js

@@ -3,6 +3,7 @@ const path = require("path");
 const os = require("os");
 const crypto = require("crypto");
 const { formatter } = require("./sdk-log-formatter");
+const logger = require("./agent/lib/logger");
 
 /**
  * Get the file path of the caller (the file that called TestDriver)

package/.env.example

@@ -1,4 +0,0 @@
-TD_API_KEY=
-TD_API_ROOT=
-
-TWOCAPTCHA_API_KEY=

package/.github/workflows/acceptance-linux-scheduled.yaml

@@ -1,45 +0,0 @@
-name: Scheduled Acceptance Tests (Linux)
-
-permissions:
-  id-token: write
-  contents: read
-
-on:
-  schedule:
-    # Every 6 hours
-    - cron: "0 */6 * * *"
-  workflow_dispatch: # Allow manual trigger
-
-jobs:
-  test-linux:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Install Sentry CLI
-        run: npm install -g @sentry/cli
-
-      - name: Run Linux tests with Sentry Cron monitoring
-        run: |
-          sentry-cli monitors run testdriver-linux-acceptance -- npx vitest run examples/*.test.mjs
-        env:
-          SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
-          TD_API_KEY: ${{ secrets.TD_API_KEY }}
-          TD_OS: linux
-          TWOCAPTCHA_API_KEY: ${{ secrets.TWOCAPTCHA_API_KEY }}
-
-      - name: Upload test results to Sentry Prevent
-        if: ${{ !cancelled() }}
-        uses: getsentry/prevent-action@v0
-        with:
-          token: ${{ secrets.SENTRY_PREVENT_TOKEN }}

package/.github/workflows/acceptance-windows-scheduled.yaml

@@ -1,54 +0,0 @@
-name: Scheduled Acceptance Tests (Windows)
-
-permissions:
-  id-token: write
-  contents: read
-
-on:
-  schedule:
-    # Every day at midnight UTC
-    - cron: "0 0 * * *"
-  workflow_dispatch: # Allow manual trigger
-
-jobs:
-  test-windows:
-    uses: ./.github/workflows/windows-self-hosted.yaml
-    secrets:
-      TD_API_KEY: ${{ secrets.TD_API_KEY }}
-      TWOCAPTCHA_API_KEY: ${{ secrets.TWOCAPTCHA_API_KEY }}
-      TD_WEBSITE: ${{ secrets.TD_WEBSITE }}
-      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-
-  sentry-and-publish:
-    needs: test-windows
-    runs-on: ubuntu-latest
-    if: always()
-
-    steps:
-      - name: Install Sentry CLI
-        run: npm install -g @sentry/cli
-
-      - name: Report to Sentry Cron
-        run: |
-          sentry-cli monitors run testdriver-windows-acceptance -- echo "Windows tests completed"
-        env:
-          SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
-
-      - name: Download test results
-        uses: actions/download-artifact@v4
-        with:
-          name: test-results-windows
-
-      - name: Upload test results to Sentry Prevent
-        if: ${{ !cancelled() }}
-        uses: getsentry/prevent-action@v0
-        with:
-          token: ${{ secrets.SENTRY_PREVENT_TOKEN }}
-
-      - name: Publish Test Results
-        uses: EnricoMi/publish-unit-test-result-action@v2
-        if: always()
-        with:
-          files: test-report.junit.xml
-          check_name: Test Results (Windows Scheduled)

package/.github/workflows/acceptance.yaml

@@ -1,87 +0,0 @@
-name: Acceptance Tests
-permissions:
-  id-token: write
-  contents: write
-  pull-requests: write
-  checks: write
-on:
-  pull_request:
-    branches: [main]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  test-linux:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run Linux tests
-        run: npx vitest run examples/*.test.mjs
-        env:
-          TD_API_KEY: ${{ secrets.TD_API_KEY }}
-          TWOCAPTCHA_API_KEY: ${{ secrets.TWOCAPTCHA_API_KEY }}
-          TD_OS: linux
-
-      - name: Upload test results to Sentry Prevent
-        if: ${{ !cancelled() }}
-        uses: getsentry/prevent-action@v0
-        with:
-          token: ${{ secrets.SENTRY_PREVENT_TOKEN }}
-
-      - name: Publish Test Results
-        uses: EnricoMi/publish-unit-test-result-action@v2
-        if: always()
-        with:
-          files: test-report.junit.xml
-          comment_mode: always
-          check_name: Test Results (Linux)
-
-  test-windows:
-    if: contains(github.event.pull_request.labels.*.name, 'test-windows')
-    uses: ./.github/workflows/windows-self-hosted.yaml
-    with:
-      test_pattern: "examples/*.test.mjs"
-    secrets:
-      TD_API_KEY: ${{ secrets.TD_API_KEY }}
-      TWOCAPTCHA_API_KEY: ${{ secrets.TWOCAPTCHA_API_KEY }}
-      TD_WEBSITE: ${{ secrets.TD_WEBSITE }}
-      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-
-  publish-windows-results:
-    needs: test-windows
-    runs-on: ubuntu-latest
-    if: always() && contains(github.event.pull_request.labels.*.name, 'test-windows')
-
-    steps:
-      - name: Download test results
-        uses: actions/download-artifact@v4
-        with:
-          name: test-results-windows
-
-      - name: Upload test results to Sentry Prevent
-        if: ${{ !cancelled() }}
-        uses: getsentry/prevent-action@v0
-        with:
-          token: ${{ secrets.SENTRY_PREVENT_TOKEN }}
-
-      - name: Publish Test Results
-        uses: EnricoMi/publish-unit-test-result-action@v2
-        if: always()
-        with:
-          files: test-report.junit.xml
-          comment_mode: always
-          check_name: Test Results (Windows)

package/.github/workflows/publish.yaml

@@ -1,68 +0,0 @@
-name: Publish
-permissions:
-  contents: write
-  id-token: write # Required for OIDC
-on:
-  push:
-    branches: [main]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          registry-url: "https://registry.npmjs.org/"
-
-      - name: Configure Git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Bump version (patch)
-        run: npm version patch --no-git-tag-version
-
-      - name: Generate Changelog
-        run: |
-          npx conventional-changelog-cli -p angular -i CHANGELOG.md -s
-          git add CHANGELOG.md
-
-      - name: Commit and push version bump
-        run: |
-          git add package.json package-lock.json
-          VERSION=$(node -p "require('./package.json').version")
-          git commit -m "chore(release): ${VERSION}"
-          git tag "v${VERSION}"
-          git push origin main
-          git push origin "v${VERSION}"
-          echo "VERSION=${VERSION}" >> $GITHUB_ENV
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: v${{ env.VERSION }}
-          generate_release_notes: true
-          prerelease: false
-
-      - name: Debug NPM Token
-        run: |
-          echo "NPM_TOKEN is set: ${{ secrets.NPM_TOKEN != '' }}"
-          echo "NPM_TOKEN first 4 chars: ${NPM_TOKEN:0:4}..."
-        env:
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Publish to npm
-        run: npm publish --tag beta
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}