@weaaare/mcp-virtual-screen-reader-auditor 0.0.1

package/README.md

@@ -0,0 +1,81 @@
+# @weaaare/mcp-virtual-screen-reader-auditor
+
+MCP (Model Context Protocol) server for **headless virtual screen reader accessibility audits**. Works on any OS — no native screen reader required. Launches a real browser, injects a virtual screen reader, and navigates the live accessibility tree including dynamic/SPA content.
+
+Covers **WCAG 2.2** criteria using the same audit, findings, and reporting framework as `@weaaare/mcp-voiceover-auditor`.
+
+## Tools
+
+| Tool | Description |
+| --- | --- |
+| `virtual_start` | Start the Virtual Screen Reader on a URL or raw HTML (launches headless browser) |
+| `virtual_stop` | Stop the Virtual Screen Reader and release resources |
+| `virtual_next` | Move cursor to the next item in the accessibility tree |
+| `virtual_previous` | Move cursor to the previous item in the accessibility tree |
+| `virtual_act` | Perform default action for the current item (e.g., activate a link/button) |
+| `virtual_interact` | Interact with the current container item |
+| `virtual_stop_interacting` | Stop interacting with the current container item |
+| `virtual_press` | Press a key on the focused item (e.g. `Enter`, `Tab`, `ArrowDown`) |
+| `virtual_type` | Type text into the currently focused item |
+| `virtual_perform` | Semantic navigation by element type: headings, links, landmarks, forms, figures |
+| `virtual_item_text` | Get text of the item under the Virtual Screen Reader cursor |
+| `virtual_last_spoken_phrase` | Get the last phrase spoken by the Virtual Screen Reader |
+| `virtual_spoken_phrase_log` | Get full spoken phrase history for this session |
+| `virtual_item_text_log` | Get full visited item text history for this session |
+| `virtual_clear_spoken_phrase_log` | Clear the spoken phrase log |
+| `virtual_clear_item_text_log` | Clear the visited item text log |
+| `virtual_click` | Click the mouse at the current position |
+| `start_audit` | Start a structured audit session with metadata |
+| `log_finding` | Log violations/warnings/passes with WCAG criteria and recommendations |
+| `get_audit_status` | Get current audit progress and finding counters |
+| `get_findings` | Retrieve findings from current or latest session |
+| `end_audit` | End audit session and return summary data |
+| `generate_report` | Generate reports in Markdown, JSON, or CSV |
+
+## Installation
+
+```bash
+npm install -g @weaaare/mcp-virtual-screen-reader-auditor
+```
+
+Or use directly with `npx`:
+
+```bash
+npx @weaaare/mcp-virtual-screen-reader-auditor
+```
+
+## Configuration
+
+### VS Code (GitHub Copilot)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "virtual-screen-reader-auditor": {
+      "command": "npx",
+      "args": ["-y", "@weaaare/mcp-virtual-screen-reader-auditor"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "virtual-screen-reader-auditor": {
+      "command": "npx",
+      "args": ["-y", "@weaaare/mcp-virtual-screen-reader-auditor"]
+    }
+  }
+}
+```
+
+## License
+
+MIT - [weAAAre](https://weAAAre.com)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const main = async () => {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('virtual-screen-reader-auditor MCP server running on stdio');
+};
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts/virtual-prompts.d.ts

@@ -0,0 +1,6 @@
+import type { PromptDefinition } from '@weaaare/mcp-auditor-core';
+import { getPromptMessages, listPrompts } from '@weaaare/mcp-auditor-core';
+export declare const VIRTUAL_PROMPTS: ReadonlyMap<string, PromptDefinition>;
+export declare const listVirtualPrompts: () => ReturnType<typeof listPrompts>;
+export declare const getVirtualPromptMessages: (name: string, args: Record<string, string | undefined>) => ReturnType<typeof getPromptMessages>;
+//# sourceMappingURL=virtual-prompts.d.ts.map

package/dist/prompts/virtual-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-prompts.d.ts","sourceRoot":"","sources":["../../src/prompts/virtual-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAyR3E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAMhE,CAAC;AAEH,eAAO,MAAM,kBAAkB,QAAO,UAAU,CAAC,OAAO,WAAW,CACrC,CAAC;AAE/B,eAAO,MAAM,wBAAwB,GACnC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KACvC,UAAU,CAAC,OAAO,iBAAiB,CAAmD,CAAC"}

package/dist/prompts/virtual-prompts.js

@@ -0,0 +1,272 @@
+import { getPromptMessages, listPrompts } from '@weaaare/mcp-auditor-core';
+// ─── Virtual Screen Reader Prompts ───────────────────────────────────────────
+// These use the virtual screen reader (headless browser + injected SR).
+// Workflow: virtual_start → navigate → log_finding → virtual_stop → report
+const virtualAccessibilityAudit = {
+    prompt: {
+        name: 'virtual_accessibility_audit',
+        description: 'Run an accessibility audit using the Virtual Screen Reader. Choose the page and the type of test. Works on any OS — no real screen reader required.',
+        arguments: [
+            {
+                name: 'url',
+                description: 'URL of the page to audit',
+                required: true,
+            },
+            {
+                name: 'testType',
+                description: 'Type of test to run: full | headings | forms | navigation | links | images',
+                required: true,
+            },
+            {
+                name: 'wcagLevel',
+                description: 'WCAG conformance level: A, AA, or AAA (default: AA)',
+                required: false,
+            },
+        ],
+    },
+    getMessage: (args) => {
+        const url = args.url ?? 'UNKNOWN_URL';
+        const testType = args.testType ?? 'full';
+        const wcagLevel = args.wcagLevel ?? 'AA';
+        const testBlocks = {
+            full: `## Phase 2 — Audit Workflow
+
+### 2.1 Page Title & Language
+- \`virtual_item_text\` — check what the screen reader announces on page load
+- Verify the page title is descriptive (WCAG 2.4.2)
+- \`log_finding\`
+
+### 2.2 Landmark Regions
+- \`virtual_perform\` → moveToNextLandmark (repeat until exhausted) to get overview
+- Then check specific landmark types directly:
+  - \`virtual_perform\` → moveToNextMain (required — verify it exists)
+  - \`virtual_perform\` → moveToNextNavigation (recommended)
+  - \`virtual_perform\` → moveToNextBanner (header)
+  - \`virtual_perform\` → moveToNextContentinfo (footer)
+  - \`virtual_perform\` → moveToNextComplementary (aside)
+  - \`virtual_perform\` → moveToNextSearch (search region)
+- \`log_finding\` for WCAG 1.3.1
+
+### 2.3 Heading Structure
+- \`virtual_perform\` → moveToNextHeading (repeat until exhausted)
+- Record each heading level and text via \`virtual_last_spoken_phrase\` and \`virtual_item_text\`
+- Verify: exactly one h1, no skipped levels
+- \`log_finding\` for WCAG 1.3.1, 2.4.6
+
+### 2.4 Links
+- \`virtual_perform\` → moveToNextLink (repeat)
+- Verify descriptive link text (not "click here", "read more", "here")
+- \`log_finding\` for WCAG 2.4.4
+
+### 2.5 Forms
+- \`virtual_perform\` → moveToNextForm (repeat) — find form containers
+- Within each form: \`virtual_perform\` → findNextControl (repeat) — find individual controls
+- For each control: \`virtual_last_spoken_phrase\` to verify label, required state
+- \`log_finding\` for WCAG 1.3.1, 3.3.2, 4.1.2
+
+### 2.6 Images
+- \`virtual_perform\` → moveToNextFigure (repeat until exhausted) — jump directly from image to image
+- For each image:
+  a. \`virtual_last_spoken_phrase\` — check what is announced
+  b. \`virtual_item_text\` — check the text content
+  c. Informative images: verify alt text exists and is descriptive
+  d. Decorative images: verify they are hidden (role="presentation" or alt="")
+- \`log_finding\` for WCAG 1.1.1
+
+### 2.7 Keyboard Navigation
+- Use \`virtual_press\` with "Tab" to tab through the page
+- Verify logical focus order, no keyboard traps, interactive elements reachable
+- \`log_finding\` for WCAG 2.1.1, 2.1.2, 2.4.3`,
+            headings: `## Phase 2 — Heading Audit
+
+- \`virtual_perform\` → moveToNextHeading (repeat until exhausted) — collect all headings
+- For each heading record: level and text via \`virtual_last_spoken_phrase\` and \`virtual_item_text\`
+- Then verify h1 count with a targeted pass:
+  - \`virtual_perform\` → moveToNextHeadingLevel1 (repeat) — count all h1s (must be exactly one)
+- If skipped levels suspected, verify with level-specific commands:
+  - moveToNextHeadingLevel2, moveToNextHeadingLevel3, etc.
+- Verify:
+  - Exactly one h1 on the page
+  - No skipped levels (h1→h2→h3, not h1→h3)
+  - Headings are descriptive (not empty, not just "Section")
+  - Heading hierarchy reflects content structure
+- \`log_finding\` for WCAG 1.3.1, 2.4.6`,
+            forms: `## Phase 2 — Form Audit
+
+- \`virtual_perform\` → moveToNextForm (repeat) — find form containers
+- Within each form, find individual controls:
+  a. \`virtual_perform\` → findNextControl (repeat until exhausted)
+- For each control:
+  a. Record announcement via \`virtual_last_spoken_phrase\`
+  b. \`virtual_item_text\` — verify label association
+  c. Check required state is announced
+  d. For text inputs: \`virtual_type\` to enter text, check validation
+  e. \`virtual_press\` with "Tab" to verify keyboard flow
+- Also check ARIA error relationships: \`virtual_perform\` → jumpToErrorMessageElement
+- Verify:
+  - All inputs have labels (WCAG 1.3.1, 3.3.2)
+  - Required fields indicated (WCAG 3.3.2)
+  - Error messages announced (WCAG 3.3.1)
+  - Form completable entirely by keyboard (WCAG 2.1.1)
+  - Submit button reachable by keyboard
+- \`log_finding\` for each issue`,
+            navigation: `## Phase 2 — Navigation Audit
+
+### Skip Links
+- \`virtual_press\` with "Tab" once from start — check for a "skip to content" link
+
+### Landmarks
+- Check each specific landmark type directly for precise verification:
+  - \`virtual_perform\` → moveToNextMain — MUST exist (required landmark)
+  - \`virtual_perform\` → moveToNextNavigation — recommended
+  - \`virtual_perform\` → moveToNextBanner — header region
+  - \`virtual_perform\` → moveToNextContentinfo — footer region
+  - \`virtual_perform\` → moveToNextComplementary — aside region
+  - \`virtual_perform\` → moveToNextSearch — search region
+  - \`virtual_perform\` → moveToNextRegion — named regions
+- Then \`virtual_perform\` → moveToNextLandmark (repeat) to catch any additional landmarks
+- \`log_finding\` for WCAG 1.3.1
+
+### Tab Order
+- \`virtual_press\` with "Tab" through entire page
+- Verify order follows visual/logical reading order
+- Verify no keyboard traps (can always Tab out)
+- Verify all interactive elements are reachable
+- \`log_finding\` for WCAG 2.1.1, 2.1.2, 2.4.3
+
+### Focus Management
+- Check modals: focus should be trapped inside
+- Check expandable sections: focus should move appropriately
+- \`log_finding\` for WCAG 2.4.3`,
+            links: `## Phase 2 — Link Audit
+
+- \`virtual_perform\` → moveToNextLink (repeat until exhausted)
+- For each link:
+  a. \`virtual_last_spoken_phrase\` — record full announcement
+  b. \`virtual_item_text\` — record link text
+  c. Verify link text is descriptive (not "click here", "read more", "here", "link")
+  d. Verify link purpose is clear from text alone or surrounding context
+  e. Check for redundant links (same destination, different text)
+- \`log_finding\` for WCAG 2.4.4 (Link Purpose in Context)`,
+            images: `## Phase 2 — Image Audit
+
+- \`virtual_perform\` → moveToNextFigure (repeat until exhausted) — jump directly from image to image
+- For each image:
+  a. \`virtual_last_spoken_phrase\` — check what the screen reader announces
+  b. \`virtual_item_text\` — check the text content
+  c. Informative images: verify alt text exists and is descriptive
+  d. Decorative images: verify they are hidden from the screen reader (role="presentation" or alt="")
+  e. Complex images (charts, diagrams): verify long description is provided (check with \`virtual_perform\` → jumpToDetailsElement)
+- \`log_finding\` for WCAG 1.1.1 (Non-text Content)`,
+        };
+        const testBlock = testBlocks[testType] ?? testBlocks.full;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Run a ${testType} accessibility audit of ${url} using the Virtual Screen Reader. Follow every step in order.
+
+## Phase 1 — Start
+1. \`virtual_start\` with url "${url}"
+2. \`start_audit\` with url "${url}", screenReader "virtual", wcagLevel "${wcagLevel}"
+
+${testBlock}
+
+## Handling Issues
+- Inability to navigate to an element via screen reader IS a finding — log it as a violation
+- Try a workaround (e.g., Tab key via \`virtual_press\`) and continue; never stop at the first failure
+
+## Phase 3 — Report & Shutdown
+1. \`end_audit\`
+2. \`generate_report\` with format "markdown"
+3. Present the report with critical issues first
+4. \`virtual_stop\``,
+                },
+            },
+        ];
+    },
+};
+const virtualFullAudit = {
+    prompt: {
+        name: 'virtual_full_audit',
+        description: 'Comprehensive virtual screen reader audit. Covers headings, landmarks, links, forms, images, and keyboard navigation.',
+        arguments: [
+            {
+                name: 'url',
+                description: 'URL of the page to audit',
+                required: true,
+            },
+            {
+                name: 'wcagLevel',
+                description: 'WCAG conformance level: A, AA, or AAA (default: AA)',
+                required: false,
+            },
+        ],
+    },
+    getMessage: (args) => virtualAccessibilityAudit.getMessage({
+        ...args,
+        testType: 'full',
+    }),
+};
+const virtualHeadingAudit = {
+    prompt: {
+        name: 'virtual_heading_audit',
+        description: 'Audit heading structure using the Virtual Screen Reader. Checks h1 uniqueness, hierarchy, and descriptive content.',
+        arguments: [
+            {
+                name: 'url',
+                description: 'URL of the page to audit',
+                required: true,
+            },
+        ],
+    },
+    getMessage: (args) => virtualAccessibilityAudit.getMessage({
+        ...args,
+        testType: 'headings',
+    }),
+};
+const virtualFormAudit = {
+    prompt: {
+        name: 'virtual_form_audit',
+        description: 'Audit form accessibility using the Virtual Screen Reader: labels, error messages, required fields, and keyboard navigation.',
+        arguments: [
+            {
+                name: 'url',
+                description: 'URL of the page with forms to audit',
+                required: true,
+            },
+        ],
+    },
+    getMessage: (args) => virtualAccessibilityAudit.getMessage({
+        ...args,
+        testType: 'forms',
+    }),
+};
+const virtualNavigationAudit = {
+    prompt: {
+        name: 'virtual_navigation_audit',
+        description: 'Audit keyboard navigation and landmarks using the Virtual Screen Reader. Checks tab order, landmarks, skip links, and focus management.',
+        arguments: [
+            {
+                name: 'url',
+                description: 'URL of the page to audit',
+                required: true,
+            },
+        ],
+    },
+    getMessage: (args) => virtualAccessibilityAudit.getMessage({
+        ...args,
+        testType: 'navigation',
+    }),
+};
+export const VIRTUAL_PROMPTS = new Map([
+    ['virtual_accessibility_audit', virtualAccessibilityAudit],
+    ['virtual_full_audit', virtualFullAudit],
+    ['virtual_heading_audit', virtualHeadingAudit],
+    ['virtual_form_audit', virtualFormAudit],
+    ['virtual_navigation_audit', virtualNavigationAudit],
+]);
+export const listVirtualPrompts = () => listPrompts(VIRTUAL_PROMPTS);
+export const getVirtualPromptMessages = (name, args) => getPromptMessages(name, args, VIRTUAL_PROMPTS);
+//# sourceMappingURL=virtual-prompts.js.map

package/dist/prompts/virtual-prompts.js.map

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

package/dist/screen-readers/virtual/virtual.adapter.d.ts

@@ -0,0 +1,32 @@
+import type { ClickOptions, ScreenReaderCommandResult, ScreenReaderPort } from '@weaaare/mcp-auditor-core';
+export declare class VirtualScreenReaderAdapter implements ScreenReaderPort {
+    private browser;
+    private context;
+    private page;
+    private getPage;
+    private ensureBrowser;
+    loadUrl(url: string): Promise<void>;
+    loadHtml(html: string): Promise<void>;
+    start(): Promise<ScreenReaderCommandResult>;
+    stop(): Promise<ScreenReaderCommandResult>;
+    next(): Promise<ScreenReaderCommandResult>;
+    previous(): Promise<ScreenReaderCommandResult>;
+    act(): Promise<ScreenReaderCommandResult>;
+    interact(): Promise<ScreenReaderCommandResult>;
+    stopInteracting(): Promise<ScreenReaderCommandResult>;
+    press(key: string): Promise<ScreenReaderCommandResult>;
+    type(text: string): Promise<ScreenReaderCommandResult>;
+    perform(command: string): Promise<ScreenReaderCommandResult>;
+    performCommander(_command: string): Promise<ScreenReaderCommandResult>;
+    getCommanderCommands(): string[];
+    itemText(): Promise<string>;
+    lastSpokenPhrase(): Promise<string>;
+    spokenPhraseLog(): Promise<string[]>;
+    itemTextLog(): Promise<string[]>;
+    clearSpokenPhraseLog(): Promise<void>;
+    clearItemTextLog(): Promise<void>;
+    click(options?: ClickOptions): Promise<ScreenReaderCommandResult>;
+    detect(): Promise<boolean>;
+    isDefault(): Promise<boolean>;
+}
+//# sourceMappingURL=virtual.adapter.d.ts.map

package/dist/screen-readers/virtual/virtual.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.adapter.d.ts","sourceRoot":"","sources":["../../../src/screen-readers/virtual/virtual.adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAqBnC,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,IAAI,CAAqB;IAEjC,OAAO,CAAC,OAAO;YASD,aAAa;IA6BrB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAU3C,IAAI,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAoC1C,IAAI,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAY1C,QAAQ,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAY9C,GAAG,IAAI,OAAO,CAAC,yBAAyB,CAAC;IASzC,QAAQ,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAQ9C,eAAe,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAQrD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAStD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAQtD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAmBlE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAMtE,oBAAoB,IAAI,MAAM,EAAE;IAI1B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAO3B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAOnC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOpC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOhC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAajE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAGpC"}

package/dist/screen-readers/virtual/virtual.adapter.js

@@ -0,0 +1,246 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { chromium } from 'playwright-core';
+const _require = createRequire(import.meta.url);
+const BROWSER_BUNDLE_PATH = join(dirname(_require.resolve('@guidepup/virtual-screen-reader/package.json')), 'lib', 'esm', 'index.browser.js');
+const BUNDLE_INTERCEPT_URL = 'https://virtual-sr-local/bundle.js';
+const ADAPT_VIRTUAL_COMMANDS = {
+    findNextHeading: 'moveToNextHeading',
+    findPreviousHeading: 'moveToPreviousHeading',
+    findNextLink: 'moveToNextLink',
+    findPreviousLink: 'moveToPreviousLink',
+    findNextControl: 'moveToNextForm',
+    findPreviousControl: 'moveToPreviousForm',
+};
+export class VirtualScreenReaderAdapter {
+    browser = null;
+    context = null;
+    page = null;
+    getPage() {
+        if (!this.page) {
+            throw new Error('No page loaded. Call loadUrl() or loadHtml() before using the virtual screen reader.');
+        }
+        return this.page;
+    }
+    async ensureBrowser() {
+        if (this.page) {
+            try {
+                await this.page.close();
+            }
+            catch {
+                /* ignore */
+            }
+            this.page = null;
+        }
+        if (this.context) {
+            try {
+                await this.context.close();
+            }
+            catch {
+                /* ignore */
+            }
+            this.context = null;
+        }
+        if (!this.browser) {
+            this.browser = await chromium.launch({ headless: true, channel: 'chrome' });
+        }
+        this.context = await this.browser.newContext({ bypassCSP: true });
+        this.page = await this.context.newPage();
+        const bundleSource = readFileSync(BROWSER_BUNDLE_PATH, 'utf-8');
+        await this.page.route(BUNDLE_INTERCEPT_URL, (route) => {
+            route.fulfill({ contentType: 'application/javascript', body: bundleSource });
+        });
+        return this.page;
+    }
+    async loadUrl(url) {
+        const page = await this.ensureBrowser();
+        await page.goto(url, { waitUntil: 'load' });
+    }
+    async loadHtml(html) {
+        const page = await this.ensureBrowser();
+        await page.setContent(html, { waitUntil: 'load' });
+    }
+    async start() {
+        const page = this.getPage();
+        await page.evaluate(async (bundleUrl) => {
+            const { virtual } = await import(bundleUrl);
+            globalThis.__guidepupVirtual = virtual;
+            await virtual.start({ container: globalThis.document.body });
+        }, BUNDLE_INTERCEPT_URL);
+        return { action: 'Virtual Screen Reader started successfully' };
+    }
+    async stop() {
+        if (this.page) {
+            try {
+                await this.page.evaluate(async () => {
+                    const v = globalThis.__guidepupVirtual;
+                    if (v)
+                        await v.stop();
+                });
+            }
+            catch {
+                /* page may already be closed */
+            }
+            try {
+                await this.page.close();
+            }
+            catch {
+                /* ignore */
+            }
+            this.page = null;
+        }
+        if (this.context) {
+            try {
+                await this.context.close();
+            }
+            catch {
+                /* ignore */
+            }
+            this.context = null;
+        }
+        if (this.browser) {
+            try {
+                await this.browser.close();
+            }
+            catch {
+                /* ignore */
+            }
+            this.browser = null;
+        }
+        return { action: 'Virtual Screen Reader stopped successfully' };
+    }
+    async next() {
+        const data = await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.next();
+            return {
+                itemText: (await v.itemText()),
+                spokenPhrase: (await v.lastSpokenPhrase()),
+            };
+        });
+        return { action: 'moved to next item', ...data };
+    }
+    async previous() {
+        const data = await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.previous();
+            return {
+                itemText: (await v.itemText()),
+                spokenPhrase: (await v.lastSpokenPhrase()),
+            };
+        });
+        return { action: 'moved to previous item', ...data };
+    }
+    async act() {
+        const data = await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.act();
+            return { spokenPhrase: (await v.lastSpokenPhrase()) };
+        });
+        return { action: 'performed default action', ...data };
+    }
+    async interact() {
+        await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.interact();
+        });
+        return { action: 'interact (no-op in virtual screen reader)' };
+    }
+    async stopInteracting() {
+        await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.stopInteracting();
+        });
+        return { action: 'stop interacting (no-op in virtual screen reader)' };
+    }
+    async press(key) {
+        const data = await this.getPage().evaluate(async (k) => {
+            const v = globalThis.__guidepupVirtual;
+            await v.press(k);
+            return { spokenPhrase: (await v.lastSpokenPhrase()) };
+        }, key);
+        return { action: `pressed key: ${key}`, ...data };
+    }
+    async type(text) {
+        await this.getPage().evaluate(async (t) => {
+            const v = globalThis.__guidepupVirtual;
+            await v.type(t);
+        }, text);
+        return { action: `typed: ${text}` };
+    }
+    async perform(command) {
+        const virtualCommand = ADAPT_VIRTUAL_COMMANDS[command] ?? command;
+        const data = await this.getPage().evaluate(async (cmd) => {
+            const v = globalThis.__guidepupVirtual;
+            const cmdValue = v.commands[cmd];
+            if (!cmdValue) {
+                throw new Error(`Unknown command: ${cmd}. Available: ${Object.keys(v.commands).join(', ')}`);
+            }
+            await v.perform(cmdValue);
+            return {
+                itemText: (await v.itemText()),
+                spokenPhrase: (await v.lastSpokenPhrase()),
+            };
+        }, virtualCommand);
+        return { action: `performed command: ${command}`, ...data };
+    }
+    performCommander(_command) {
+        throw new Error('Commander commands are not supported in Virtual Screen Reader. Use perform() with virtual navigation commands instead (e.g., moveToNextLandmark, moveToNextHeadingLevel1).');
+    }
+    getCommanderCommands() {
+        return [];
+    }
+    async itemText() {
+        return this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            return (await v.itemText());
+        });
+    }
+    async lastSpokenPhrase() {
+        return this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            return (await v.lastSpokenPhrase());
+        });
+    }
+    async spokenPhraseLog() {
+        return this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            return (await v.spokenPhraseLog());
+        });
+    }
+    async itemTextLog() {
+        return this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            return (await v.itemTextLog());
+        });
+    }
+    async clearSpokenPhraseLog() {
+        await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.clearSpokenPhraseLog();
+        });
+    }
+    async clearItemTextLog() {
+        await this.getPage().evaluate(async () => {
+            const v = globalThis.__guidepupVirtual;
+            await v.clearItemTextLog();
+        });
+    }
+    async click(options) {
+        const button = options?.button ?? 'left';
+        const clickCount = options?.clickCount ?? 1;
+        await this.getPage().evaluate(async (opts) => {
+            const v = globalThis.__guidepupVirtual;
+            await v.click({ button: opts.button, clickCount: opts.clickCount });
+        }, { button, clickCount });
+        return { action: 'clicked mouse', spokenPhrase: `${button} click x${clickCount}` };
+    }
+    async detect() {
+        return true;
+    }
+    async isDefault() {
+        return false;
+    }
+}
+//# sourceMappingURL=virtual.adapter.js.map

package/dist/screen-readers/virtual/virtual.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.adapter.js","sourceRoot":"","sources":["../../../src/screen-readers/virtual/virtual.adapter.ts"],"names":[],"mappings":"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"}

package/dist/screen-readers/virtual/virtual.tools.d.ts

@@ -0,0 +1,4 @@
+import type { ToolModule } from '@weaaare/mcp-auditor-core';
+import type { VirtualScreenReaderAdapter } from './virtual.adapter.js';
+export declare const createVirtualTools: (adapter: VirtualScreenReaderAdapter) => ToolModule;
+//# sourceMappingURL=virtual.tools.d.ts.map

package/dist/screen-readers/virtual/virtual.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.tools.d.ts","sourceRoot":"","sources":["../../../src/screen-readers/virtual/virtual.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAqTvE,eAAO,MAAM,kBAAkB,GAAI,SAAS,0BAA0B,KAAG,UAGvE,CAAC"}

package/dist/screen-readers/virtual/virtual.tools.js

@@ -0,0 +1,297 @@
+import { result } from '@weaaare/mcp-auditor-core';
+const PERFORM_COMMAND_NAMES = [
+    'findNextHeading',
+    'findPreviousHeading',
+    'findNextLink',
+    'findPreviousLink',
+    'findNextControl',
+    'findPreviousControl',
+    'moveToNextHeading',
+    'moveToPreviousHeading',
+    'moveToNextHeadingLevel1',
+    'moveToPreviousHeadingLevel1',
+    'moveToNextHeadingLevel2',
+    'moveToPreviousHeadingLevel2',
+    'moveToNextHeadingLevel3',
+    'moveToPreviousHeadingLevel3',
+    'moveToNextHeadingLevel4',
+    'moveToPreviousHeadingLevel4',
+    'moveToNextHeadingLevel5',
+    'moveToPreviousHeadingLevel5',
+    'moveToNextHeadingLevel6',
+    'moveToPreviousHeadingLevel6',
+    'moveToNextLink',
+    'moveToPreviousLink',
+    'moveToNextLandmark',
+    'moveToPreviousLandmark',
+    'moveToNextBanner',
+    'moveToPreviousBanner',
+    'moveToNextNavigation',
+    'moveToPreviousNavigation',
+    'moveToNextMain',
+    'moveToPreviousMain',
+    'moveToNextRegion',
+    'moveToPreviousRegion',
+    'moveToNextContentinfo',
+    'moveToPreviousContentinfo',
+    'moveToNextComplementary',
+    'moveToPreviousComplementary',
+    'moveToNextSearch',
+    'moveToPreviousSearch',
+    'moveToNextForm',
+    'moveToPreviousForm',
+    'moveToNextFigure',
+    'moveToPreviousFigure',
+    'jumpToControlledElement',
+    'jumpToDetailsElement',
+    'jumpToErrorMessageElement',
+];
+const defineTools = () => [
+    {
+        name: 'virtual_start',
+        description: [
+            'Start the Virtual Screen Reader on a live web page or provided HTML content.',
+            'This launches a real browser (headless), navigates to the URL or loads the HTML,',
+            'and injects a virtual screen reader that navigates the live accessibility tree.',
+            'JavaScript on the page executes normally, so SPAs and dynamic content work.',
+            '',
+            "Provide either 'url' (preferred) or 'html'. If both are given, 'url' takes priority.",
+            '',
+            'Typical workflow:',
+            '1. Call virtual_start with the URL to audit',
+            '2. Navigate with virtual_next, virtual_previous, virtual_perform, etc.',
+            '3. Call virtual_stop when done',
+        ].join('\n'),
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'URL to audit. A real browser navigates to this URL, so JS executes and dynamic content renders.',
+                },
+                html: {
+                    type: 'string',
+                    description: 'Raw HTML content to audit. Used as fallback when no URL is provided.',
+                },
+            },
+        },
+    },
+    {
+        name: 'virtual_stop',
+        description: 'Stop the Virtual Screen Reader and release resources.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_next',
+        description: 'Move the Virtual Screen Reader cursor to the next item in the accessibility tree.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_previous',
+        description: 'Move the Virtual Screen Reader cursor to the previous item in the accessibility tree.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_act',
+        description: 'Perform the default action for the current item (e.g., activate a link or button).',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_interact',
+        description: 'Interact with the current item. Note: this is a no-op in the Virtual Screen Reader.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_stop_interacting',
+        description: 'Stop interacting with the current item. Note: this is a no-op in the Virtual Screen Reader.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_press',
+        description: "Press a key on the focused item (e.g., 'Enter', 'Tab', 'ArrowDown', 'Command+f').",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                key: {
+                    type: 'string',
+                    description: "Key to press (e.g., 'Enter', 'Tab', 'ArrowDown', 'Shift+Tab')",
+                },
+            },
+            required: ['key'],
+        },
+    },
+    {
+        name: 'virtual_type',
+        description: 'Type text into the focused item.',
+        inputSchema: {
+            type: 'object',
+            properties: { text: { type: 'string', description: 'Text to type' } },
+            required: ['text'],
+        },
+    },
+    {
+        name: 'virtual_perform',
+        description: [
+            'Perform a navigation command in the Virtual Screen Reader.',
+            'Supports semantic navigation by element type: headings (by level), links, landmarks, forms, figures, and ARIA relationships.',
+            '',
+            'Common compatible commands: findNextHeading, findPreviousHeading, findNextLink, findPreviousLink, findNextControl, findPreviousControl.',
+            '',
+            'Virtual-specific commands: moveToNextHeadingLevel1-6, moveToNextLandmark, moveToNextBanner, moveToNextNavigation, moveToNextMain, moveToNextRegion, etc.',
+        ].join('\n'),
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    enum: [...PERFORM_COMMAND_NAMES],
+                    description: 'Navigation command to perform',
+                },
+            },
+            required: ['command'],
+        },
+    },
+    {
+        name: 'virtual_item_text',
+        description: 'Get the text of the item currently under the Virtual Screen Reader cursor.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_last_spoken_phrase',
+        description: 'Get the last phrase spoken by the Virtual Screen Reader.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_spoken_phrase_log',
+        description: 'Get the log of all spoken phrases for this Virtual Screen Reader session.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_item_text_log',
+        description: 'Get the log of all visited item text for this Virtual Screen Reader session.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_clear_spoken_phrase_log',
+        description: 'Clear the log of all spoken phrases.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_clear_item_text_log',
+        description: 'Clear the log of all visited item text.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'virtual_click',
+        description: 'Click the mouse at the current position.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                button: {
+                    type: 'string',
+                    enum: ['left', 'right'],
+                    description: 'Mouse button to click (default: left)',
+                },
+                clickCount: { type: 'number', description: 'Number of times to click (default: 1)' },
+            },
+        },
+    },
+];
+const buildHandlers = (adapter) => {
+    const handlers = new Map();
+    handlers.set('virtual_start', async (args) => {
+        if (args.url) {
+            await adapter.loadUrl(args.url);
+        }
+        else if (args.html) {
+            await adapter.loadHtml(args.html);
+        }
+        else {
+            throw new Error("Either 'url' or 'html' parameter is required");
+        }
+        const res = await adapter.start();
+        return result.json(res);
+    });
+    handlers.set('virtual_stop', async () => {
+        const res = await adapter.stop();
+        return result.json(res);
+    });
+    handlers.set('virtual_next', async () => {
+        const res = await adapter.next();
+        return result.json(res);
+    });
+    handlers.set('virtual_previous', async () => {
+        const res = await adapter.previous();
+        return result.json(res);
+    });
+    handlers.set('virtual_act', async () => {
+        const res = await adapter.act();
+        return result.json(res);
+    });
+    handlers.set('virtual_interact', async () => {
+        const res = await adapter.interact();
+        return result.json(res);
+    });
+    handlers.set('virtual_stop_interacting', async () => {
+        const res = await adapter.stopInteracting();
+        return result.json(res);
+    });
+    handlers.set('virtual_press', async (args) => {
+        if (!args.key) {
+            throw new Error('key parameter is required');
+        }
+        const res = await adapter.press(args.key);
+        return result.json(res);
+    });
+    handlers.set('virtual_type', async (args) => {
+        if (!args.text) {
+            throw new Error('text parameter is required');
+        }
+        const res = await adapter.type(args.text);
+        return result.json(res);
+    });
+    handlers.set('virtual_perform', async (args) => {
+        if (!args.command) {
+            throw new Error('command parameter is required');
+        }
+        const res = await adapter.perform(args.command);
+        return result.json(res);
+    });
+    handlers.set('virtual_item_text', async () => {
+        const text = await adapter.itemText();
+        return result.text(text);
+    });
+    handlers.set('virtual_last_spoken_phrase', async () => {
+        const phrase = await adapter.lastSpokenPhrase();
+        return result.text(phrase);
+    });
+    handlers.set('virtual_spoken_phrase_log', async () => {
+        const log = await adapter.spokenPhraseLog();
+        return result.json(log);
+    });
+    handlers.set('virtual_item_text_log', async () => {
+        const log = await adapter.itemTextLog();
+        return result.json(log);
+    });
+    handlers.set('virtual_clear_spoken_phrase_log', async () => {
+        await adapter.clearSpokenPhraseLog();
+        return result.text('Spoken phrase log cleared');
+    });
+    handlers.set('virtual_clear_item_text_log', async () => {
+        await adapter.clearItemTextLog();
+        return result.text('Item text log cleared');
+    });
+    handlers.set('virtual_click', async (args) => {
+        const res = await adapter.click({
+            button: args.button ?? 'left',
+            clickCount: args.clickCount ?? 1,
+        });
+        return result.json(res);
+    });
+    return handlers;
+};
+export const createVirtualTools = (adapter) => ({
+    tools: defineTools(),
+    handlers: buildHandlers(adapter),
+});
+//# sourceMappingURL=virtual.tools.js.map

package/dist/screen-readers/virtual/virtual.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.tools.js","sourceRoot":"","sources":["../../../src/screen-readers/virtual/virtual.tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGnD,MAAM,qBAAqB,GAAG;IAC5B,iBAAiB;IACjB,qBAAqB;IACrB,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IACjB,qBAAqB;IACrB,mBAAmB;IACnB,uBAAuB;IACvB,yBAAyB;IACzB,6BAA6B;IAC7B,yBAAyB;IACzB,6BAA6B;IAC7B,yBAAyB;IACzB,6BAA6B;IAC7B,yBAAyB;IACzB,6BAA6B;IAC7B,yBAAyB;IACzB,6BAA6B;IAC7B,yBAAyB;IACzB,6BAA6B;IAC7B,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;IACpB,wBAAwB;IACxB,kBAAkB;IAClB,sBAAsB;IACtB,sBAAsB;IACtB,0BAA0B;IAC1B,gBAAgB;IAChB,oBAAoB;IACpB,kBAAkB;IAClB,sBAAsB;IACtB,uBAAuB;IACvB,2BAA2B;IAC3B,yBAAyB;IACzB,6BAA6B;IAC7B,kBAAkB;IAClB,sBAAsB;IACtB,gBAAgB;IAChB,oBAAoB;IACpB,kBAAkB;IAClB,sBAAsB;IACtB,yBAAyB;IACzB,sBAAsB;IACtB,2BAA2B;CACnB,CAAC;AAEX,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC;IAChC;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;YACX,8EAA8E;YAC9E,kFAAkF;YAClF,iFAAiF;YACjF,6EAA6E;YAC7E,EAAE;YACF,sFAAsF;YACtF,EAAE;YACF,mBAAmB;YACnB,6CAA6C;YAC7C,wEAAwE;YACxE,gCAAgC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iGAAiG;iBACpG;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sEAAsE;iBACpF;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,mFAAmF;QACrF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,uFAAuF;QACzF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oFAAoF;QACtF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,qFAAqF;QACvF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,6FAA6F;QAC/F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,mFAAmF;QACrF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+DAA+D;iBAC7E;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,kCAAkC;QAC/C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;YACrE,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;YACX,4DAA4D;YAC5D,8HAA8H;YAC9H,EAAE;YACF,yIAAyI;YACzI,EAAE;YACF,0JAA0J;SAC3J,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,GAAG,qBAAqB,CAAC;oBAChC,WAAW,EAAE,+BAA+B;iBAC7C;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,iCAAiC;QACvC,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,yCAAyC;QACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;oBACvB,WAAW,EAAE,uCAAuC;iBACrD;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;aACrF;SACF;KACF;CACF,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,OAAmC,EAA4B,EAAE;IACtF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhD,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC1C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAiB,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;YAC9B,MAAM,EAAG,IAAI,CAAC,MAA2B,IAAI,MAAM;YACnD,UAAU,EAAG,IAAI,CAAC,UAAqB,IAAI,CAAC;SAC7C,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAmC,EAAc,EAAE,CAAC,CAAC;IACtF,KAAK,EAAE,WAAW,EAAE;IACpB,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC;CACjC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare const createServer: () => Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAsBnE,eAAO,MAAM,YAAY,QAAO,MAsD/B,CAAC"}

package/dist/server.js

@@ -0,0 +1,48 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { AuditSession, createAuditTools, createReportTools, listResources, readResource, ToolRegistry, } from '@weaaare/mcp-auditor-core';
+import packageVersion from '../package.json' with { type: 'json' };
+import { getVirtualPromptMessages, listVirtualPrompts } from './prompts/virtual-prompts.js';
+import { VirtualScreenReaderAdapter } from './screen-readers/virtual/virtual.adapter.js';
+import { createVirtualTools } from './screen-readers/virtual/virtual.tools.js';
+export const createServer = () => {
+    const server = new Server({
+        name: 'mcp-virtual-screen-reader-auditor',
+        version: packageVersion.version,
+    }, { capabilities: { tools: {}, prompts: {}, resources: {} } });
+    const adapter = new VirtualScreenReaderAdapter();
+    const session = new AuditSession();
+    const registry = new ToolRegistry();
+    registry.register(createVirtualTools(adapter));
+    registry.register(createAuditTools(session));
+    registry.register(createReportTools(session));
+    // --- Tools ---
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: registry.listTools(),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return registry.callTool(name, args ?? {});
+    });
+    // --- Prompts ---
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: listVirtualPrompts(),
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const messages = getVirtualPromptMessages(name, args ?? {});
+        return {
+            description: `Audit prompt: ${name}`,
+            messages,
+        };
+    });
+    // --- Resources ---
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listResources(session),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        return readResource(request.params.uri, session);
+    });
+    return server;
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,cAAc,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE;IACvC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE,cAAc,CAAC,OAAO;KAChC,EACD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAC5D,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,0BAA0B,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAEpC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE9C,gBAAgB;IAChB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE;KAC5B,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAG,IAAgC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,kBAAkB,EAAE;KAC9B,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,QAAQ,GAAG,wBAAwB,CACvC,IAAI,EACH,IAA2C,IAAI,EAAE,CACnD,CAAC;QACF,OAAO;YACL,WAAW,EAAE,iBAAiB,IAAI,EAAE;YACpC,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;KAClC,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@weaaare/mcp-virtual-screen-reader-auditor",
+  "version": "0.0.1",
+  "description": "MCP server for virtual screen reader accessibility auditing — headless browser-based screen reader simulation that works on any OS",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "mcp-virtual-screen-reader-auditor": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "lint": "biome check .",
+    "dev": "tsc --watch",
+    "test": "rstest --passWithNoTests"
+  },
+  "dependencies": {
+    "@guidepup/virtual-screen-reader": "catalog:",
+    "@modelcontextprotocol/sdk": "catalog:",
+    "@weaaare/mcp-auditor-core": "workspace:*",
+    "playwright-core": "catalog:"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "catalog:",
+    "@rstest/core": "catalog:",
+    "@types/node": "catalog:",
+    "@weaaare/config": "workspace:*",
+    "typescript": "catalog:"
+  },
+  "keywords": [
+    "mcp",
+    "accessibility",
+    "a11y",
+    "virtual-screen-reader",
+    "screen-reader",
+    "wcag",
+    "headless"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weAAAre/accessibility-ai.git",
+    "directory": "packages/mcp-virtual-screen-reader-auditor"
+  },
+  "homepage": "https://github.com/weAAAre/accessibility-ai/tree/main/packages/mcp-virtual-screen-reader-auditor#readme",
+  "bugs": {
+    "url": "https://github.com/weAAAre/accessibility-ai/issues"
+  },
+  "author": "weAAAre <hola@weAAAre.com> (https://weAAAre.com)",
+  "engines": {
+    "node": ">=24"
+  }
+}