common-qa-mcp 0.1.0

package/dist/tools/recording.tools.js

@@ -0,0 +1,378 @@
+import { z } from 'zod';
+import { ok, err } from '../mcpResult.js';
+import { log } from '../log.js';
+/**
+ * Bridges the product MCP's AGENT-BOUND recording surface (recording_start, browser_*, verify_*,
+ * control_flow_marker, generate_test_steps, recording_steps/save/discard, ...) through the Common
+ * MCP, so the client drives recording through the ONE door instead of connecting to the agent
+ * directly. Common cannot implement these (they need the product's real browser); it FORWARDS each
+ * call verbatim via `adapter.callRaw` and relays the result.
+ *
+ * The set is mirrored DYNAMICALLY from the product's own advertised tools (real names + descriptions,
+ * so it never drifts), minus the provider-ops Common already wraps as its own client tools. It runs
+ * async once the connection is live; registerTool emits tools/list_changed so the client picks the
+ * proxies up (a /mcp reconnect also surfaces them).
+ *
+ * DELIBERATELY ROUGH (fix later, per plan): input schemas are permissive (the agent validates
+ * strictly) rather than mirrored exactly; and recording_save creates a draft in the AGENT's store,
+ * which Common's tc_save cannot see -- persisting a recorded test still needs a draft->tc_save bridge.
+ */
+/** Agent provider-ops Common already exposes as its own client tools -- NOT re-proxied. */
+const PROVIDER_OPS = new Set([
+    'info', 'list_projects', 'list_testcases', 'get_testcase', 'actions_catalog',
+    'create_testcase', 'update_testcase', 'list_cloud_runners', 'start_run', 'get_run', 'stop_run',
+]);
+/**
+ * The ONLY agent tools re-exposed to the client: the technology SUB-AGENT tools. Each is a DELEGATED
+ * sub-agent (goal in; its own LLM loop over internal browser + recording tools; a saved draft out).
+ * The granular tools (browser_*, recording_*, verify_*, store_run_variable, control_flow_marker,
+ * generate_test_steps, qa_select_technology, qa_technology_status) stay INTERNAL to the sub-agents on
+ * the product agent and are NOT proxied -- the client drives everything through web / android /
+ * mainframe / db plus the lifecycle provider-ops. This is the "one door, smartness downstream" surface.
+ */
+const TECHNOLOGY_SUBAGENTS = new Set(['web', 'android', 'mainframe', 'db']);
+/**
+ * The POLL half of a delegated recording. A delegated recorder is non-blocking — `web`/`mainframe`
+ * return a sessionId and record in the background — so its `*_status` tool is as much part of the
+ * client surface as the recorder itself, and each one needs the DRAFT BRIDGE (see
+ * registerDelegatedStatus). Without its status tool a technology can START a recording that can never
+ * be collected: the assembled draft stays in the AGENT's store, which Common's tc_save cannot see.
+ *
+ * Keep this in lockstep with the recorders in TECHNOLOGY_SUBAGENTS that are non-blocking. `android`
+ * and `db` are absent because they are still declared scaffolds with no delegated loop to poll.
+ */
+const DELEGATED_STATUS_TOOLS = new Set(['web_status', 'mainframe_status']);
+/** Permissive input: accept any object; the product MCP is the strict validator. */
+const PASSTHROUGH_INPUT = z.record(z.string(), z.unknown());
+/**
+ * Per-technology wording + extra input fields for the two delegated recorders. Everything else about
+ * them is identical (resolve nested refs up front, forward, poll, re-home the draft), which is why
+ * they share registerDelegatedRecorder / registerDelegatedStatus rather than each carrying a copy.
+ */
+const DELEGATED_RECORDERS = {
+    web: {
+        statusTool: 'web_status',
+        /** Extra fields beyond `task` + nestStart/nestEnd, forwarded verbatim to the agent. */
+        extraInput: {
+            url: z.string().optional().describe('Starting URL for the recording browser. STRONGLY recommended — the recording opens on this ' +
+                'page. If omitted, the agent uses the first URL found in the task.'),
+            profile: z.string().optional().describe('Persistent browser profile (cookies/localStorage). Omit for a fresh isolated profile per ' +
+                'recording (recommended — avoids browser-lock collisions); pass a name to REUSE a signed-in ' +
+                'profile across recordings.'),
+        },
+        taskDescribe: 'The GOAL in natural language, e.g. "Sign in at <url> as Admin/admin123, then verify the ' +
+            'Dashboard heading is visible." Include the app URL in the task.',
+        startNote: 'NON-BLOCKING: this STARTS the delegated web recording on the agent and returns a sessionId ' +
+            'immediately — a browser opens and records in the background. Then poll web_status({ sessionId }) ' +
+            'until status is "done"; web_status re-homes the draft HERE and returns a Common draftId that ' +
+            'tc_save can persist. Call web ONCE — do not retry it.',
+        doneLabel: 'Web recording complete.',
+    },
+    mainframe: {
+        statusTool: 'mainframe_status',
+        extraInput: {
+            appPath: z.string().optional().describe('Path to the TN3270 emulator SESSION FILE or its executable. The extension identifies the ' +
+                'emulator: `.ecf` = Quick3270, `.ws` = IBM Personal Communications, `.rd3x`/`.rd5x` = Micro ' +
+                'Focus Reflection. Launched before recording and becomes the "Launch ${app_path}" step 1, so ' +
+                'the test case replays from cold. Omit ONLY when the emulator is already open and you are ' +
+                'attaching to its live session. If you do not know the path, ASK THE USER for it — do not ' +
+                'search the filesystem.'),
+            attachOnly: z.boolean().optional().describe('Do not launch the emulator even though appPath was given — attach to the running one.'),
+        },
+        taskDescribe: 'The GOAL in natural language, e.g. "Log on to TSO as ANISHA/pass123, then run LISTUSER." ' +
+            'Include the real values the host needs — they are parameterized at assembly time.',
+        startNote: 'NON-BLOCKING: this STARTS the delegated mainframe recording on the agent and returns a sessionId ' +
+            'immediately — the emulator opens and records in the background. Then poll ' +
+            'mainframe_status({ sessionId }) until status is "done"; mainframe_status re-homes the draft HERE ' +
+            'and returns a Common draftId that tc_save can persist. Call mainframe ONCE — do not retry it: ' +
+            'the HLLAPI session admits one attachment, so mainframe recordings cannot overlap.',
+        doneLabel: 'Mainframe recording complete.',
+    },
+};
+/**
+ * Convert a product tool's JSON-Schema (object schema) into a Zod raw shape, so the PROXIED tool
+ * advertises the SAME named parameters (ref/expected/value/count/…) and required-ness to the client
+ * instead of an opaque permissive blob. Without this the client's model can't tell that, say,
+ * web_validate_text REQUIRES `expected`; it sends nothing, and the agent invokes a 1-arg method with
+ * 0 args ("Arguments length does not match"). Types are approximated (the product agent is the strict
+ * validator); the point is that the model knows WHICH args to send. Returns null when the schema is
+ * absent or not an object schema, so the caller falls back to the permissive record.
+ */
+function jsonSchemaToShape(schema) {
+    if (!schema || typeof schema !== 'object')
+        return null;
+    const s = schema;
+    if (s.type !== 'object' || !s.properties || typeof s.properties !== 'object')
+        return null;
+    const required = new Set(Array.isArray(s.required) ? s.required.map(String) : []);
+    const shape = {};
+    for (const [key, raw] of Object.entries(s.properties)) {
+        const p = (raw && typeof raw === 'object' ? raw : {});
+        let field;
+        switch (p.type) {
+            case 'string':
+                field = z.string();
+                break;
+            case 'number':
+                field = z.number();
+                break;
+            case 'integer':
+                field = z.number().int();
+                break;
+            case 'boolean':
+                field = z.boolean();
+                break;
+            case 'array':
+                field = z.array(z.unknown());
+                break;
+            case 'object':
+                field = z.record(z.string(), z.unknown());
+                break;
+            default: field = z.unknown();
+        }
+        if (typeof p.description === 'string')
+            field = field.describe(p.description);
+        if (!required.has(key))
+            field = field.optional();
+        shape[key] = field;
+    }
+    return Object.keys(shape).length ? shape : null;
+}
+export function registerRecordingPassthrough(server, deps) {
+    void (async () => {
+        const adapter = await waitForConnectedAdapter(deps, 12000);
+        if (!adapter?.listAgentTools || !adapter.callRaw)
+            return; // offline, or a product without passthrough
+        // Retry listAgentTools until the downstream product MCP is primed and advertising. At startup the
+        // Common connection can report "connected" (config present) BEFORE the product MCP's OWN connection
+        // is primed, so a single call races it, returns nothing, and the web/android/... tools never appear
+        // for the whole session (observed after a client reload). The first attempt also nudges the prime.
+        // Poll until we get a non-empty list, or give up after ~30s.
+        let tools = [];
+        const deadline = Date.now() + 30000;
+        while (Date.now() < deadline) {
+            try {
+                const a = deps.getAdapter();
+                if (a?.listAgentTools) {
+                    tools = await a.listAgentTools();
+                    if (tools.length)
+                        break;
+                }
+            }
+            catch { /* downstream not primed yet — retry */ }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        if (!tools.length) {
+            log('recording passthrough: no agent tools discovered (product MCP not ready within 30s)');
+            return;
+        }
+        // SimplifyQA-only behavior below (granular-verb proxying + real-schema preservation). Walnut keeps
+        // its EXACT prior surface, so this cannot affect Walnut. Evaluated once the connection is live.
+        const simplifyqa = deps.isSimplifyqa();
+        let proxied = 0;
+        for (const t of tools) {
+            if (PROVIDER_OPS.has(t.name))
+                continue;
+            // Two recording surfaces are proxied:
+            //  (a) WALNUT — the technology SUB-AGENT tools (web/android/mainframe/db) + `qa_technology_status`
+            //      (which LISTS the sub-agents + their availability, the way list_projects lists projects) +
+            //      every non-blocking recorder's own *_status tool. One delegated sub-agent per tech; its
+            //      granular browser_*/recording_*/verify_* tools stay INTERNAL to the agent's own loop.
+            //      The status tools come from DELEGATED_STATUS_TOOLS, NOT a hardcoded 'web_status':
+            //      `mainframe_status` is equally a client-surface tool, and it matches no core_*/web_* prefix,
+            //      so naming only web_status here would leave a started mainframe recording uncollectable.
+            //  (b) SIMPLIFYQA — the recorder is driven by the CLIENT's own LLM through GRANULAR verbs
+            //      (core_activate_technology, web_launch_application, web_snapshot, web_click, core_if,
+            //      core_loop, web_switch_*, …). Those ARE the interface here, so proxy every core_*/web_* verb
+            //      verbatim (the generic forward branch below) — SimplifyQA ONLY. Prefixes don't collide:
+            //      Walnut's single tool is exactly `web` (no underscore) and its internals use browser_/…
+            const isSubAgent = TECHNOLOGY_SUBAGENTS.has(t.name)
+                || t.name === 'qa_technology_status'
+                || DELEGATED_STATUS_TOOLS.has(t.name);
+            const isRecorderVerb = simplifyqa && (t.name.startsWith('core_') || t.name.startsWith('web_'));
+            if (!isSubAgent && !isRecorderVerb)
+                continue;
+            try {
+                // A delegated recorder + its status tool get the DRAFT BRIDGE, not a dumb forward: the
+                // recording assembles a test case into a draft in the AGENT's OWN store, which tc_save
+                // (Common's store) can't see. So we forward, then re-register the returned TestCase in
+                // Common's DraftStore and hand back a COMMON draftId — the only kind tc_save can persist.
+                const recorderCfg = DELEGATED_RECORDERS[t.name];
+                if (recorderCfg) {
+                    registerDelegatedRecorder(server, deps, t, recorderCfg);
+                    proxied++;
+                    continue;
+                }
+                const statusOwner = Object.values(DELEGATED_RECORDERS).find((c) => c.statusTool === t.name);
+                if (statusOwner) {
+                    registerDelegatedStatus(server, deps, t, statusOwner);
+                    proxied++;
+                    continue;
+                }
+                // SimplifyQA: preserve the agent's REAL parameter schema (ref/expected/value/count/…) so the
+                // client sends the right args (without it, web_validate_text's required `expected` is hidden →
+                // "Arguments length does not match"). Walnut keeps the permissive record exactly as before.
+                const shape = simplifyqa ? jsonSchemaToShape(t.inputSchema) : null;
+                server.registerTool(t.name, {
+                    description: `${t.description ?? t.name}\n\n(Agent-bound tool — runs on the connected product agent, forwarded through the Common MCP.)`,
+                    inputSchema: shape ?? PASSTHROUGH_INPUT,
+                }, async (args = {}) => {
+                    const a = deps.getAdapter();
+                    if (!a?.callRaw)
+                        return err('Not connected to a product agent — recording runs on the agent (qa_connect first).');
+                    try {
+                        return (await a.callRaw(t.name, args));
+                    }
+                    catch (e) {
+                        return err(e instanceof Error ? e.message : String(e));
+                    }
+                });
+                proxied++;
+            }
+            catch {
+                // Name already registered (a Common-native tool) -- skip rather than clobber.
+            }
+        }
+        log(`recording passthrough: proxied ${proxied} agent tool(s)`);
+    })();
+}
+/**
+ * Register a DELEGATED RECORDER (`web`, `mainframe`) with a REAL schema rather than the permissive
+ * passthrough: `task` is required, and the technology's own extra fields are surfaced so the caller is
+ * nudged to pass them (a web recording wants `url` so it starts on the real page instead of
+ * about:blank; a mainframe recording wants `appPath` so the emulator gets launched and step 1 is
+ * recorded).
+ *
+ * `nestStart`/`nestEnd` arrive here as test-case IDS but go DOWN as resolved `{ tcId, name }` refs —
+ * resolved up front so a bad id fails BEFORE a recording is wasted, and so the agent can compose the
+ * nesting INTO the session (making the live editor show, and its Save persist, the whole composition).
+ */
+function registerDelegatedRecorder(server, deps, t, cfg) {
+    server.registerTool(t.name, {
+        description: `${t.description ?? t.name}\n\n(${cfg.startNote})`,
+        inputSchema: {
+            task: z.string().min(1).describe(cfg.taskDescribe),
+            ...cfg.extraInput,
+            nestStart: z.array(z.string()).optional().describe('Existing test case ids to run BEFORE the recorded activity, as nested steps (e.g. a Login ' +
+                'test case). They are prepended to the produced draft in order — so the draft becomes ' +
+                '[nestStart…] → recorded activity → [nestEnd…]. Use this to reuse a login flow instead of ' +
+                're-recording it.'),
+            nestEnd: z.array(z.string()).optional().describe('Existing test case ids to run AFTER the recorded activity, as nested steps (e.g. a Logout ' +
+                'test case). They are appended to the produced draft in order.'),
+        },
+    }, 
+    // `args` is annotated rather than inferred: the schema above SPREADS cfg.extraInput, whose type is
+    // a union across the technologies, so the SDK cannot infer a single concrete arg shape (implicit
+    // any). Reading fields off a Record keeps this honest — the agent is the strict validator anyway.
+    async (args) => {
+        const a = deps.getAdapter();
+        if (!a?.callRaw)
+            return err('Not connected to a product agent — recording runs on the agent (qa_connect first).');
+        const rec = args ?? {};
+        const idsOf = (key) => Array.isArray(rec[key]) ? rec[key].map(String) : [];
+        let startRefs;
+        let endRefs;
+        try {
+            startRefs = await resolveNestedRefs(a, idsOf('nestStart'));
+            endRefs = await resolveNestedRefs(a, idsOf('nestEnd'));
+        }
+        catch (e) {
+            return err(e instanceof Error ? e.message : String(e));
+        }
+        // Forward `task` plus whichever of this technology's own fields the caller actually supplied.
+        // Driven off cfg.extraInput's keys so adding a field to the config is the only edit needed.
+        const agentArgs = { task: rec['task'] };
+        for (const key of Object.keys(cfg.extraInput)) {
+            if (rec[key] !== undefined)
+                agentArgs[key] = rec[key];
+        }
+        if (startRefs.length)
+            agentArgs['nestStart'] = startRefs;
+        if (endRefs.length)
+            agentArgs['nestEnd'] = endRefs;
+        // NON-BLOCKING: the agent returns a sessionId immediately (recording runs in the background), so
+        // this returns in ms — no long-blocking RPC, no client-timeout-driven retries, no duplicate
+        // browser/emulator. The draft is re-homed later, on the status tool's "done".
+        try {
+            return (await a.callRaw(t.name, agentArgs));
+        }
+        catch (e) {
+            return err(e instanceof Error ? e.message : String(e));
+        }
+    });
+}
+/**
+ * Register a delegated recorder's POLL tool (`web_status`, `mainframe_status`) — and with it THE DRAFT
+ * BRIDGE. While the recording is running the downstream result is forwarded verbatim; on "done" the
+ * agent's assembled TestCase is re-registered in COMMON's DraftStore, because that is the only store
+ * `tc_save` can read. Without this hop a finished recording would be visible but unsaveable.
+ */
+function registerDelegatedStatus(server, deps, t, cfg) {
+    const starter = t.name.replace(/_status$/, '');
+    server.registerTool(t.name, {
+        description: `${t.description ?? t.name}\n\n(Poll a recording started by ${starter}(). While it reports ` +
+            `"recording", poll again. On "done" this re-homes the assembled draft into Common's store and ` +
+            `returns a Common draftId — review the steps, then tc_save({ draftId }) to persist.)`,
+        inputSchema: { sessionId: z.string().describe(`The sessionId returned by ${starter}().`) },
+        annotations: { readOnlyHint: true },
+    }, async (args) => {
+        const a = deps.getAdapter();
+        if (!a?.callRaw)
+            return err('Not connected to a product agent — recording runs on the agent (qa_connect first).');
+        let res;
+        try {
+            res = (await a.callRaw(t.name, { sessionId: args.sessionId }));
+        }
+        catch (e) {
+            return err(e instanceof Error ? e.message : String(e));
+        }
+        if (res.isError)
+            return res; // recording error — forward verbatim
+        const sc = res.structuredContent;
+        if (sc?.status !== 'done' || !sc.tc)
+            return res; // still recording → forward as-is
+        const draftId = deps.drafts.create(sc.tc);
+        const stored = deps.drafts.get(draftId).tc;
+        const stepCount = Array.isArray(stored.steps) ? stored.steps.length : (sc.stepCount ?? 0);
+        return ok(`${sc.summary ?? cfg.doneLabel}\n\nRegistered as draft ${draftId} ` +
+            `(${stepCount} step${stepCount === 1 ? '' : 's'}). Persist it with ` +
+            `tc_save({ draftId: "${draftId}" }) — that saves it to Walnut and opens it in the Walnut UI.`, { status: 'done', draftId, tc: stored, stepCount, ...(sc.summary ? { summary: sc.summary } : {}) });
+    });
+}
+/**
+ * Resolve existing test-case ids to { tcId, name } refs for a delegated recorder to compose as nested
+ * steps DURING recording. Titles come from getTestCase, so a wrong id fails BEFORE a recording is
+ * wasted; the id is passed through as-is (function_call_data.test_case_id is a String — a business key
+ * TC_123 or a Mongo _id both persist). The agent builds the actual function steps in-session so the
+ * live editor renders + saves them.
+ */
+async function resolveNestedRefs(adapter, tcIds) {
+    const refs = [];
+    for (const id of tcIds) {
+        let name = id;
+        try {
+            const child = await adapter.getTestCase(id);
+            if (child?.title)
+                name = child.title;
+        }
+        catch {
+            throw new Error(`Cannot reuse test case "${id}" as a nested step — it was not found (check the id).`);
+        }
+        refs.push({ tcId: id, name });
+    }
+    return refs;
+}
+/** Poll until the shared connection is live and its adapter can enumerate the agent's tools. */
+async function waitForConnectedAdapter(deps, timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        if (deps.isConnected()) {
+            const a = deps.getAdapter();
+            if (a?.listAgentTools)
+                return a;
+        }
+        await new Promise((r) => setTimeout(r, 250));
+    }
+    return deps.isConnected() ? deps.getAdapter() : null;
+}
+//# sourceMappingURL=recording.tools.js.map

package/dist/tools/recording.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.tools.js","sourceRoot":"","sources":["../../src/tools/recording.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAI1C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC;;;;;;;;;;;;;;;GAeG;AAEH,2FAA2F;AAC3F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB;IAC5E,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU;CAC/F,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE3E,oFAAoF;AACpF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,GAAG,EAAE;QACH,UAAU,EAAE,YAAY;QACxB,uFAAuF;QACvF,UAAU,EAAE;YACV,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACjC,6FAA6F;gBAC3F,mEAAmE,CACtE;YACD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrC,2FAA2F;gBACzF,6FAA6F;gBAC7F,4BAA4B,CAC/B;SACF;QACD,YAAY,EACV,0FAA0F;YAC1F,iEAAiE;QACnE,SAAS,EACP,6FAA6F;YAC7F,mGAAmG;YACnG,+FAA+F;YAC/F,uDAAuD;QACzD,SAAS,EAAE,yBAAyB;KACrC;IACD,SAAS,EAAE;QACT,UAAU,EAAE,kBAAkB;QAC9B,UAAU,EAAE;YACV,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrC,2FAA2F;gBACzF,6FAA6F;gBAC7F,8FAA8F;gBAC9F,2FAA2F;gBAC3F,2FAA2F;gBAC3F,wBAAwB,CAC3B;YACD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACzC,uFAAuF,CACxF;SACF;QACD,YAAY,EACV,2FAA2F;YAC3F,mFAAmF;QACrF,SAAS,EACP,mGAAmG;YACnG,4EAA4E;YAC5E,mGAAmG;YACnG,gGAAgG;YAChG,mFAAmF;QACrF,SAAS,EAAE,+BAA+B;KAC3C;CACO,CAAC;AAEX;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,MAAe;IACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,CAAC,GAAG,MAAsE,CAAC;IACjF,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1F,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,KAAK,GAAiC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAqC,CAAC,EAAE,CAAC;QACjF,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAA8C,CAAC;QACnG,IAAI,KAAmB,CAAC;QACxB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,QAAQ;gBAAG,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBAAC,MAAM;YAC1C,KAAK,QAAQ;gBAAG,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBAAC,MAAM;YAC1C,KAAK,SAAS;gBAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;gBAAC,MAAM;YAChD,KAAK,SAAS;gBAAE,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;gBAAC,MAAM;YAC3C,KAAK,OAAO;gBAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAAC,MAAM;YACpD,KAAK,QAAQ;gBAAG,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAAC,MAAM;YACjE,OAAO,CAAC,CAAQ,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QACtC,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;YAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjD,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAcD,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,IAAwB;IACtF,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,EAAE,cAAc,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,CAAC,4CAA4C;QACtG,kGAAkG;QAClG,oGAAoG;QACpG,oGAAoG;QACpG,mGAAmG;QACnG,6DAA6D;QAC7D,IAAI,KAAK,GAAyF,EAAE,CAAC;QACrG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAM,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;oBACtB,KAAK,GAAG,MAAM,CAAC,CAAC,cAAc,EAAE,CAAC;oBACjC,IAAI,KAAK,CAAC,MAAM;wBAAE,MAAM;gBAC1B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,uCAAuC,CAAC,CAAC;YACnD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,GAAG,CAAC,qFAAqF,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,mGAAmG;QACnG,gGAAgG;QAChG,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YACvC,sCAAsC;YACtC,mGAAmG;YACnG,iGAAiG;YACjG,8FAA8F;YAC9F,4FAA4F;YAC5F,wFAAwF;YACxF,mGAAmG;YACnG,+FAA+F;YAC/F,0FAA0F;YAC1F,4FAA4F;YAC5F,mGAAmG;YACnG,8FAA8F;YAC9F,8FAA8F;YAC9F,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;mBAC9C,CAAC,CAAC,IAAI,KAAK,sBAAsB;mBACjC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,cAAc,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/F,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc;gBAAE,SAAS;YAC7C,IAAI,CAAC;gBACH,uFAAuF;gBACvF,uFAAuF;gBACvF,uFAAuF;gBACvF,0FAA0F;gBAC1F,MAAM,WAAW,GAAG,mBAAmB,CAAC,CAAC,CAAC,IAAwC,CAAC,CAAC;gBACpF,IAAI,WAAW,EAAE,CAAC;oBAChB,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;oBACxD,OAAO,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC5F,IAAI,WAAW,EAAE,CAAC;oBAChB,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;oBACtD,OAAO,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,6FAA6F;gBAC7F,+FAA+F;gBAC/F,4FAA4F;gBAC5F,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnE,MAAM,CAAC,YAAY,CACjB,CAAC,CAAC,IAAI,EACN;oBACE,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,iGAAiG;oBACxI,WAAW,EAAE,KAAK,IAAI,iBAAiB;iBACxC,EACD,KAAK,EAAE,OAAgC,EAAE,EAAE,EAAE;oBAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;oBAC5B,IAAI,CAAC,CAAC,EAAE,OAAO;wBAAE,OAAO,GAAG,CAAC,oFAAoF,CAAC,CAAC;oBAClH,IAAI,CAAC;wBACH,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAmB,CAAC;oBAC3D,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;oBACzD,CAAC;gBACH,CAAC,CACF,CAAC;gBACF,OAAO,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,8EAA8E;YAChF,CAAC;QACH,CAAC;QACD,GAAG,CAAC,kCAAkC,OAAO,gBAAgB,CAAC,CAAC;IACjE,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAMD;;;;;;;;;;GAUG;AACH,SAAS,yBAAyB,CAChC,MAAiB,EACjB,IAAwB,EACxB,CAAY,EACZ,GAAgB;IAEhB,MAAM,CAAC,YAAY,CACjB,CAAC,CAAC,IAAI,EACN;QACE,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,SAAS,GAAG;QAC/D,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;YAClD,GAAG,GAAG,CAAC,UAAU;YACjB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAChD,4FAA4F;gBAC1F,uFAAuF;gBACvF,2FAA2F;gBAC3F,kBAAkB,CACrB;YACD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,4FAA4F;gBAC1F,+DAA+D,CAClE;SACF;KACF;IACD,mGAAmG;IACnG,iGAAiG;IACjG,kGAAkG;IAClG,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,OAAO;YAAE,OAAO,GAAG,CAAC,oFAAoF,CAAC,CAAC;QAClH,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,CAAC,GAAW,EAAY,EAAE,CACtC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,GAAG,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,SAAgD,CAAC;QACrD,IAAI,OAA8C,CAAC;QACnD,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3D,OAAO,GAAG,MAAM,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,8FAA8F;QAC9F,4FAA4F;QAC5F,MAAM,SAAS,GAA4B,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9C,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,SAAS,CAAC,MAAM;YAAE,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM;YAAE,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QACnD,iGAAiG;QACjG,4FAA4F;QAC5F,8EAA8E;QAC9E,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAmB,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAC9B,MAAiB,EACjB,IAAwB,EACxB,CAAY,EACZ,GAAgB;IAEhB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,YAAY,CACjB,CAAC,CAAC,IAAI,EACN;QACE,WAAW,EACT,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,oCAAoC,OAAO,uBAAuB;YAC5F,+FAA+F;YAC/F,qFAAqF;QACvF,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,OAAO,KAAK,CAAC,EAAE;QAC1F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACpC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,OAAO;YAAE,OAAO,GAAG,CAAC,oFAAoF,CAAC,CAAC;QAClH,IAAI,GAAmB,CAAC;QACxB,IAAI,CAAC;YACH,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAG,IAAgC,CAAC,SAAS,EAAE,CAAC,CAAmB,CAAC;QAChH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,CAAC,qCAAqC;QAClE,MAAM,EAAE,GAAG,GAAG,CAAC,iBAC2F,CAAC;QAC3G,IAAI,EAAE,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC,EAAE,CAAC,EAAE;YAAE,OAAO,GAAG,CAAC,CAAC,kCAAkC;QACnF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;QAC1F,OAAO,EAAE,CACP,GAAG,EAAE,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,2BAA2B,OAAO,GAAG;YACjE,IAAI,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,qBAAqB;YACpE,uBAAuB,OAAO,+DAA+D,EAC/F,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACnG,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAAwB,EAAE,KAAe;IACxE,MAAM,IAAI,GAA0C,EAAE,CAAC;IACvD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,KAAK,EAAE,KAAK;gBAAE,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,uDAAuD,CAAC,CAAC;QACxG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,KAAK,UAAU,uBAAuB,CAAC,IAAwB,EAAE,SAAiB;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,cAAc;gBAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/dist/tools/run.tools.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ProviderAdapter } from '../adapters/types.js';
+/**
+ * The client-facing RUN surface: cloud_runners / tc_run / run_status / run_stop. Like the discovery
+ * tools these need a LIVE backend, so they read the current provider adapter per call via
+ * `deps.getAdapter()` and forward across the product hop. tc_run owns the local-vs-cloud DECISION
+ * policy (ask when unstated; refuse cloud when no runner is online) so every client behaves the same.
+ */
+export type RunToolsDeps = {
+    getAdapter: () => ProviderAdapter | null;
+};
+export declare function registerRunTools(server: McpServer, deps: RunToolsDeps): void;
+//# sourceMappingURL=run.tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.tools.d.ts","sourceRoot":"","sources":["../../src/tools/run.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC1C,CAAC;AA0BF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CA8O5E"}

package/dist/tools/run.tools.js

@@ -0,0 +1,230 @@
+import { z } from 'zod';
+import { ok, err } from '../mcpResult.js';
+const NOT_CONNECTED = 'Not connected to a product. Use qa_connect({ url, token, projectId }) first — running a test needs a live backend connection.';
+function describeError(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+function runnerLine(r) {
+    return `- ${r.online ? '🟢' : '⚪'} ${r.name} \`${r.id}\`${r.status ? ` (${r.status})` : ''}`;
+}
+/** Human summary of a run's status. For a SUITE run `children` carries the per-test-case rollup and
+ *  `progress` counts TEST CASES; a single test-case run has neither (progress counts steps). */
+function statusText(s) {
+    const unit = s.children ? 'test cases' : 'steps';
+    const prog = s.progress ? ` · ${s.progress.done}/${s.progress.total} ${unit}` : '';
+    const link = s.reportUrl ? `\n${s.reportUrl}` : '';
+    const icon = (state) => (state === 'passed' ? '✅' : state === 'failed' ? '❌' : state === 'running' ? '⏳' : '•');
+    const kids = s.children?.length
+        ? '\n\n' + s.children.map((c) => `- ${icon(c.state)} ${c.id}${c.title ? ` — ${c.title}` : ''} (${c.state})`).join('\n')
+        : '';
+    return `Run ${s.runId} · **${s.state}**${prog}${link}${kids}`;
+}
+export function registerRunTools(server, deps) {
+    server.registerTool('cloud_runners', {
+        title: 'List cloud runners (and which are online)',
+        description: 'List the cloud runner VMs registered to the connected project and which are online. Use this ' +
+            'to show the user the cloud options, or to pick a specific runner id for tc_run. Requires a live connection.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        const adapter = deps.getAdapter();
+        if (!adapter)
+            return err(NOT_CONNECTED);
+        if (!adapter.listCloudRunners)
+            return err('This product has no cloud runners.');
+        try {
+            const runners = await adapter.listCloudRunners();
+            const online = runners.filter((r) => r.online);
+            if (!runners.length)
+                return ok('No cloud runners are registered to this project.', { runners: [] });
+            const text = `${runners.length} cloud runner${runners.length === 1 ? '' : 's'} · ${online.length} online:\n\n` +
+                runners.map(runnerLine).join('\n');
+            return ok(text, { runners, online: online.length });
+        }
+        catch (e) {
+            return err(describeError(e));
+        }
+    });
+    server.registerTool('tc_run', {
+        title: 'Run a test case (local or cloud)',
+        description: 'Execute ONE existing test case in the connected product. `mode` decides WHERE it runs:\n' +
+            "  • 'local' — the connected agent's own browser\n" +
+            "  • 'cloud' — an online cloud runner VM\n" +
+            'IF THE USER HAS NOT SAID local or cloud, ASK THEM before calling — do not guess. When mode is ' +
+            'omitted this tool refuses with that instruction. For cloud, if no runner is online it reports that ' +
+            'there are no active cloud runners (nothing is run). Returns the run id — poll run_status for the result.',
+        inputSchema: {
+            tcId: z.string().describe('The test case id (or business key) to run.'),
+            mode: z.enum(['local', 'cloud']).optional().describe("Where to run. REQUIRED in practice — ask the user if unstated."),
+            environment: z.string().optional().describe('Environment id (Mongo id); a name is ignored and the project default is used.'),
+            browser: z.string().optional().describe("Browser, default 'chromium' (bundled + isolated). Others: 'chrome'/'msedge' (installed channel), 'firefox', 'webkit'."),
+            headless: z.boolean().optional().describe('Headless. Defaults: cloud=true, local=false.'),
+            cloudRunnerId: z.string().optional().describe('For cloud: a specific runner id (from cloud_runners). Omit to auto-pick an online one.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async ({ tcId, mode, environment, browser, headless, cloudRunnerId }) => {
+        const adapter = deps.getAdapter();
+        if (!adapter)
+            return err(NOT_CONNECTED);
+        if (!mode) {
+            return err("Specify where to run: call tc_run again with mode: 'local' or 'cloud'. " +
+                'If the user has not said which, ask them first — local runs on the connected agent, ' +
+                'cloud runs on an online cloud runner VM.');
+        }
+        let resolvedRunner;
+        if (mode === 'cloud') {
+            if (!adapter.listCloudRunners)
+                return err('This product has no cloud runners; run with mode: "local".');
+            let runners;
+            try {
+                runners = await adapter.listCloudRunners();
+            }
+            catch (e) {
+                return err(describeError(e));
+            }
+            const online = runners.filter((r) => r.online);
+            if (!online.length) {
+                return err('Currently there are no active cloud runners in your project.');
+            }
+            if (cloudRunnerId) {
+                resolvedRunner = online.find((r) => r.id === cloudRunnerId);
+                if (!resolvedRunner) {
+                    return err(`Cloud runner "${cloudRunnerId}" is not online. Online now:\n` + online.map(runnerLine).join('\n'));
+                }
+            }
+            else {
+                resolvedRunner = online[0]; // auto-pick the first online runner
+            }
+        }
+        const opts = {
+            mode,
+            ...(environment !== undefined ? { environment } : {}),
+            ...(browser !== undefined ? { browser } : {}),
+            ...(headless !== undefined ? { headless } : {}),
+            ...(resolvedRunner ? { cloudRunnerId: resolvedRunner.id } : {}),
+        };
+        try {
+            const run = await adapter.startRun({ tcId }, opts);
+            const where = mode === 'cloud'
+                ? `on cloud runner ${resolvedRunner ? `**${resolvedRunner.name}**` : ''}`
+                : 'locally on the connected agent';
+            return ok(`Started ${tcId} ${where}. Run id \`${run.runId}\` — poll run_status({ runId: "${run.runId}" }) for progress.`, { run, mode, ...(resolvedRunner ? { runner: resolvedRunner } : {}) });
+        }
+        catch (e) {
+            return err(describeError(e));
+        }
+    });
+    server.registerTool('suite_run', {
+        title: 'Run a test suite (local or cloud)',
+        description: 'Execute an existing test SUITE — all its member test cases, in order — in the connected product. ' +
+            '`mode` decides WHERE it runs:\n' +
+            "  • 'local' — the connected agent's own browser (always serial)\n" +
+            "  • 'cloud' — online cloud runner VM(s)\n" +
+            'IF THE USER HAS NOT SAID local or cloud, ASK THEM before calling — do not guess (this tool refuses ' +
+            'when mode is omitted). For cloud, if no runner is online it reports that there are no active cloud ' +
+            'runners (nothing is run). Returns the suite-run id — poll run_status for progress (it reports ' +
+            'per-test-case results under `children`) and run_stop to cancel.',
+        inputSchema: {
+            suiteId: z.string().describe('The suite id to run (from suite_list / suite_get).'),
+            mode: z.enum(['local', 'cloud']).optional().describe('Where to run. REQUIRED in practice — ask the user if unstated.'),
+            environment: z.string().optional().describe('Environment id (Mongo id); a name is ignored and the project default is used.'),
+            browser: z.string().optional().describe("Browser, default 'chromium'. Others: 'chrome'/'msedge', 'firefox', 'webkit'."),
+            headless: z.boolean().optional().describe('Headless. Defaults: cloud=true, local=false.'),
+            cloudRunnerId: z.string().optional().describe('For cloud: a specific runner id (from cloud_runners). Omit to auto-pick an online one.'),
+            strategy: z.enum(['serial', 'batch', 'dynamic']).optional().describe('Cloud dispatch order across the suite. Default serial; local is always serial.'),
+            maxConcurrent: z.number().int().positive().optional().describe('Cloud batch/dynamic only — max test cases running at once.'),
+            terminateOnFailure: z.boolean().optional().describe('Stop dispatching remaining test cases after the first failure.'),
+        },
+        annotations: { readOnlyHint: false },
+    }, async ({ suiteId, mode, environment, browser, headless, cloudRunnerId, strategy, maxConcurrent, terminateOnFailure }) => {
+        const adapter = deps.getAdapter();
+        if (!adapter)
+            return err(NOT_CONNECTED);
+        if (!mode) {
+            return err("Specify where to run: call suite_run again with mode: 'local' or 'cloud'. " +
+                'If the user has not said which, ask them first — local runs on the connected agent, ' +
+                'cloud runs on online cloud runner VM(s).');
+        }
+        let resolvedRunner;
+        if (mode === 'cloud') {
+            if (!adapter.listCloudRunners)
+                return err('This product has no cloud runners; run with mode: "local".');
+            let runners;
+            try {
+                runners = await adapter.listCloudRunners();
+            }
+            catch (e) {
+                return err(describeError(e));
+            }
+            const online = runners.filter((r) => r.online);
+            if (!online.length) {
+                return err('Currently there are no active cloud runners in your project.');
+            }
+            if (cloudRunnerId) {
+                resolvedRunner = online.find((r) => r.id === cloudRunnerId);
+                if (!resolvedRunner) {
+                    return err(`Cloud runner "${cloudRunnerId}" is not online. Online now:\n` + online.map(runnerLine).join('\n'));
+                }
+            }
+            else {
+                resolvedRunner = online[0]; // auto-pick the first online runner
+            }
+        }
+        const opts = {
+            mode,
+            ...(environment !== undefined ? { environment } : {}),
+            ...(browser !== undefined ? { browser } : {}),
+            ...(headless !== undefined ? { headless } : {}),
+            ...(resolvedRunner ? { cloudRunnerId: resolvedRunner.id } : {}),
+            ...(strategy !== undefined ? { strategy } : {}),
+            ...(maxConcurrent !== undefined ? { maxConcurrent } : {}),
+            ...(terminateOnFailure !== undefined ? { terminateOnFailure } : {}),
+        };
+        try {
+            const run = await adapter.startRun({ suiteId }, opts);
+            const where = mode === 'cloud'
+                ? `on cloud runner ${resolvedRunner ? `**${resolvedRunner.name}**` : ''}`
+                : 'locally on the connected agent';
+            return ok(`Started suite ${suiteId} ${where}. Run id \`${run.runId}\` — poll run_status({ runId: "${run.runId}" }) for progress.`, { run, mode, ...(resolvedRunner ? { runner: resolvedRunner } : {}) });
+        }
+        catch (e) {
+            return err(describeError(e));
+        }
+    });
+    server.registerTool('run_status', {
+        title: 'Get a run status',
+        description: 'Read the status of a run started by tc_run — state (queued/running/passed/failed/stopped/error), ' +
+            'step progress, and a link. Requires a live connection.',
+        inputSchema: { runId: z.string().describe('The run id returned by tc_run.') },
+        annotations: { readOnlyHint: true },
+    }, async ({ runId }) => {
+        const adapter = deps.getAdapter();
+        if (!adapter)
+            return err(NOT_CONNECTED);
+        try {
+            const status = await adapter.getRun(runId);
+            return ok(statusText(status), { run: status });
+        }
+        catch (e) {
+            return err(describeError(e));
+        }
+    });
+    server.registerTool('run_stop', {
+        title: 'Stop a run',
+        description: 'Signal a running execution to stop. Requires a live connection.',
+        inputSchema: { runId: z.string().describe('The run id to stop.') },
+        annotations: { readOnlyHint: false },
+    }, async ({ runId }) => {
+        const adapter = deps.getAdapter();
+        if (!adapter)
+            return err(NOT_CONNECTED);
+        try {
+            await adapter.stopRun(runId);
+            return ok(`Requested stop for run ${runId}.`);
+        }
+        catch (e) {
+            return err(describeError(e));
+        }
+    });
+}
+//# sourceMappingURL=run.tools.js.map