@iblai/mcp 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,123 +1,129 @@
 #!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
 // Import resources
 import { RESOURCES } from './resources/index.js';
 // Import tools
-import { TOOLS, getComponentInfo, getHookInfo, getProviderSetup, getApiQueryInfo, createPageTemplate, } from './tools/index.js';
+import { getComponentInfo, getHookInfo, getProviderSetup, getApiQueryInfo, createPageTemplate, getPlaywrightHelperInfo, } from './tools/index.js';
+// Import prompts
+import { generateE2ESetupPrompt, generateCreateTestPrompt, generateSetupNewAppPrompt, } from './prompts/index.js';
 // ============================================================================
 // IBL FRONTEND MCP SERVER
 // ============================================================================
 // This MCP server provides comprehensive documentation and guidance for
-// working with the IBL frontend packages: web-containers, web-utils, data-layer
+// working with the IBL frontend packages: web-containers, web-utils,
+// data-layer, and @iblai/iblai-js/playwright
 // ============================================================================
-const server = new Server({
+const server = new McpServer({
     name: 'ibl-frontend-mcp',
     version: '1.0.0',
-}, {
-    capabilities: {
-        resources: {},
-        tools: {},
-    },
 });
 // ============================================================================
-// RESOURCE HANDLERS
+// RESOURCES
 // ============================================================================
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return {
-        resources: Object.entries(RESOURCES).map(([uri, resource]) => ({
-            uri,
-            name: resource.name,
-            description: resource.description,
-            mimeType: resource.mimeType,
-        })),
-    };
-});
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const uri = request.params.uri;
-    const resource = RESOURCES[uri];
-    if (!resource) {
-        throw new Error(`Resource not found: ${uri}`);
-    }
-    return {
+for (const resource of Object.values(RESOURCES)) {
+    server.registerResource(resource.name, resource.uri, { description: resource.description, mimeType: resource.mimeType }, async (uri) => ({
         contents: [
             {
-                uri,
+                uri: uri.href,
                 mimeType: resource.mimeType,
                 text: resource.content,
             },
         ],
-    };
-});
+    }));
+}
 // ============================================================================
-// TOOL HANDLERS
+// TOOLS
 // ============================================================================
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools: TOOLS };
-});
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    switch (name) {
-        case 'get_component_info': {
-            const componentName = args.componentName;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: getComponentInfo(componentName),
-                    },
-                ],
-            };
-        }
-        case 'get_hook_info': {
-            const hookName = args.hookName;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: getHookInfo(hookName),
-                    },
-                ],
-            };
-        }
-        case 'get_provider_setup': {
-            const { appType, features } = args;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: getProviderSetup(appType, features || []),
-                    },
-                ],
-            };
-        }
-        case 'get_api_query_info': {
-            const queryName = args.queryName;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: getApiQueryInfo(queryName),
-                    },
-                ],
-            };
-        }
-        case 'create_page_template': {
-            const { pageName, features, appType } = args;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: createPageTemplate(pageName, appType, features || []),
-                    },
-                ],
-            };
-        }
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
-});
+server.registerTool('get_component_info', {
+    description: 'Get detailed information about a specific UI component from web-containers',
+    inputSchema: { componentName: z.string().describe('Name of the component (e.g., Button, Card, Dialog, Profile, NotificationDropdown)') },
+}, async ({ componentName }) => ({
+    content: [{ type: 'text', text: getComponentInfo(componentName) }],
+}));
+server.registerTool('get_hook_info', {
+    description: 'Get detailed information about a custom React hook from web-utils or data-layer',
+    inputSchema: { hookName: z.string().describe('Name of the hook (e.g., useAdvancedChat, useMentorSettings)') },
+}, async ({ hookName }) => ({
+    content: [{ type: 'text', text: getHookInfo(hookName) }],
+}));
+server.registerTool('get_provider_setup', {
+    description: 'Get provider setup code for an IBL app (AuthProvider, TenantProvider, etc.)',
+    inputSchema: {
+        appType: z.string().describe('Type of IBL app (e.g., mentor, skills, auth)'),
+        features: z.array(z.string()).optional().describe('Optional features to include (e.g., chat, analytics, rbac)'),
+    },
+}, async ({ appType, features }) => ({
+    content: [{ type: 'text', text: getProviderSetup(appType, features || []) }],
+}));
+server.registerTool('get_api_query_info', {
+    description: 'Get detailed information about an RTK Query API hook from data-layer',
+    inputSchema: { queryName: z.string().describe('Name of the RTK Query API hook (e.g., useGetMentorSettingsQuery)') },
+}, async ({ queryName }) => ({
+    content: [{ type: 'text', text: getApiQueryInfo(queryName) }],
+}));
+server.registerTool('create_page_template', {
+    description: 'Generate a Next.js page template with IBL providers and components',
+    inputSchema: {
+        pageName: z.string().describe('Name of the page to create (e.g., Dashboard, Settings)'),
+        appType: z.string().describe('Type of IBL app (e.g., mentor, skills, auth)'),
+        features: z.array(z.string()).optional().describe('Optional features to include'),
+    },
+}, async ({ pageName, appType, features }) => ({
+    content: [{ type: 'text', text: createPageTemplate(pageName, appType, features || []) }],
+}));
+server.registerTool('get_playwright_helper_info', {
+    description: 'Get detailed documentation for a specific Playwright test helper from @iblai/iblai-js/playwright',
+    inputSchema: { helperName: z.string().describe('Name of the Playwright helper (e.g., createPlaywrightConfig, reliableClick, safeWaitForURL, createAuthSetup)') },
+}, async ({ helperName }) => ({
+    content: [{ type: 'text', text: getPlaywrightHelperInfo(helperName) }],
+}));
+// ============================================================================
+// PROMPTS
+// ============================================================================
+server.registerPrompt('setup-e2e-testing', {
+    description: 'Generate instructions for setting up Playwright E2E testing in an IBL app',
+    argsSchema: {
+        appType: z.enum(['mentor', 'skills', 'auth', 'custom']).describe('Type of IBL app to set up E2E testing for'),
+        appName: z.string().optional().describe('Optional custom app name (defaults to appType)'),
+    },
+}, async ({ appType, appName }) => ({
+    messages: [
+        {
+            role: 'user',
+            content: { type: 'text', text: generateE2ESetupPrompt(appType, appName) },
+        },
+    ],
+}));
+server.registerPrompt('create-playwright-test', {
+    description: 'Generate a Playwright E2E test for a specific feature using IBL SDK conventions',
+    argsSchema: {
+        feature: z.string().describe('Feature to write a test for (e.g., login, mentor creation, chat)'),
+        appType: z.enum(['mentor', 'skills', 'auth', 'custom']).describe('Type of IBL app'),
+    },
+}, async ({ feature, appType }) => ({
+    messages: [
+        {
+            role: 'user',
+            content: { type: 'text', text: generateCreateTestPrompt(feature, appType) },
+        },
+    ],
+}));
+server.registerPrompt('setup-new-app', {
+    description: 'Generate comprehensive setup instructions for a new IBL app with providers, store, and E2E testing',
+    argsSchema: {
+        appType: z.enum(['mentor', 'skills', 'auth', 'custom']).describe('Type of IBL app to set up'),
+        features: z.array(z.string()).optional().describe('Optional features: rbac, analytics, chat, e2e'),
+    },
+}, async ({ appType, features }) => ({
+    messages: [
+        {
+            role: 'user',
+            content: { type: 'text', text: generateSetupNewAppPrompt(appType, features) },
+        },
+    ],
+}));
 // ============================================================================
 // SERVER STARTUP
 // ============================================================================

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,eAAe;AACf,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,iBAAiB;AACjB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAC/E,wEAAwE;AACxE,qEAAqE;AACrE,6CAA6C;AAC7C,+EAA+E;AAE/E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IAChD,MAAM,CAAC,gBAAgB,CACrB,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,GAAG,EACZ,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAClE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,QAAQ,CAAC,OAAO;aACvB;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;IACE,WAAW,EAAE,4EAA4E;IACzF,WAAW,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mFAAmF,CAAC,EAAE;CACzI,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;CAC5E,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;IACE,WAAW,EAAE,iFAAiF;IAC9F,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC,EAAE;CAC9G,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;CAClE,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;IACE,WAAW,EAAE,6EAA6E;IAC1F,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC5E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KAChH;CACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;CACtF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;IACE,WAAW,EAAE,sEAAsE;IACnF,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC,EAAE;CACpH,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;CACvE,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;IACE,WAAW,EAAE,oEAAoE;IACjF,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACvF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC5E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAClF;CACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;CAClG,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;IACE,WAAW,EAAE,kGAAkG;IAC/G,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8GAA8G,CAAC,EAAE;CACjK,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAAE,CAAC;CAChF,CAAC,CACH,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,cAAc,CACnB,mBAAmB,EACnB;IACE,WAAW,EAAE,2EAA2E;IACxF,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAC7G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KAC1F;CACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/B,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;SACnF;KACF;CACF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,cAAc,CACnB,wBAAwB,EACxB;IACE,WAAW,EAAE,iFAAiF;IAC9F,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;QAChG,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KACpF;CACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/B,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;SACrF;KACF;CACF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;IACE,WAAW,EAAE,oGAAoG;IACjH,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC7F,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;KACnG;CACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;SACvF;KACF;CACF,CAAC,CACH,CAAC;AAEF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/prompts/create-playwright-test.d.ts

@@ -0,0 +1,2 @@
+export declare function generateCreateTestPrompt(feature: string, appType: string): string;
+//# sourceMappingURL=create-playwright-test.d.ts.map

package/dist/prompts/create-playwright-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-playwright-test.d.ts","sourceRoot":"","sources":["../../src/prompts/create-playwright-test.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuGjF"}

package/dist/prompts/create-playwright-test.js

@@ -0,0 +1,103 @@
+export function generateCreateTestPrompt(feature, appType) {
+    const hostVar = appType === 'mentor'
+        ? 'MENTOR_NEXTJS_HOST'
+        : appType === 'skills'
+            ? 'SKILLS_HOST'
+            : 'APP_HOST';
+    return `Write a Playwright E2E test for the "${feature}" feature in an IBL.ai ${appType} app.
+
+## Conventions
+
+### Imports
+
+\`\`\`typescript
+// Core Playwright (always import test/expect from here)
+import { test, expect, Page } from '@playwright/test';
+
+// SDK utilities (import helpers from here)
+import {
+  logger,
+  safeWaitForURL,
+  waitForPageReady,
+  reliableClick,
+  reliableFill,
+  waitForDialogReady,
+  closeWithEsc,
+  expectNoAccessibilityViolations,
+} from '@iblai/iblai-js/playwright';
+
+// App-specific env vars
+import { ${hostVar} } from '../utils';
+\`\`\`
+
+### Test Structure
+
+\`\`\`typescript
+test.describe('${feature}', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto(${hostVar});
+    await waitForPageReady(page);
+  });
+
+  test('should ...', async ({ page }) => {
+    // Use logger for debugging
+    logger.info('Starting test step');
+
+    // Use reliableClick for buttons (retries on detached/hidden elements)
+    await reliableClick(page, page.getByRole('button', { name: 'Action' }));
+
+    // Use reliableFill for inputs (clears, fills, verifies value)
+    await reliableFill(page, page.getByLabel('Name'), 'Test Value');
+
+    // Use safeWaitForURL for navigation (handles browser quirks)
+    await safeWaitForURL(page, (url) => url.pathname.includes('/target'));
+
+    // Standard Playwright assertions
+    await expect(page.getByText('Expected')).toBeVisible();
+  });
+});
+\`\`\`
+
+### Available Helpers
+
+**Navigation:**
+- \`safeWaitForURL(page, urlMatcher, options?)\` — Browser-safe URL waiting
+- \`waitForPageLoad(page)\` — Full page load (load + DOM + networkidle)
+- \`isFirefox(page)\` — Check if Firefox (for browser-specific logic)
+
+**Page Interaction:**
+- \`waitForPageReady(page, timeout?)\` — Wait for document.readyState complete
+- \`reliableClick(page, locator, timeout?, maxRetries?)\` — Click with retry
+- \`reliableFill(page, locator, value, timeout?, maxRetries?)\` — Fill with retry
+- \`waitForElementStable(page, locator, timeout?)\` — Wait for element stability
+- \`waitForDialogReady(page, dialogLocator, timeout?)\` — Wait for dialog
+- \`selectDateFromCalendar(page, dialogLocator, targetDate, timeout?)\` — Date picker
+- \`closeWithEsc(page)\` — Press Escape to close modals
+
+**Assertions:**
+- \`expectNoAccessibilityViolations(page)\` — Full page axe-core audit
+- \`expectNoAccessibilityViolationsOnDialogs(page, rules?, exclude?)\` — Dialog a11y
+
+**Auth:**
+- \`loginWithEmailAndPassword(page, username, password, hostUrl)\` — Login flow
+- \`signUpWithEmailAndPassword(page, authHost, postSignUpUrl, credentials?)\` — Sign up
+
+**Utilities:**
+- \`logger\` — Winston logger (info locally, silent in CI)
+- \`retry(action, errorMessage, retryCount?)\` — Generic retry
+- \`checkAdminStatus(page)\` — Check admin from localStorage
+
+### Best Practices
+
+1. **Use \`safeWaitForURL\` instead of \`page.waitForURL\`** — handles Firefox NS_BINDING_ABORTED errors
+2. **Use \`reliableClick\`/\`reliableFill\`** — handles detached elements and race conditions
+3. **Use \`waitForPageReady\` after navigation** — ensures page is interactive
+4. **Use \`logger.info()\` for debugging** — visible locally, suppressed in CI
+5. **Use \`data-testid\` attributes** for element selection when role-based selectors are unreliable
+6. **Set timeouts generously** — use \`test.setTimeout()\` for slow operations
+7. **Use \`test.describe\` blocks** to group related tests
+8. **Add accessibility tests** with \`expectNoAccessibilityViolations\`
+
+Now write the test for "${feature}". Include appropriate beforeEach setup, multiple test cases covering happy path and edge cases, and use the SDK helpers where appropriate.`;
+}
+//# sourceMappingURL=create-playwright-test.js.map

package/dist/prompts/create-playwright-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-playwright-test.js","sourceRoot":"","sources":["../../src/prompts/create-playwright-test.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,OAAe;IACvE,MAAM,OAAO,GACX,OAAO,KAAK,QAAQ;QAClB,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,OAAO,KAAK,QAAQ;YACpB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,UAAU,CAAC;IAEnB,OAAO,wCAAwC,OAAO,0BAA0B,OAAO;;;;;;;;;;;;;;;;;;;;;;;WAuB9E,OAAO;;;;;;iBAMD,OAAO;;sBAEF,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA+DH,OAAO,6IAA6I,CAAC;AAC/K,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,4 @@
+export { generateE2ESetupPrompt } from './setup-e2e-testing.js';
+export { generateCreateTestPrompt } from './create-playwright-test.js';
+export { generateSetupNewAppPrompt } from './setup-new-app.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,4 @@
+export { generateE2ESetupPrompt } from './setup-e2e-testing.js';
+export { generateCreateTestPrompt } from './create-playwright-test.js';
+export { generateSetupNewAppPrompt } from './setup-new-app.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/prompts/setup-e2e-testing.d.ts

@@ -0,0 +1,2 @@
+export declare function generateE2ESetupPrompt(appType: string, appName?: string): string;
+//# sourceMappingURL=setup-e2e-testing.d.ts.map

package/dist/prompts/setup-e2e-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-e2e-testing.d.ts","sourceRoot":"","sources":["../../src/prompts/setup-e2e-testing.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAoKhF"}

package/dist/prompts/setup-e2e-testing.js

@@ -0,0 +1,162 @@
+export function generateE2ESetupPrompt(appType, appName) {
+    const name = appName || appType;
+    const hostVar = appType === 'mentor'
+        ? 'MENTOR_NEXTJS_HOST'
+        : appType === 'skills'
+            ? 'SKILLS_HOST'
+            : appType === 'auth'
+                ? 'AUTH_HOST'
+                : 'APP_HOST';
+    const platformName = appType === 'mentor' ? 'mentornextjs' : appType === 'skills' ? 'skills' : name;
+    return `Set up Playwright E2E testing for an IBL.ai ${appType} app called "${name}" using @iblai/iblai-js/playwright.
+
+## What to create
+
+### 1. e2e/playwright.config.ts
+
+\`\`\`typescript
+import { createPlaywrightConfig } from '@iblai/iblai-js/playwright';
+import dotenv from 'dotenv';
+import path from 'path';
+
+dotenv.config({ path: path.resolve(__dirname, '.env.development') });
+
+export default createPlaywrightConfig({
+  platforms: [
+    {
+      name: '${platformName}',
+      dependencies: ['setup'],
+      otherTestMatch: ['**${platformName}/*/*.spec.ts'],
+    },
+  ],
+});
+\`\`\`
+
+This generates per-browser auth setup projects (setup-chrome, setup-firefox, setup-safari, setup-edge) and test projects for each platform/browser combination. CI mode: retries=3, workers=1, headless, trace=retain-on-failure.
+
+### 2. e2e/auth.setup.ts
+
+\`\`\`typescript
+import { test as setup, createAuthSetup } from '@iblai/iblai-js/playwright';
+
+setup(
+  'authenticate',
+  createAuthSetup({
+    hostUrl: process.env.${hostVar} || '',
+    authHost: process.env.AUTH_HOST || '',
+    appName: '${appType}',
+    postLoginUrlMatcher: (url) =>
+      url.href.includes('/platform/') || url.href.includes('/home'),
+  }),
+);
+\`\`\`
+
+Authenticates once per browser and saves storage state to \`playwright/.auth/user-{browser}.json\`. Supports auth flows: username_password (default), magic_link, sso, direct_sso.
+
+### 3. e2e/custom-reporter.ts
+
+\`\`\`typescript
+export { CustomReporter as default } from '@iblai/iblai-js/playwright';
+\`\`\`
+
+### 4. e2e/.env.development
+
+\`\`\`
+${hostVar}=https://${name}.example.com
+AUTH_HOST=https://auth.example.com
+PLAYWRIGHT_USERNAME=test@example.com
+PLAYWRIGHT_PASSWORD=testpassword
+AUTH_FLOW=username_password
+AUTH_IDP=
+\`\`\`
+
+### 5. e2e/tests/utils.ts
+
+\`\`\`typescript
+export const ${hostVar} = process.env.${hostVar} || '';
+export const AUTH_HOST = process.env.AUTH_HOST || '';
+\`\`\`
+
+### 6. e2e/tests/helpers.ts
+
+\`\`\`typescript
+import { loginWithEmailAndPassword, logger } from '@iblai/iblai-js/playwright';
+import { ${hostVar}, AUTH_HOST } from './utils';
+
+export async function loginAsTestUser(page: import('@playwright/test').Page) {
+  const username = process.env.PLAYWRIGHT_USERNAME || '';
+  const password = process.env.PLAYWRIGHT_PASSWORD || '';
+  await loginWithEmailAndPassword(page, username, password, ${hostVar});
+}
+\`\`\`
+
+### 7. Sample test file: e2e/tests/${platformName}/example.spec.ts
+
+\`\`\`typescript
+import { test, expect } from '@playwright/test';
+import { logger, safeWaitForURL, waitForPageReady, reliableClick } from '@iblai/iblai-js/playwright';
+import { ${hostVar} } from '../utils';
+
+test.describe('Example Feature', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto(${hostVar});
+    await waitForPageReady(page);
+  });
+
+  test('should load the page', async ({ page }) => {
+    logger.info('Checking page loaded');
+    await expect(page.getByRole('heading')).toBeVisible();
+  });
+
+  test('should navigate on click', async ({ page }) => {
+    await reliableClick(page, page.getByRole('button', { name: 'Continue' }));
+    await safeWaitForURL(page, (url) => url.pathname.includes('/next'));
+    await expect(page.getByText('Next Page')).toBeVisible();
+  });
+});
+\`\`\`
+
+### 8. Directory structure
+
+\`\`\`
+e2e/
+├── playwright.config.ts
+├── auth.setup.ts
+├── custom-reporter.ts
+├── .env.development
+├── tests/
+│   ├── utils.ts
+│   ├── helpers.ts
+│   └── ${platformName}/
+│       └── example.spec.ts
+└── playwright/
+    └── .auth/            # Created automatically by auth setup
+\`\`\`
+
+### 9. package.json scripts
+
+\`\`\`json
+{
+  "test:e2e": "playwright test --config e2e/playwright.config.ts",
+  "test:e2e:ui": "playwright test --config e2e/playwright.config.ts --ui",
+  "test:e2e:headed": "cross-env HEADED=true playwright test --config e2e/playwright.config.ts"
+}
+\`\`\`
+
+### 10. Dependencies to install
+
+\`\`\`bash
+pnpm add -D @playwright/test @axe-core/playwright dotenv cross-env
+npx playwright install
+\`\`\`
+
+## Key patterns
+
+- Import \`test\` and \`expect\` from \`@playwright/test\` directly
+- Import utilities (\`logger\`, \`safeWaitForURL\`, \`waitForPageReady\`, \`reliableClick\`, \`reliableFill\`) from \`@iblai/iblai-js/playwright\`
+- Use \`safeWaitForURL\` instead of \`page.waitForURL\` — it handles Firefox NS_BINDING_ABORTED and Safari navigation policy errors
+- Use \`reliableClick\`/\`reliableFill\` for flaky UI interactions
+- Use \`waitForPageReady\` after navigation before assertions
+- Use \`expectNoAccessibilityViolations(page)\` for a11y testing`;
+}
+//# sourceMappingURL=setup-e2e-testing.js.map

package/dist/prompts/setup-e2e-testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-e2e-testing.js","sourceRoot":"","sources":["../../src/prompts/setup-e2e-testing.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,OAAgB;IACtE,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC;IAChC,MAAM,OAAO,GACX,OAAO,KAAK,QAAQ;QAClB,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,OAAO,KAAK,QAAQ;YACpB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,OAAO,KAAK,MAAM;gBAClB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,UAAU,CAAC;IAErB,MAAM,YAAY,GAChB,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAEjF,OAAO,+CAA+C,OAAO,gBAAgB,IAAI;;;;;;;;;;;;;;;;eAgBpE,YAAY;;4BAEC,YAAY;;;;;;;;;;;;;;;;2BAgBb,OAAO;;gBAElB,OAAO;;;;;;;;;;;;;;;;;;EAkBrB,OAAO,YAAY,IAAI;;;;;;;;;;;eAWV,OAAO,kBAAkB,OAAO;;;;;;;;WAQpC,OAAO;;;;;8DAK4C,OAAO;;;;qCAIhC,YAAY;;;;;WAKtC,OAAO;;;;sBAII,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BnB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEA8B2C,CAAC;AAClE,CAAC"}

package/dist/prompts/setup-new-app.d.ts

@@ -0,0 +1,2 @@
+export declare function generateSetupNewAppPrompt(appType: string, features?: string[]): string;
+//# sourceMappingURL=setup-new-app.d.ts.map

package/dist/prompts/setup-new-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-new-app.d.ts","sourceRoot":"","sources":["../../src/prompts/setup-new-app.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,EAAO,GACtB,MAAM,CAwOR"}