@e2edev/e2e 0.11.0 → 0.13.0

package/dist/mcp/session.js

@@ -0,0 +1,319 @@
+/**
+ * The live session behind `e2e mcp`: one standalone attempt on one target
+ * with one interactive agent step open on it, driven by a coding agent
+ * through a fixed, four-tool surface. `open_session` loads the project's
+ * config and opens the attempt and the step; `tools` renders the session's
+ * catalog; `call` runs one catalog tool by name inside the step;
+ * `close_session` ends the step and tears the attempt down. The catalog is
+ * data, not registrations, so it follows the config and the target without a
+ * restart and the client's tool list never changes.
+ */
+import path from 'node:path';
+import { z } from 'zod';
+import { openInteractiveStep } from '../agent/interactive-step.js';
+import { ScreenPresenter } from '../agent/screen-update.js';
+import { credentials } from '../credentials.js';
+import { ConfigurationError, errorMessage } from '../internal/errors.js';
+import { uuidv7 } from '../internal/ids.js';
+import { LocatorEngine } from '../locator/engine.js';
+import { allocateAppPorts } from '../run/app-ports.js';
+import { openStandaloneAttempt } from '../run/standalone.js';
+import { createSessionCatalog, isGrammarVerb } from './catalog.js';
+import { catalogLine, defineMcpTool, describeToolDetail, invokeTool, textResult } from './tools.js';
+/** How long one session may live, whatever happens. */
+const SESSION_TTL_MS = 4 * 60 * 60 * 1000;
+/** A session nobody has touched for this long is closed, so no browser is left behind. */
+const SESSION_IDLE_MS = 30 * 60 * 1000;
+/** How long the attempt outlives its step, so a step that hit the TTL is still closed in order. */
+const CLOSE_GRACE_MS = 60 * 1000;
+const SESSION_INSTRUCTION = 'Interactive session: a coding agent drives the app over MCP.';
+/** Owns at most one live session and the fixed MCP tools that drive it. */
+export class SessionHost {
+    options;
+    live;
+    opening;
+    /** Why the previous session ended, for the error a call on a closed session gets. */
+    lastEnd;
+    constructor(options) {
+        this.options = options;
+    }
+    get isOpen() {
+        return this.live !== undefined;
+    }
+    /** The server's tools: the same four whatever the project, the config, or the target. */
+    toolSpecs() {
+        return [this.openSpec(), this.catalogSpec(), this.callSpec(), this.closeSpec()];
+    }
+    /** Opens a session and returns its opening text: the summary, the catalog, and the first screen. */
+    open(options) {
+        if (this.live !== undefined) {
+            return Promise.reject(new ConfigurationError('SESSION_OPEN', `session ${this.live.id} is already open on target "${this.live.target.name}"; use it, or close_session first`));
+        }
+        this.opening ??= this.openSession(options).finally(() => {
+            this.opening = undefined;
+        });
+        return this.opening;
+    }
+    /** Closes the live session, if any, and returns what happened. */
+    async close(reason, session) {
+        const live = this.live;
+        if (live === undefined)
+            return 'No session is open.';
+        if (session !== undefined && session !== live.id)
+            throw this.wrongSession(live, session);
+        this.live = undefined;
+        this.lastEnd = reason;
+        if (live.idleTimer !== undefined)
+            clearTimeout(live.idleTimer);
+        await live.step.end({ status: 'passed', summary: `session closed: ${reason}` });
+        const outcome = await live.step.done;
+        const cleanupErrors = await live.attempt.close();
+        live.abort.abort();
+        const lines = [`Session ${live.id} closed (${reason}); ${live.actions} tool calls ran.`];
+        if (outcome.error !== undefined)
+            lines.push(`The session step ended with: ${errorMessage(outcome.error)}`);
+        for (const error of cleanupErrors)
+            lines.push(`Cleanup: ${error.code}: ${error.message}`);
+        return lines.join('\n');
+    }
+    /** The session's catalog, or one tool's full contract. */
+    catalog(session, tool) {
+        const live = this.requireLive(session);
+        if (tool === undefined) {
+            return [`Session ${live.id} on target "${live.target.name}": ${Object.keys(live.catalog.tools).length} tools. Run one with call {tool, args}; tools {tool} shows a tool's arguments.`, ...this.catalogLines(live)].join('\n');
+        }
+        const found = live.catalog.tools[tool];
+        if (found === undefined)
+            throw this.unknownTool(live, tool);
+        return describeToolDetail(tool, found, live.catalog.readOnly.has(tool));
+    }
+    /** Runs one catalog tool inside the live session's step. */
+    call(session, name, args, extra) {
+        const live = this.requireLive(session);
+        const tool = live.catalog.tools[name];
+        if (tool === undefined)
+            throw this.unknownTool(live, name);
+        return this.run(live, () => invokeTool(name, tool, args, extra));
+    }
+    async openSession(options) {
+        // A session is its own run: a URL declared with port 0 gets a port here.
+        const config = await allocateAppPorts(await this.options.loadConfig(options.config));
+        const target = this.resolveTarget(config, options.target);
+        const ttlMs = this.options.ttlMs ?? SESSION_TTL_MS;
+        const abort = new AbortController();
+        const id = uuidv7();
+        let attempt;
+        let step;
+        try {
+            attempt = await openStandaloneAttempt({
+                config,
+                target,
+                headed: this.options.headed,
+                env: this.options.env,
+                signal: abort.signal,
+                timeoutMs: ttlMs + CLOSE_GRACE_MS,
+                artifactsRoot: path.join(config.projectRoot, '.e2e', 'artifacts'),
+                notice: (scope, message) => this.options.log('info', `${scope}: ${message}`),
+            });
+            // The coding agent is the brain: the step is driven from here, and the
+            // configured model stays out of the way.
+            const params = this.secretParams(config);
+            step = await openInteractiveStep(attempt.agentRuntime, {
+                instruction: SESSION_INSTRUCTION,
+                ...(params === undefined ? {} : { params }),
+                timeout: ttlMs,
+            });
+            const screen = new ScreenPresenter();
+            const catalog = createSessionCatalog({
+                context: step.context,
+                screen,
+                session: attempt.session,
+                executor: config.agent.executor,
+                locator: new LocatorEngine({
+                    session: attempt.session,
+                    budget: attempt.budget,
+                    runId: attempt.runId,
+                    attemptId: attempt.attemptId,
+                    actionTimeout: config.actionTimeout,
+                    assertionTimeout: config.assertionTimeout,
+                }),
+                warn: (message) => this.options.log('warning', message),
+            });
+            const live = {
+                id,
+                target,
+                configPath: config.configPath ?? options.config ?? 'e2e.config.ts',
+                attempt,
+                step,
+                screen,
+                catalog,
+                abort,
+                idleTimer: undefined,
+                actions: 0,
+            };
+            this.live = live;
+            this.lastEnd = undefined;
+            // A step that ends on its own (the TTL, a hard stop) ends the session.
+            void step.done.then(async (outcome) => {
+                if (this.live !== live)
+                    return;
+                const why = outcome.error === undefined ? 'the session step concluded' : errorMessage(outcome.error);
+                this.options.log('warning', `session ${id} ended: ${why}`);
+                await this.close(why);
+            });
+            this.touch(live);
+            return this.openingText(live, config, await this.firstScreen(live));
+        }
+        catch (cause) {
+            // Whatever failed after the attempt opened, the attempt is torn down:
+            // an engine or app process left behind would block the next session.
+            this.live = undefined;
+            await step?.end({ status: 'failed', summary: 'opening the session failed' }).catch(() => undefined);
+            await attempt?.close().catch(() => undefined);
+            abort.abort();
+            throw cause;
+        }
+    }
+    /** Opens the app when the engine can navigate, then observes. */
+    async firstScreen(live) {
+        const base = live.target.app.base?.href;
+        if (base !== undefined && live.step.context.target.verbs.has('navigate')) {
+            try {
+                await live.step.run((context) => context.actions.navigate(base));
+            }
+            catch (cause) {
+                return `Opening ${base} failed: ${errorMessage(cause)}\nUse navigate once the app is reachable.`;
+            }
+        }
+        const observation = await live.step.run((context) => context.observe());
+        return live.screen.initial(observation);
+    }
+    openingText(live, config, screen) {
+        const engine = live.target.engine;
+        const lines = [
+            `Session ${live.id} open on target "${live.target.name}" (platform ${live.target.platform}, engine ${engine === undefined ? 'none' : `${engine.name} ${engine.version}`}), ${this.options.headed ? 'headed' : 'headless'}; config ${live.configPath}.`,
+        ];
+        if (live.target.app.base !== undefined) {
+            lines.push(`App: ${live.target.app.base.href}; allowed origins: ${live.target.app.allowedOrigins.join(', ')}.`);
+        }
+        if (config.credentials.size > 0) {
+            const described = [...config.credentials.values()].map((credential) => `"${credential.name}" (username ${JSON.stringify(credential.username)})`);
+            lines.push(`Credentials: ${described.join(', ')}. Type the username with type; fill the password with type_secret and the credential name.`);
+        }
+        lines.push(`Tools (run one with call {tool, args}; tools {tool} shows a tool's arguments):`, ...this.catalogLines(live));
+        lines.push('Node ids ("n42") are valid only for the newest observation; every action reports what changed on screen, and observe shows the whole screen. Call close_session when you are done.');
+        return `${lines.join('\n')}\n\n${screen}`;
+    }
+    catalogLines(live) {
+        return Object.entries(live.catalog.tools).map(([name, tool]) => catalogLine(name, tool, live.catalog.readOnly.has(name)));
+    }
+    resolveTarget(config, requested) {
+        const name = requested ?? this.options.defaultTarget;
+        const names = config.targets.map((target) => target.name);
+        if (name !== undefined) {
+            const target = config.targets.find((candidate) => candidate.name === name);
+            if (target === undefined) {
+                throw new ConfigurationError('UNKNOWN_TARGET', `unknown target "${name}"; the config declares ${names.map((n) => `"${n}"`).join(', ')}`);
+            }
+            return target;
+        }
+        const [only] = config.targets;
+        if (only !== undefined && config.targets.length === 1)
+            return only;
+        if (only === undefined)
+            throw new ConfigurationError('INVALID_CONFIG', 'the config declares no targets');
+        throw new ConfigurationError('TARGET_REQUIRED', `the config declares several targets (${names.join(', ')}); pass target to open_session, or start e2e mcp --target <name>`);
+    }
+    /** Every configured credential's password as a step secret, so `type_secret` can fill it. */
+    secretParams(config) {
+        if (config.credentials.size === 0)
+            return undefined;
+        return Object.fromEntries([...config.credentials.keys()].map((name) => [name, credentials.user(name).password]));
+    }
+    requireLive(session) {
+        if (this.live === undefined) {
+            const previous = this.lastEnd === undefined ? '' : ` (the previous session ended: ${this.lastEnd})`;
+            throw new ConfigurationError('NO_SESSION', `no session is open; call open_session first${previous}`);
+        }
+        if (session !== undefined && session !== this.live.id)
+            throw this.wrongSession(this.live, session);
+        return this.live;
+    }
+    wrongSession(live, session) {
+        return new ConfigurationError('NO_SESSION', `session "${session}" is not open; the open session is ${live.id}`);
+    }
+    unknownTool(live, name) {
+        if (isGrammarVerb(name)) {
+            return new ConfigurationError('UNSUPPORTED_CAPABILITY', `tool "${name}" is not available in this session: the engine of target "${live.target.name}" declares no such action; tools lists what it can do`);
+        }
+        return new ConfigurationError('UNKNOWN_TOOL', `tool "${name}" is not available in this session; tools: ${Object.keys(live.catalog.tools).join(', ')}`);
+    }
+    touch(live) {
+        if (live.idleTimer !== undefined)
+            clearTimeout(live.idleTimer);
+        const idleMs = this.options.idleMs ?? SESSION_IDLE_MS;
+        live.idleTimer = setTimeout(() => {
+            if (this.live !== live)
+                return;
+            this.options.log('warning', `session ${live.id} idle for ${Math.round(idleMs / 60_000)} minutes; closing it`);
+            void this.close('idle timeout');
+        }, idleMs);
+        live.idleTimer.unref();
+    }
+    /** Runs one tool body inside the live session's step. */
+    run(live, body) {
+        this.touch(live);
+        live.actions += 1;
+        return live.step.run(body);
+    }
+    // --- the fixed tools ---
+    openSpec() {
+        return defineMcpTool({
+            name: 'open_session',
+            description: 'Open a live session on one target of an e2e project: loads the config, starts the app command the engine declares (if any), boots the engine (a browser, a simulator), opens the app URL, and returns the session id, the catalog of tools it can run, and the first observation. One session at a time. Then act with call and look with call {tool: "observe"}.',
+            inputSchema: z.object({
+                target: z.string().min(1).optional().describe('Target name from the config; required when the config declares several'),
+                config: z.string().min(1).optional().describe("Path to an e2e config file, relative to the server's directory; default: the nearest e2e.config.ts"),
+            }),
+            readOnly: false,
+            call: async (args) => textResult(await this.open(args)),
+        });
+    }
+    catalogSpec() {
+        return defineMcpTool({
+            name: 'tools',
+            description: "List the tools the open session can run through call: observe, the grammar its engine honors (tap, type, press, select, scroll, navigate, type_secret, and screenshot and tap_at while no secret has been filled), locate, and the project's own tools. With tool, shows that tool's full description and the JSON Schema of its arguments.",
+            inputSchema: z.object({
+                tool: z.string().min(1).optional().describe('A catalog tool name, for its full contract'),
+                session: z.string().min(1).optional().describe('Session id; defaults to the open session'),
+            }),
+            readOnly: true,
+            call: async (args) => textResult(this.catalog(args.session, args.tool)),
+        });
+    }
+    callSpec() {
+        return defineMcpTool({
+            name: 'call',
+            description: "Run one tool of the open session by name, with its arguments as an object: call {tool: \"tap\", args: {target: \"n42\"}}. The session's catalog (from open_session or tools) names the tools and their arguments. Actions report what changed on screen; node ids are valid only for the newest observation.",
+            inputSchema: z.object({
+                tool: z.string().min(1).describe('A catalog tool name, e.g. "observe", "tap", "locate", "screenshot"'),
+                args: z.record(z.string(), z.unknown()).optional().describe("The tool's arguments; omit for a tool without any"),
+                session: z.string().min(1).optional().describe('Session id; defaults to the open session'),
+            }),
+            readOnly: false,
+            call: (args, extra) => this.call(args.session, args.tool, args.args ?? {}, extra),
+        });
+    }
+    closeSpec() {
+        return defineMcpTool({
+            name: 'close_session',
+            description: 'Close the live session: end the attempt, dispose the engine, and stop the app processes the session started.',
+            inputSchema: z.object({
+                session: z.string().min(1).optional().describe('Session id; defaults to the open session'),
+            }),
+            readOnly: false,
+            call: async (args) => textResult(await this.close('closed by the agent', args.session)),
+        });
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/mcp/session.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The bridge from the agent's AI SDK tools to the MCP `call` tool. The
+ * testing agent's vocabulary (the grammar, the engine packs, the project's
+ * `defineTool` values) is a set of AI SDK tools: a description, a zod input
+ * schema, and an execute function. The server keeps its own tool list fixed
+ * and small, and serves that vocabulary as a catalog: `tools` renders it from
+ * the same descriptions and schemas the testing agent reads, and `call`
+ * validates the arguments against the schema, runs the tool, and renders its
+ * output in the MCP result envelope.
+ */
+import { type JSONSchema7, type ToolSet } from 'ai';
+import type { z } from 'zod';
+/** One MCP content part this server emits. */
+export type McpContent = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'image';
+    readonly data: string;
+    readonly mimeType: string;
+};
+/** The MCP tool result envelope, as the SDK's `CallToolResult` spells it. */
+export interface McpToolResult {
+    readonly content: McpContent[];
+    readonly isError?: boolean;
+    [key: string]: unknown;
+}
+/** What a tool body gets from the request. */
+export interface McpToolCallExtra {
+    readonly signal: AbortSignal;
+}
+/** What the server registers: the contract and the body of one of its fixed tools. */
+export interface McpToolSpec<Shape extends z.ZodRawShape = z.ZodRawShape> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<Shape>;
+    /** Hint for clients: a tool that changes nothing on the app or disk. */
+    readonly readOnly: boolean;
+    /** Runs the tool on validated arguments; a thrown error becomes an error result. */
+    call(args: z.infer<z.ZodObject<Shape>>, extra: McpToolCallExtra): Promise<McpToolResult>;
+}
+/** Declares one fixed tool with `call` typed from its `inputSchema`. */
+export declare function defineMcpTool<Shape extends z.ZodRawShape>(spec: McpToolSpec<Shape>): McpToolSpec<Shape>;
+export declare function textResult(text: string): McpToolResult;
+/**
+ * A failure as a tool result the agent can react to, never a protocol error:
+ * the code and message are what a test would have reported.
+ */
+export declare function errorResult(cause: unknown): McpToolResult;
+/**
+ * The JSON Schema of a tool's arguments, without the draft marker clients
+ * never need. A zod schema converts synchronously; a schema that only
+ * resolves lazily is shown as an open object rather than awaited, since the
+ * catalog is rendered inline.
+ */
+export declare function toolJsonSchema(tool: ToolSet[string]): JSONSchema7;
+/**
+ * One catalog line: the name, the argument names (`?` marks an optional
+ * one), the first sentence of the description, and the read-only mark.
+ * `- tap {target}: Tap or click one node.`
+ */
+export declare function catalogLine(name: string, tool: ToolSet[string], readOnly: boolean): string;
+/** The full contract of one tool: its description and the JSON Schema of its arguments. */
+export declare function describeToolDetail(name: string, tool: ToolSet[string], readOnly: boolean): string;
+/**
+ * Validates the arguments against the tool's own schema and runs it. The
+ * server's `call` tool takes any object, so this is where a wrong argument is
+ * caught, with the same message a model would get, before the tool runs.
+ */
+export declare function invokeTool(name: string, tool: ToolSet[string], args: Record<string, unknown>, extra: McpToolCallExtra): Promise<McpToolResult>;
+/**
+ * Renders a tool's output the way the tool renders it for a model: text as
+ * text, and a `toModelOutput` that yields file parts as images. Anything
+ * else is JSON, so a structured output is never lost.
+ */
+export declare function resultFromOutput(tool: ToolSet[string], output: unknown, input?: unknown): Promise<McpToolResult>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAY,KAAK,WAAW,EAAwC,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AACpG,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,sFAAsF;AACtF,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oFAAoF;IACpF,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1F;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAEvG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAEtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAGzD;AAKD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,WAAW,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAM1F;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAQjG;AAmBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAgDD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,GAAE,OAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAOjI"}

package/dist/mcp/tools.js

@@ -0,0 +1,179 @@
+/**
+ * The bridge from the agent's AI SDK tools to the MCP `call` tool. The
+ * testing agent's vocabulary (the grammar, the engine packs, the project's
+ * `defineTool` values) is a set of AI SDK tools: a description, a zod input
+ * schema, and an execute function. The server keeps its own tool list fixed
+ * and small, and serves that vocabulary as a catalog: `tools` renders it from
+ * the same descriptions and schemas the testing agent reads, and `call`
+ * validates the arguments against the schema, runs the tool, and renders its
+ * output in the MCP result envelope.
+ */
+import { asSchema } from 'ai';
+import { ConfigurationError, errorMessage, E2EError, isForeignE2EError } from '../internal/errors.js';
+/** Declares one fixed tool with `call` typed from its `inputSchema`. */
+export function defineMcpTool(spec) {
+    return spec;
+}
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+/**
+ * A failure as a tool result the agent can react to, never a protocol error:
+ * the code and message are what a test would have reported.
+ */
+export function errorResult(cause) {
+    const code = cause instanceof E2EError || isForeignE2EError(cause) ? `${cause.code}: ` : '';
+    return { content: [{ type: 'text', text: `${code}${errorMessage(cause)}` }], isError: true };
+}
+/** How much of a description the catalog shows per tool: its first sentence, bounded. */
+const CATALOG_SENTENCE_MAX = 160;
+/**
+ * The JSON Schema of a tool's arguments, without the draft marker clients
+ * never need. A zod schema converts synchronously; a schema that only
+ * resolves lazily is shown as an open object rather than awaited, since the
+ * catalog is rendered inline.
+ */
+export function toolJsonSchema(tool) {
+    const raw = asSchema(tool.inputSchema).jsonSchema;
+    if (typeof raw.then === 'function')
+        return { type: 'object' };
+    const { $schema: _draft, ...schema } = raw;
+    return schema;
+}
+/**
+ * One catalog line: the name, the argument names (`?` marks an optional
+ * one), the first sentence of the description, and the read-only mark.
+ * `- tap {target}: Tap or click one node.`
+ */
+export function catalogLine(name, tool, readOnly) {
+    const schema = toolJsonSchema(tool);
+    const required = new Set(schema.required ?? []);
+    const args = Object.keys(schema.properties ?? {}).map((key) => (required.has(key) ? key : `${key}?`));
+    const signature = args.length === 0 ? name : `${name} {${args.join(', ')}}`;
+    return `- ${signature}: ${firstSentence(toolDescription(name, tool))}${readOnly ? ' [read-only]' : ''}`;
+}
+/** The full contract of one tool: its description and the JSON Schema of its arguments. */
+export function describeToolDetail(name, tool, readOnly) {
+    return [
+        `${name}${readOnly ? ' [read-only]' : ''}`,
+        toolDescription(name, tool),
+        '',
+        'Arguments (JSON Schema):',
+        JSON.stringify(toolJsonSchema(tool), null, 2),
+    ].join('\n');
+}
+function toolDescription(name, tool) {
+    return typeof tool.description === 'string' && tool.description !== '' ? tool.description : name;
+}
+/** Abbreviations whose period does not end a sentence. */
+const ABBREVIATIONS = /\b(?:e\.g|i\.e|etc|vs)\./gi;
+function firstSentence(text) {
+    const flat = text.replaceAll(/\s+/g, ' ').trim();
+    const guarded = flat.replaceAll(ABBREVIATIONS, (match) => match.replaceAll('.', '\u0000'));
+    const end = guarded.search(/[.!?](?:\s|$)/);
+    const sentence = (end === -1 ? guarded : guarded.slice(0, end + 1)).replaceAll('\u0000', '.');
+    if (sentence.length <= CATALOG_SENTENCE_MAX)
+        return sentence;
+    const cut = sentence.lastIndexOf(' ', CATALOG_SENTENCE_MAX - 1);
+    return `${sentence.slice(0, cut > 0 ? cut : CATALOG_SENTENCE_MAX - 1).replace(/[,;:]$/, '')}…`;
+}
+/**
+ * Validates the arguments against the tool's own schema and runs it. The
+ * server's `call` tool takes any object, so this is where a wrong argument is
+ * caught, with the same message a model would get, before the tool runs.
+ */
+export async function invokeTool(name, tool, args, extra) {
+    if (tool.execute === undefined) {
+        throw new ConfigurationError('UNSUPPORTED_CAPABILITY', `tool "${name}" has no execute function`);
+    }
+    const input = await validateArgs(name, tool, args);
+    const options = {
+        toolCallId: `mcp-${Date.now().toString(36)}`,
+        messages: [],
+        abortSignal: extra.signal,
+        context: undefined,
+    };
+    return resultFromOutput(tool, await resolveOutput(await tool.execute(input, options)), input);
+}
+async function validateArgs(name, tool, args) {
+    const schema = asSchema(tool.inputSchema);
+    if (schema.validate === undefined)
+        return args;
+    const result = await schema.validate(args);
+    if (result.success)
+        return result.value;
+    throw new ConfigurationError('INVALID_ARGUMENT', `call ${name}: ${describeValidationError(result.error)}; tools {tool: ${JSON.stringify(name)}} shows its arguments`);
+}
+/**
+ * The issues a zod (or any standard schema) failure carries, one per line;
+ * else the message. The SDK types the failure as a plain `Error`, so the
+ * issues are probed on it and on its cause.
+ */
+function describeValidationError(error) {
+    const issues = issuesOf(error) ?? issuesOf(error.cause);
+    if (issues === undefined || issues.length === 0)
+        return errorMessage(error);
+    return issues
+        .map((issue) => {
+        const path = Array.isArray(issue.path) && issue.path.length > 0 ? `${issue.path.map(String).join('.')}: ` : '';
+        return `${path}${typeof issue.message === 'string' ? issue.message : 'invalid'}`;
+    })
+        .join('; ');
+}
+function issuesOf(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const issues = value.issues;
+    return Array.isArray(issues) ? issues : undefined;
+}
+/** An execute function may stream; the last value is the tool's output. */
+async function resolveOutput(value) {
+    if (value !== null && typeof value === 'object' && Symbol.asyncIterator in value) {
+        let last;
+        for await (const part of value)
+            last = part;
+        return last;
+    }
+    return value;
+}
+/**
+ * Renders a tool's output the way the tool renders it for a model: text as
+ * text, and a `toModelOutput` that yields file parts as images. Anything
+ * else is JSON, so a structured output is never lost.
+ */
+export async function resultFromOutput(tool, output, input = undefined) {
+    if (typeof output === 'string')
+        return textResult(output);
+    if (tool.toModelOutput !== undefined) {
+        const content = contentFromModelOutput(await tool.toModelOutput({ toolCallId: 'mcp', input, output }));
+        if (content !== undefined)
+            return { content };
+    }
+    return textResult(output === undefined ? 'Done.' : JSON.stringify(output, null, 2));
+}
+function contentFromModelOutput(output) {
+    switch (output.type) {
+        case 'text':
+        case 'error-text':
+            return [{ type: 'text', text: output.value }];
+        case 'json':
+        case 'error-json':
+            return [{ type: 'text', text: JSON.stringify(output.value, null, 2) }];
+        case 'content': {
+            const parts = [];
+            for (const part of output.value) {
+                if (part.type === 'text') {
+                    parts.push({ type: 'text', text: part.text });
+                }
+                else if (part.type === 'file' && part.data.type === 'data') {
+                    const data = typeof part.data.data === 'string' ? part.data.data : Buffer.from(new Uint8Array(part.data.data)).toString('base64');
+                    parts.push({ type: 'image', data, mimeType: part.mediaType });
+                }
+            }
+            return parts.length === 0 ? undefined : parts;
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/report/build.d.ts

@@ -163,6 +163,8 @@ export interface ReportSerialGroup {
     titlePath: readonly string[];
     targetId: string;
     platform: string;
+    /** The configured agent this variant of the group ran as. */
+    agent: string;
     memberTestIds: readonly string[];
     status: SerialGroupRecord['status'];
     skip?: SkipInfo | undefined;
@@ -178,6 +180,12 @@ export interface ReportResult {
     source: ReportSource;
     targetId: string;
     platform: string;
+    /**
+     * The configured agent the test ran as. A test pinned to several agents,
+     * or a run with several `--agent` names, yields one result per agent, each
+     * with its own `id`.
+     */
+    agent: string;
     serialGroupId?: string | undefined;
     status: ResultRecord['status'];
     skip?: SkipInfo | undefined;