common-qa-mcp 0.1.0

package/dist/adapters/walnut/actionTypes.js

@@ -0,0 +1,141 @@
+import { WEB_ACTION_SIGNATURES } from '../../vendor/actionSignatures.js';
+/**
+ * Static per-technology action-type catalogs. Used as the whole `actionsCatalog()`
+ * answer for android/api/database/mainframe (there is no live/per-org source for
+ * those) and as the `web` fallback when the live per-org `GET /api/actions` catalog
+ * is unavailable (see `WalnutAdapter.actionsCatalog` in adapter.ts).
+ *
+ * Source (copied verbatim -- do not invent action names):
+ *  - web: walnut-mcp/modules/config/action_types.py, VALID_ACTION_TYPES (lines 12-36)
+ *    -- the 41 canonical action types mirroring the agent's registered Playwright
+ *    tool handlers.
+ *  - android: walnut-mcp/modules/config/platform_action_types.py,
+ *    ANDROID_ACTION_TYPES (lines 44-91) -- 75 Appium actions.
+ *  - api: walnut-mcp/modules/config/platform_action_types.py,
+ *    API_ACTION_TYPES (line 148).
+ *  - database: walnut-mcp/modules/config/platform_action_types.py,
+ *    DATABASE_ACTION_TYPES (line 220).
+ *  - mainframe: no frozenset for this platform exists in either source file --
+ *    left empty rather than guessed (spec §6A documents a Walnut-only mainframe
+ *    step_type, but platform_action_types.py has no corresponding action-type set).
+ */
+/**
+ * The walnut-mcp copy of the web catalog (41 types). Kept verbatim as its own const
+ * because it is a COPY of an external source; the live web catalog below unions it
+ * with the agent's own signature table instead of editing this list by hand.
+ */
+const WALNUT_MCP_WEB_ACTIONS = [
+    // Navigation
+    'navigate', 'navigate_back', 'go_forward', 'reload', 'close', 'tabs',
+    // Input
+    'click', 'dblclick', 'type', 'fill_form', 'select_option',
+    'press_key', 'tap', 'hover', 'focus', 'blur',
+    // Mouse coordinate
+    'mouse_click_xy', 'mouse_drag_xy', 'mouse_move_xy',
+    // Drag & Drop
+    'drag',
+    // File
+    'file_upload',
+    // Verification
+    'verify_element_visible', 'verify_text_visible', 'verify_value',
+    'verify_url_contains', 'verify_list_visible', 'verify_navigation',
+    // Wait
+    'wait_for_visible', 'wait_for_hidden', 'wait_for_navigation',
+    'wait_for_url', 'wait_for_attached', 'wait_for_detached', 'wait_timeout',
+    // Advanced
+    'evaluate', 'run_code', 'handle_dialog',
+    // Layout
+    'scroll', 'resize', 'pdf_save',
+    // API
+    'api_call',
+];
+/**
+ * The web catalog the validator and `actions_catalog` both answer from: the
+ * walnut-mcp copy UNIONED with every actionType the agent itself can bake
+ * (WEB_ACTION_SIGNATURES -- the same table the recorder fills descriptions from).
+ *
+ * Why the union rather than a longer hand-kept list: the copy above froze at 41
+ * types and the agent has since grown 12 more, so a recording that used any of
+ * them was reported as INVALID by our own validator -- `verify_compare` and
+ * `store_run_variable` are exposed MCP tools, and every draft containing one came
+ * back `validation ✗ -- actionType "verify_compare" not in catalog`. Deriving from
+ * the signature table means a future action the agent learns to bake is valid here
+ * the moment it has a signature, with no second list to remember.
+ */
+const WEB_ACTIONS = [
+    ...new Set([...WALNUT_MCP_WEB_ACTIONS, ...Object.keys(WEB_ACTION_SIGNATURES)]),
+];
+export const WALNUT_ACTIONS = {
+    web: WEB_ACTIONS,
+    android: [
+        // App lifecycle
+        'android_start_app', 'android_close_app', 'android_reset_app',
+        'android_install_app', 'android_uninstall_app', 'android_switch_app',
+        'android_is_app_installed',
+        // Interaction
+        'android_click', 'android_tap', 'android_longpress', 'android_type',
+        'android_clear', 'android_click_by_text', 'android_click_by_image',
+        'android_click_if_present', 'android_drag_drop',
+        'android_hide_keyboard', 'android_press_key',
+        'android_pinch_in', 'android_pinch_out',
+        // Scroll & Swipe
+        'android_scroll_to_element', 'android_scroll_to_text',
+        'android_scroll_to_top', 'android_scroll_to_bottom',
+        'android_scroll_left', 'android_scroll_right',
+        'android_scroll_to_element_and_click',
+        'android_scroll_until_element_gone', 'android_scroll_until_text_gone',
+        'android_swipe', 'android_swipe_by_direction',
+        // Navigation
+        'android_back', 'android_home', 'android_recent_apps',
+        'android_open_notification', 'android_switch_context',
+        'android_get_contexts', 'android_get_current_context',
+        // Verification
+        'android_validate_text', 'android_validate_partial_text',
+        'android_validate_by_text', 'android_validate_by_image',
+        'android_wait_for_element', 'android_wait_for_element_gone',
+        'android_wait_for_text', 'android_wait_for_text_gone',
+        'android_is_element_visible', 'android_is_element_enabled',
+        'android_is_element_checked', 'android_is_element_clickable',
+        'android_is_element_disabled', 'android_is_element_selected',
+        'android_is_element_not_visible', 'android_is_element_not_checked',
+        'android_is_element_not_selected',
+        // Data retrieval
+        'android_get_text', 'android_get_attribute',
+        // Device controls
+        'android_take_screenshot', 'android_snapshot',
+        'android_rotate_screen', 'android_device_info',
+        'android_lock', 'android_unlock', 'android_is_locked',
+        // Network
+        'android_wifi_status', 'android_toggle_wifi',
+        'android_data_status', 'android_toggle_data',
+        'android_bluetooth_status', 'android_toggle_bluetooth',
+        'android_airplane_mode_status',
+        // File operations
+        'android_push_file', 'android_pull_file',
+        // ADB
+        'android_adb_command', 'android_type_adb',
+    ],
+    api: ['api_call'],
+    database: ['database_query'],
+    mainframe: [],
+};
+/** Flattens a per-platform action-type catalog into `ActionDef[]`, tagging every entry. */
+export function actionDefsFrom(catalog) {
+    return Object.entries(catalog).flatMap(([platform, actionTypes]) => actionTypes.map((actionType) => ({ actionType, platform })));
+}
+// Precomputed once at module load -- every draft-tool validation call shares
+// these Sets rather than rebuilding them per call.
+const CATALOG_SETS = Object.fromEntries(Object.entries(WALNUT_ACTIONS).map(([platform, list]) => [platform, new Set(list)]));
+/**
+ * The single shared `catalogFor` callback every offline draft tool passes to
+ * `validateTestCase` -- no network, no adapter, just the static WALNUT_ACTIONS
+ * table above. Maps a neutral `Step.stepType` to its WALNUT_ACTIONS bucket;
+ * `control_flow` is exempted by `validateTestCase` itself before this is ever
+ * consulted, and a stepType with no offline vocabulary (`function`) yields an
+ * empty Set, which `validateTestCase` treats as "nothing to check" rather than
+ * "nothing is valid".
+ */
+export function offlineCatalogFor(step) {
+    return CATALOG_SETS[step.stepType] ?? new Set();
+}
+//# sourceMappingURL=actionTypes.js.map

package/dist/adapters/walnut/actionTypes.js.map

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

package/dist/adapters/walnut/mapper.d.ts

@@ -0,0 +1,34 @@
+import type { Step, TcSummary, TestCase } from '../../domain/types.js';
+export type CfKind = NonNullable<Step['controlFlow']>['kind'];
+export declare const WALNUT_TO_CF: Record<string, CfKind>;
+/** Inverse of WALNUT_TO_CF (neutral controlFlow.kind -> walnut action_type),
+ * derived once from the same table -- never maintained by hand. */
+export declare const CF_TO_WALNUT: Record<CfKind, string>;
+/**
+ * Maps one walnut wire `test_steps[]` entry (models/schemas.ts `step` schema shape)
+ * to a neutral `Step`. `toWalnutStep` (the write direction) lands in Task 6.
+ */
+export declare function fromWalnutStep(raw: any): Step;
+/**
+ * Maps a walnut `GET /api/test-cases/:id` response document (test-cases.ts:5125,
+ * TestCaseSchema-shaped) to the neutral `TestCase`. `toWalnutTc` (the write
+ * direction, exact payload shape the backend's zod schema accepts) lands in Task 6.
+ */
+export declare function fromWalnutTc(doc: any): TestCase;
+/** Maps one walnut `GET /api/test-cases` list-row (test-cases.ts:1746 `testCases[]`) to a `TcSummary`. */
+export declare function fromWalnutTcSummary(row: any): TcSummary;
+/**
+ * One neutral `Step` -> one walnut-frontend draft `test_steps[]` entry.
+ * `fromWalnutStep` above is the reverse (though it targets the backend wire
+ * shape, not this draft shape -- see the round-trip test in
+ * tests/unit/walnut.mapper.test.ts, which exercises both directions and only
+ * asserts on stepType/controlFlow.kind, the fields both shapes agree on).
+ */
+export declare function toWalnutStep(s: Step): Record<string, unknown>;
+/**
+ * Whole neutral TestCase -> the walnut-frontend draft payload's TestCase-level
+ * fields. `tc_draft_open` layers `draftId`/`mode` on top of this -- those
+ * describe the draft's hosting, not the test case itself.
+ */
+export declare function toWalnutTc(tc: TestCase): Record<string, unknown>;
+//# sourceMappingURL=mapper.d.ts.map

package/dist/adapters/walnut/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/adapters/walnut/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAK9D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM/C,CAAC;AAEF;mEACmE;AACnE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAErB,CAAC;AA0C5B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAqC7C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAoB/C;AAED,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAQvD;AA+CD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsC7D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOhE"}

package/dist/adapters/walnut/mapper.js

@@ -0,0 +1,228 @@
+// The single source of truth for control-flow action_type <-> kind. Exported (and
+// inverted into CF_TO_WALNUT below) so the forward direction never hand-writes a
+// second literal that could silently drift out of lockstep with this one.
+export const WALNUT_TO_CF = {
+    if_start: 'if',
+    else: 'else',
+    if_end: 'if_end',
+    while_start: 'while',
+    while_end: 'while_end',
+};
+/** Inverse of WALNUT_TO_CF (neutral controlFlow.kind -> walnut action_type),
+ * derived once from the same table -- never maintained by hand. */
+export const CF_TO_WALNUT = Object.fromEntries(Object.entries(WALNUT_TO_CF).map(([wire, kind]) => [kind, wire]));
+const KNOWN_STEP_TYPES = new Set([
+    'web', 'android', 'control_flow', 'function', 'database', 'mainframe',
+]);
+/**
+ * Walnut's wire uses upper-case `'API'` for API steps; the neutral model uses
+ * lower-case `'api'`. Any other recognized value passes through unchanged; an
+ * absent/unrecognized value defaults to `'web'` (mirrors the backend's own
+ * `step_type` schema default in models/schemas.ts).
+ */
+function normalizeStepType(raw) {
+    if (raw === 'API')
+        return 'api';
+    if (typeof raw === 'string' && KNOWN_STEP_TYPES.has(raw))
+        return raw;
+    return 'web';
+}
+function fromWalnutCondition(raw) {
+    if (!raw)
+        return undefined;
+    return {
+        type: raw.type,
+        selector: raw.selector ?? undefined,
+        objectId: raw.object_id ?? undefined,
+        text: raw.text ?? undefined,
+        variableName: raw.variableName ?? undefined,
+        variableValue: raw.variableValue ?? undefined,
+    };
+}
+function fromWalnutFlags(raw) {
+    const sla = raw.stepLevelActions;
+    const hasIsOptional = raw.is_optional !== undefined && raw.is_optional !== null;
+    if (!sla && !hasIsOptional)
+        return undefined;
+    return {
+        ...(sla
+            ? { skip: !!sla.skip, screenshot: !!sla.captureScreenshot, continueOnFailure: !!sla.continueOnFailure }
+            : {}),
+        ...(hasIsOptional ? { optional: !!raw.is_optional } : {}),
+    };
+}
+/**
+ * Maps one walnut wire `test_steps[]` entry (models/schemas.ts `step` schema shape)
+ * to a neutral `Step`. `toWalnutStep` (the write direction) lands in Task 6.
+ */
+export function fromWalnutStep(raw) {
+    const n = raw.step_number;
+    const description = raw.step_description ?? '';
+    const actionType = raw.action_type;
+    const expectedResult = raw.expected_result ?? undefined;
+    const flags = fromWalnutFlags(raw);
+    const cfKind = WALNUT_TO_CF[actionType];
+    if (cfKind) {
+        return {
+            n,
+            description,
+            actionType,
+            stepType: 'control_flow',
+            expectedResult,
+            controlFlow: {
+                kind: cfKind,
+                condition: fromWalnutCondition(raw.condition),
+                blockId: raw.block_id ?? undefined,
+                maxIterations: raw.max_iterations ?? undefined,
+            },
+            flags,
+        };
+    }
+    return {
+        n,
+        description,
+        actionType,
+        stepType: normalizeStepType(raw.step_type),
+        objectRef: raw.object_id != null ? { id: String(raw.object_id) } : undefined,
+        value: raw.input_value ?? undefined,
+        expectedResult,
+        api: raw.api_request_data ?? undefined,
+        db: raw.db_request_data ?? undefined,
+        flags,
+    };
+}
+/**
+ * Maps a walnut `GET /api/test-cases/:id` response document (test-cases.ts:5125,
+ * TestCaseSchema-shaped) to the neutral `TestCase`. `toWalnutTc` (the write
+ * direction, exact payload shape the backend's zod schema accepts) lands in Task 6.
+ */
+export function fromWalnutTc(doc) {
+    const id = doc.test_case_id ?? (doc._id != null ? String(doc._id) : undefined);
+    const category = doc.test_category === 'manual' || doc.test_category === 'playwright' ? doc.test_category : 'automated';
+    return {
+        id,
+        title: doc.title,
+        description: doc.description ?? undefined,
+        objective: doc.objective ?? undefined,
+        priority: doc.priority,
+        status: doc.status ?? undefined,
+        category,
+        preconditions: doc.preconditions ?? undefined,
+        expectedOutcome: doc.expected_outcome ?? undefined,
+        tags: doc.tags ?? [],
+        // Passthrough for Task 6's optimistic-concurrency PUT retry -- dropping this
+        // silently overwrites concurrent edits.
+        version: doc.version ?? undefined,
+        steps: (doc.test_steps ?? []).map(fromWalnutStep),
+    };
+}
+/** Maps one walnut `GET /api/test-cases` list-row (test-cases.ts:1746 `testCases[]`) to a `TcSummary`. */
+export function fromWalnutTcSummary(row) {
+    return {
+        id: row.test_case_id ?? String(row._id),
+        title: row.title,
+        priority: row.priority,
+        status: row.status ?? undefined,
+        stepCount: row.total_steps ?? undefined,
+    };
+}
+// ---------------------------------------------------------------------------
+// FORWARD direction: neutral -> walnut, for the offline draft hand-off.
+//
+// This is NOT the backend's persistence wire shape (`POST/PUT /api/test-cases`,
+// which uses `input_value`/`object_id` snake_case and lands with the write-side
+// WalnutAdapter in a later task). It is the exact shape walnut-frontend's real
+// TestStepsEditor consumes off the `/embed/test-case-draft#d=<payload>` URL
+// fragment -- reproduced here from scripts/open-in-walnut-editor.ts's hand-built
+// literal so there is one real implementation instead of a throwaway script and
+// a second hand-written literal drifting apart from it.
+// ---------------------------------------------------------------------------
+const PARAM_TOKEN = /\$\{([^}]+)\}/g;
+/** Every distinct `${name}` token in a step description, in first-seen order. */
+function detectParams(description) {
+    const found = [];
+    for (const m of (description ?? '').matchAll(PARAM_TOKEN)) {
+        const name = m[1];
+        if (!found.includes(name))
+            found.push(name);
+    }
+    return found;
+}
+/** Forward of fromWalnutCondition: neutral Condition -> walnut condition (object_id snake_case). */
+function toWalnutCondition(c) {
+    if (!c)
+        return undefined;
+    return {
+        type: c.type,
+        ...(c.selector !== undefined ? { selector: c.selector } : {}),
+        ...(c.objectId !== undefined ? { object_id: c.objectId } : {}),
+        ...(c.text !== undefined ? { text: c.text } : {}),
+        ...(c.variableName !== undefined ? { variableName: c.variableName } : {}),
+        ...(c.variableValue !== undefined ? { variableValue: c.variableValue } : {}),
+    };
+}
+/** Forward of fromWalnutFlags's stepLevelActions branch. `is_optional` is
+ * deliberately NOT emitted -- it never appears in the editor draft payload
+ * scripts/open-in-walnut-editor.ts models, only in the backend persistence
+ * wire shape (a different contract, out of scope here). */
+function toWalnutFlags(flags) {
+    return { skip: !!flags.skip, captureScreenshot: !!flags.screenshot, continueOnFailure: !!flags.continueOnFailure };
+}
+/**
+ * One neutral `Step` -> one walnut-frontend draft `test_steps[]` entry.
+ * `fromWalnutStep` above is the reverse (though it targets the backend wire
+ * shape, not this draft shape -- see the round-trip test in
+ * tests/unit/walnut.mapper.test.ts, which exercises both directions and only
+ * asserts on stepType/controlFlow.kind, the fields both shapes agree on).
+ */
+export function toWalnutStep(s) {
+    const cf = s.controlFlow;
+    const base = {
+        step_number: s.n,
+        step_type: s.stepType === 'api' ? 'API' : s.stepType,
+        action_type: cf ? CF_TO_WALNUT[cf.kind] : s.actionType,
+        step_description: s.description ?? '',
+        expected_result: s.expectedResult ?? '',
+    };
+    if (s.stepType === 'control_flow' && cf) {
+        const condition = toWalnutCondition(cf.condition);
+        return {
+            ...base,
+            ...(condition ? { condition } : {}),
+            ...(cf.blockId ? { block_id: cf.blockId } : {}),
+            ...(cf.maxIterations != null ? { max_iterations: cf.maxIterations } : {}),
+        };
+    }
+    const params = detectParams(s.description);
+    // Real recorded locator, when this step originated from a LIVE recording
+    // session (mcp/qa/tools/recording.tools.ts) rather than LLM-authored text --
+    // `objectRef.locators` is only ever populated in that path (see
+    // fromRecordedStep below). `element.locator_type`/`locator_value` is exactly
+    // the field walnut-frontend's TestStepsEditor `TestStep.element` reads
+    // (TestStepsEditor.tsx ~line 2007) -- prefer the locator flagged `unique`
+    // (the same selector Walnut's own replay ladder prioritizes), else the first.
+    const primaryLocator = s.objectRef?.locators?.find((l) => l.unique) ?? s.objectRef?.locators?.[0];
+    return {
+        ...base,
+        ...(s.value !== undefined ? { inputValue: s.value } : {}),
+        ...(params.length ? { parameterName: params[0], detected_parameters: params } : {}),
+        ...(s.api ? { api_request_data: s.api } : {}),
+        ...(s.flags ? { stepLevelActions: toWalnutFlags(s.flags) } : {}),
+        ...(s.objectRef?.id !== undefined ? { object_id: s.objectRef.id } : {}),
+        ...(primaryLocator ? { element: { locator_type: primaryLocator.name, locator_value: primaryLocator.value } } : {}),
+    };
+}
+/**
+ * Whole neutral TestCase -> the walnut-frontend draft payload's TestCase-level
+ * fields. `tc_draft_open` layers `draftId`/`mode` on top of this -- those
+ * describe the draft's hosting, not the test case itself.
+ */
+export function toWalnutTc(tc) {
+    return {
+        title: tc.title,
+        priority: tc.priority,
+        category: tc.category,
+        test_steps: tc.steps.map(toWalnutStep),
+    };
+}
+//# sourceMappingURL=mapper.js.map

package/dist/adapters/walnut/mapper.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * `common-qa-mcp` CLI — the published bin. Two jobs, Playwright-style:
+ *   • (default / `serve`)      run the Common QA MCP over stdio (what an AI client launches via npx)
+ *   • `init-agents --loop=<c>`  install the Walnut QA agent into your project for a given AI client
+ *
+ * stdout is the MCP transport in serve mode, so this file writes ONLY to stderr.
+ */
+import { startStdioServer } from './serve.js';
+import { runInitAgents } from './initAgents.js';
+function printUsage() {
+    process.stderr.write('common-qa-mcp — Common QA MCP\n\n' +
+        'Usage:\n' +
+        '  common-qa-mcp [serve]                  Start the MCP server over stdio (default; AI clients launch this)\n' +
+        '  common-qa-mcp init-agents --loop=<c>   Install the Walnut QA agent into this project\n' +
+        '                                         <c> = claude | cursor | windsurf | vscode | codex | all\n');
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const cmd = argv[0];
+    if (cmd === 'init-agents') {
+        await runInitAgents(argv.slice(1));
+        return;
+    }
+    if (cmd === undefined || cmd === 'serve') {
+        await startStdioServer();
+        return;
+    }
+    printUsage();
+    process.exitCode = cmd === 'help' || cmd === '--help' || cmd === '-h' ? 0 : 1;
+}
+main().catch((e) => {
+    process.stderr.write(`${e instanceof Error ? (e.stack ?? e.message) : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,SAAS,UAAU;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mCAAmC;QACjC,UAAU;QACV,8GAA8G;QAC9G,0FAA0F;QAC1F,oGAAoG,CACvG,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAC1B,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACzC,MAAM,gBAAgB,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,QAAQ,GAAG,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,81 @@
+type ConfigCommon = {
+    provider?: 'walnut' | 'simplifyqa';
+    customerId?: string;
+    moduleId?: string;
+    walnutAuth: 'key' | 'jwt';
+    caps: Set<string>;
+    port?: number;
+    connection?: string;
+    /** Origin of a running walnut-frontend, used by tc_draft_open to build the
+     * `/embed/test-case-draft` URL. Optional in both modes -- offline mode has no
+     * backend to derive one from, so this is the only source; connected mode may
+     * still want to point at a different UI host than the API origin.
+     *
+     * Also read by `recording_start` (mcp/qa/tools/recording.tools.ts) as an
+     * OVERRIDE: when set (env `QA_MCP_WALNUT_UI`), the live recording editor URL
+     * points at this deployed frontend's `/embed/test-case-draft` instead of the
+     * agent's own self-hosted `/editor` (the default when this is absent). */
+    walnutUiOrigin?: string;
+    /** Loopback base for the local Walnut agent, which can host the editor window.
+     * Only consulted by the standalone stdio dev harness (src/mcp/qa/index.ts) --
+     * when this tool surface is mounted in-process inside the agent itself (the
+     * product path, see src/mcp/qa/mount.ts), `tc_draft_open` calls the window
+     * opener directly and never reads this field. */
+    agentUrl?: string;
+};
+/**
+ * "No credentials at all" -- the deliberate, error-free mode this server boots
+ * into when QA_MCP_URL/TOKEN/PROJECT_ID are all absent (spec: author drafts and
+ * hand off to walnut-frontend's editor, no backend, no network). `url`/`token`/
+ * `projectId` may still be partially present here in principle, but resolveConfig
+ * never returns this shape in that case -- partial credentials are a
+ * misconfiguration and throw instead (see resolveConfig).
+ */
+export type OfflineQaConfig = ConfigCommon & {
+    mode: 'offline';
+    url?: string;
+    token?: string;
+    projectId?: string;
+};
+/** url + token present -- the shape a live ProviderAdapter is built from. `projectId` is OPTIONAL:
+ *  a session can be connected with NO project selected yet, and the user picks one at runtime
+ *  (list_projects -> qa_switch_project). Only list_projects works with no project; every other
+ *  project-scoped op asks the user to choose one first. */
+export type ConnectedQaConfig = ConfigCommon & {
+    mode: 'connected';
+    url: string;
+    token: string;
+    projectId?: string;
+};
+export type QaConfig = OfflineQaConfig | ConnectedQaConfig;
+/**
+ * Resolution order (spec §12): defaults -> ~/.common-qa-mcp/config.json
+ * (named connections; cliFlags.connection selects) -> QA_MCP_* env -> CLI flags.
+ * Each layer only overrides keys it actually sets.
+ *
+ * Credentials (url/token) are optional overall:
+ *  - BOTH url+token ABSENT -> OfflineQaConfig, no throw. The normal, supported way
+ *    to run with no backend at all (author drafts, hand off to the editor).
+ *  - ONE of url/token present but not the other -> misconfiguration, throws naming
+ *    the missing var.
+ *  - url+token present -> ConnectedQaConfig. projectId is OPTIONAL: absent means
+ *    "connected, no project selected yet" and the user chooses one at runtime.
+ * Never logs `token` -- callers must go through `mask()` from log.ts if they log
+ * config at all.
+ */
+export declare function resolveConfig(env: NodeJS.ProcessEnv, cliFlags?: Partial<QaConfig>): QaConfig;
+/**
+ * Best-effort provider auto-detect (spec §3: explicit config always wins over this).
+ * Runs both probes concurrently (never short-circuits) and only returns a provider when
+ * exactly one of them gives a confident match. Returns null on any ambiguity -- including
+ * ties -- so the caller surfaces `describeAmbiguousProvider` instead of guessing.
+ */
+export declare function detectProvider(url: string, fetchImpl?: typeof fetch): Promise<'walnut' | 'simplifyqa' | null>;
+/**
+ * The exact message a caller (the adapter factory, Task 5/6/11/12) should surface when
+ * `detectProvider` returns null -- spec §3: "on ambiguity, error asking for QA_MCP_PROVIDER".
+ * `detectProvider` itself never throws; this is a pure formatter for whoever does.
+ */
+export declare function describeAmbiguousProvider(url: string): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;IAC1B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;8EAQ0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;qDAIiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;2DAG2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAgH3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAyBhG;AA4BD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,QAAQ,GAAG,YAAY,GAAG,IAAI,CAAC,CAoBzC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7D"}