common-qa-mcp 0.1.0

package/dist/serve.js

@@ -0,0 +1,37 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { buildServer } from './server.js';
+import { QaConnection } from './connection.js';
+import { DraftStore } from './drafts/store.js';
+import { createAdapter } from './adapters/factory.js';
+import { resolveConfig } from './config.js';
+import { log, mask } from './log.js';
+/**
+ * The PRODUCT stdio entry — what `common-qa-mcp` (or `common-qa-mcp serve`) runs when an AI client
+ * launches it over stdio (the npx path). Mirrors mount.ts's HTTP wiring (a live QaConnection so
+ * qa_connect works + a shared DraftStore so drafts survive across a session) but the transport is
+ * stdio and the connection is primed from the `QA_MCP_*` env the client passes in its mcp config —
+ * there are no HTTP headers over stdio. All logging goes to STDERR (log.ts); stdout is the MCP
+ * transport itself and must stay clean.
+ */
+export async function startStdioServer() {
+    const config = resolveConfig(process.env);
+    const connection = new QaConnection(config);
+    const server = buildServer({
+        adapter: createAdapter(config),
+        connection,
+        mode: config.mode,
+        drafts: new DraftStore(),
+        walnutUiOrigin: config.walnutUiOrigin,
+        agentUrl: config.agentUrl,
+        // No Electron window in the standalone CLI — tc_draft_open just returns the editor link.
+        openEditorWindow: async () => false,
+    });
+    await server.connect(new StdioServerTransport());
+    if (config.mode === 'offline') {
+        log('stdio server ready — offline (draft authoring only; set QA_MCP_URL / QA_MCP_TOKEN / QA_MCP_PROJECT_ID to connect)');
+    }
+    else {
+        log(`stdio server ready — product=${config.provider ?? 'walnut'} url=${config.url} project=${config.projectId} token=${mask(config.token)}`);
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,WAAW,CAAC;QACzB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC;QAC9B,UAAU;QACV,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,IAAI,UAAU,EAAE;QACxB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,yFAAyF;QACzF,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;KACpC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,mHAAmH,CAAC,CAAC;IAC3H,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,gCAAgC,MAAM,CAAC,QAAQ,IAAI,QAAQ,QAAQ,MAAM,CAAC,GAAG,YAAY,MAAM,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/I,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,29 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ProviderAdapter } from './adapters/types.js';
+import type { QaConnection } from './connection.js';
+import { DraftStore } from './drafts/store.js';
+import { ok, err } from './mcpResult.js';
+export { ok, err };
+/**
+ * Common QA MCP -- the product-neutral core. This is the STANDALONE build: it carries the API
+ * lifecycle surface (connection, projects, discovery, drafts, save-orchestration) that routes to a
+ * product adapter -- Walnut over REST, SimplifyQA over its own MCP. The browser-recording + live
+ * editor tools are agent-bound (they need a real browser/Electron window) and live in the Walnut
+ * agent, which mounts this same core with those extra deps injected.
+ *
+ * `| undefined` on the optional fields is deliberate (exactOptionalPropertyTypes): callers thread
+ * them through from other optional values, e.g. `walnutUiOrigin: config.walnutUiOrigin`.
+ */
+export type ServerDeps = {
+    adapter: ProviderAdapter | null;
+    /** The LIVE connection (mount.ts supplies one); tools read it per call so runtime qa_connect /
+     *  header-primed connections win over the startup adapter. */
+    connection?: QaConnection | undefined;
+    mode?: 'connected' | 'offline' | undefined;
+    drafts?: DraftStore | undefined;
+    walnutUiOrigin?: string | undefined;
+    agentUrl?: string | undefined;
+    openEditorWindow?: ((url: string, title: string) => Promise<boolean>) | undefined;
+};
+export declare function buildServer(deps: ServerDeps): McpServer;
+//# 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,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;kEAC8D;IAC9D,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnF,CAAC;AAIF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CA4EvD"}

package/dist/server.js

@@ -0,0 +1,76 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DraftStore } from './drafts/store.js';
+import { registerTestcaseTools } from './tools/testcase.tools.js';
+import { registerConnectionTools } from './tools/connection.tools.js';
+import { registerDiscoveryTools } from './tools/discovery.tools.js';
+import { registerRunTools } from './tools/run.tools.js';
+import { registerRecordingPassthrough } from './tools/recording.tools.js';
+import { ok, err } from './mcpResult.js';
+export { ok, err };
+const OFFLINE_TOOLS = ['actions_catalog', 'tc_draft_create', 'tc_draft_update', 'tc_draft_get', 'tc_draft_discard', 'tc_draft_open'];
+export function buildServer(deps) {
+    const server = new McpServer({ name: 'common-qa-mcp', version: '0.1.0' });
+    const drafts = deps.drafts ?? new DraftStore();
+    server.registerTool('project_info', {
+        description: 'Validate the configured connection and return provider, org/project and entity counts.',
+        inputSchema: {}, annotations: { readOnlyHint: true },
+    }, async () => {
+        // The live connection wins over startup state: the user may have connected/disconnected since
+        // boot (qa_connect or config headers), so reporting the boot-time mode would be wrong.
+        const live = deps.connection?.describe();
+        const adapter = deps.connection ? deps.connection.adapter() : deps.adapter;
+        const mode = live ? live.mode : deps.mode;
+        if (mode === 'offline') {
+            return ok('Offline: no backend connection, so nothing is persisted anywhere.\n\n' +
+                `Available offline: ${OFFLINE_TOOLS.join(', ')}.\n` +
+                'Author a draft with tc_draft_create / tc_draft_update and open it with tc_draft_open.\n\n' +
+                'To work with EXISTING test cases (list, read, modify, run), connect first:\n' +
+                '  qa_connect({ url: "https://<your-product>", token: "<token>", projectId: "<id>", product: "walnut" })', { mode: 'offline', availableTools: OFFLINE_TOOLS, ...(live ? { connection: live } : {}) });
+        }
+        if (!adapter)
+            return err('No provider configured. Use qa_connect, or set QA_MCP_URL/TOKEN/PROJECT_ID.');
+        try {
+            const info = await adapter.info();
+            return ok(`Connected: ${info.provider} · project ${info.projectName} (${info.projectId})`
+                + (live?.source === 'runtime-connect' ? ' · via qa_connect' : ' · from startup config'), { info, ...(live ? { connection: live } : {}) });
+        }
+        catch (e) {
+            return err(e instanceof Error ? e.message : String(e));
+        }
+    });
+    // Runtime connect/disconnect/switch -- only when the host wired a live connection (mount.ts does).
+    if (deps.connection)
+        registerConnectionTools(server, deps.connection);
+    registerTestcaseTools(server, {
+        drafts,
+        walnutUiOrigin: deps.walnutUiOrigin,
+        agentUrl: deps.agentUrl,
+        openEditorWindow: deps.openEditorWindow,
+        // tc_save persists a draft to the product via the current provider adapter (create/update),
+        // forwarded across the hop — same live-connection-wins rule as discovery.
+        getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
+    });
+    // Read side of the shared lifecycle contract (list_projects / tc_list / tc_get). Reads the current
+    // provider adapter per call -- the live connection wins over the startup adapter, like project_info.
+    registerDiscoveryTools(server, {
+        getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
+    });
+    // Run surface (cloud_runners / tc_run / run_status / run_stop) -- same live-connection-wins rule;
+    // the run is forwarded to the product MCP (local dispatches to the agent, cloud to a runner VM).
+    registerRunTools(server, {
+        getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
+    });
+    // Recording passthrough: mirror the product agent's browser-recording tools onto this server so
+    // the client records through the one door. Agent-bound + forwarded (see recording.tools.ts).
+    // Async + fire-and-forget: it waits for the connection, then registerTool emits list_changed.
+    registerRecordingPassthrough(server, {
+        getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
+        isConnected: () => deps.connection ? deps.connection.describe().mode === 'connected' : deps.mode === 'connected',
+        // SimplifyQA-only: gates the granular-verb proxying + real-schema preservation. Walnut unaffected.
+        isSimplifyqa: () => deps.connection?.config().provider === 'simplifyqa',
+        // Shared with the draft/save tools so a recorded draft bridged here is the SAME store tc_save reads.
+        drafts,
+    });
+    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":"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"}

package/dist/tools/connection.tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `qa_connect` / `qa_disconnect` / `qa_connection_status` -- the URL + token entry point.
+ *
+ * The product shape is: an AI client connects to this MCP and the USER hands it an app URL and a
+ * token, in conversation. Before this, credentials came only from `QA_MCP_URL`/`QA_MCP_TOKEN`/
+ * `QA_MCP_PROJECT_ID` read once at boot, so connecting -- or switching project or org -- meant
+ * restarting the agent. See recording/../connection.ts for what the holder does and does not do
+ * (memory only, never logged, validated before it is adopted).
+ *
+ * Offline authoring never needs any of this: recording, the live editor and drafts work with no
+ * connection at all, and that is the mode this server boots into.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { QaConnection } from '../connection.js';
+export declare function registerConnectionTools(server: McpServer, connection: QaConnection): void;
+//# sourceMappingURL=connection.tools.d.ts.map

package/dist/tools/connection.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.tools.d.ts","sourceRoot":"","sources":["../../src/tools/connection.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,GAAG,IAAI,CAkIzF"}

package/dist/tools/connection.tools.js

@@ -0,0 +1,106 @@
+/**
+ * `qa_connect` / `qa_disconnect` / `qa_connection_status` -- the URL + token entry point.
+ *
+ * The product shape is: an AI client connects to this MCP and the USER hands it an app URL and a
+ * token, in conversation. Before this, credentials came only from `QA_MCP_URL`/`QA_MCP_TOKEN`/
+ * `QA_MCP_PROJECT_ID` read once at boot, so connecting -- or switching project or org -- meant
+ * restarting the agent. See recording/../connection.ts for what the holder does and does not do
+ * (memory only, never logged, validated before it is adopted).
+ *
+ * Offline authoring never needs any of this: recording, the live editor and drafts work with no
+ * connection at all, and that is the mode this server boots into.
+ */
+import { z } from 'zod';
+import { ok, err } from '../mcpResult.js';
+export function registerConnectionTools(server, connection) {
+    server.registerTool('qa_connect', {
+        title: 'Connect to a Walnut app',
+        description: 'Point this MCP at a Walnut app so it can work with EXISTING test cases -- list them, read ' +
+            'their steps, modify them, and run them. Ask the user for their app URL and a token; do not ' +
+            'guess either. The token is a Walnut session JWT (then `projectId` is required, because the ' +
+            'token alone carries no project context) or an MCP API key (then pass auth:"key" and ' +
+            'projectId is optional -- a key is already project-scoped).\n\n' +
+            'The connection is VALIDATED before it is accepted (it fetches the project), so a wrong URL, ' +
+            'token or project fails here with the reason rather than surfacing later as a confusing ' +
+            'error, and a failed attempt leaves any working connection untouched. It is kept in memory ' +
+            'for as long as the agent runs and is never written to disk or logged.\n\n' +
+            'NOT needed to record a new test case: recording, the live editor and drafts work offline ' +
+            'with nothing configured.',
+        inputSchema: {
+            url: z.string().min(1).describe('App URL, e.g. "https://app.walnut.ai" or a self-hosted origin. Must start with http:// or https://.'),
+            token: z.string().min(1).describe('Bearer token: a Walnut session JWT, or an MCP API key.'),
+            projectId: z.string().optional().describe('Project id. REQUIRED with a JWT; optional with an API key.'),
+            auth: z.enum(['jwt', 'key']).optional().describe('Token kind. Default "jwt": sends Authorization + x-project-id. "key": sends Authorization only.'),
+            product: z.enum(['walnut', 'simplifyqa']).optional().describe('Which product to connect to. Default "walnut". Use "simplifyqa" and pass the SimplifyQA agent MCP\'s /mcp endpoint as `url` — the request is then routed through to the SimplifyQA MCP.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async ({ url, token, projectId, auth, product }) => {
+        const result = await connection.connect({
+            url,
+            token,
+            ...(projectId !== undefined ? { projectId } : {}),
+            ...(auth !== undefined ? { auth } : {}),
+            ...(product !== undefined ? { product } : {}),
+        });
+        if (!result.ok) {
+            return err(`Could not connect: ${result.error}\n\n` +
+                'Nothing changed — any previous connection is still in place. Check the URL is the APP ' +
+                'origin (not the API path), that the token is current, and that the project id belongs to ' +
+                'the same org as the token.');
+        }
+        const info = result.info;
+        return ok(`Connected to ${connection.describe().url} — project ${info?.projectName ?? '(unnamed)'} ` +
+            `(${info?.projectId ?? projectId ?? 'key-scoped'}).\n` +
+            'You can now list, read, modify and run existing test cases. Recording still works as before.', { connection: connection.describe(), info: result.info });
+    });
+    server.registerTool('qa_switch_project', {
+        title: 'Switch the connected project',
+        description: 'Switch to a different project on the SAME connection — reuses the current URL + token, so ' +
+            'you do NOT re-enter them. Pass the project id; if the user names a project, call ' +
+            'list_projects first to resolve the name to an id. Validated before it is adopted, so a bad ' +
+            'id leaves the current project in place.',
+        inputSchema: {
+            projectId: z.string().min(1).describe('The project id to switch to. Use list_projects to find it by name.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async ({ projectId }) => {
+        const result = await connection.switchProject(projectId);
+        if (!result.ok) {
+            return err(`Could not switch project: ${result.error}\n\nThe current project is unchanged.`);
+        }
+        const info = result.info;
+        return ok(`Switched to project ${info?.projectName ?? '(unnamed)'} (${info?.projectId ?? projectId}). ` +
+            'tc_list / tc_get now operate on this project.', { connection: connection.describe(), info: result.info });
+    });
+    server.registerTool('qa_connection_status', {
+        title: 'Show the current connection',
+        description: 'Report whether this MCP is connected to a Walnut app, which URL and project, how the ' +
+            'credentials arrived (startup config vs qa_connect), and whether a token is present. The ' +
+            'token value itself is never returned.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        const d = connection.describe();
+        if (d.mode === 'offline') {
+            return ok('Offline — no backend connection. Recording, the live editor and drafts all work; ' +
+                'listing, reading, modifying and running EXISTING test cases need qa_connect.', { connection: d });
+        }
+        return ok(`Connected to ${d.url} · project ${d.projectId || '(key-scoped)'} · auth ${d.auth} · ` +
+            `credentials from ${d.source === 'runtime-connect' ? 'qa_connect' : 'startup config'}`, { connection: d });
+    });
+    server.registerTool('qa_disconnect', {
+        title: 'Drop the connection',
+        description: 'Forget the runtime URL and token and fall back to whatever the agent started with (usually ' +
+            'nothing). Use it before connecting to a different app or project, or to stop this MCP ' +
+            'reaching a backend at all. Offline authoring is unaffected.',
+        inputSchema: {},
+        annotations: { readOnlyHint: false },
+    }, async () => {
+        connection.disconnect();
+        const d = connection.describe();
+        return ok(d.mode === 'offline'
+            ? 'Disconnected. No backend connection now — recording and drafts still work.'
+            : `Disconnected the runtime credentials; back to the startup connection (${d.url}).`, { connection: d });
+    });
+}
+//# sourceMappingURL=connection.tools.js.map

package/dist/tools/connection.tools.js.map

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

package/dist/tools/discovery.tools.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ProviderAdapter } from '../adapters/types.js';
+/**
+ * The read side of the shared, product-neutral lifecycle contract: `tc_list` and
+ * `tc_get`. Unlike the offline draft surface (testcase.tools.ts), these need a
+ * LIVE backend, so they read the current provider adapter per call via
+ * `deps.getAdapter()` -- the same product-routing seam project_info uses: whichever
+ * product the session is connected to (walnut today, sqa via its own MCP later)
+ * answers, and the tool shape is identical either way.
+ */
+export type DiscoveryToolsDeps = {
+    /** The live provider adapter for the current connection, or null when offline. */
+    getAdapter: () => ProviderAdapter | null;
+};
+export declare function registerDiscoveryTools(server: McpServer, deps: DiscoveryToolsDeps): void;
+//# sourceMappingURL=discovery.tools.d.ts.map

package/dist/tools/discovery.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.tools.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAK5D;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kFAAkF;IAClF,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC1C,CAAC;AAeF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAkaxF"}