@e2edev/e2e 0.11.0 → 0.13.0

package/dist/mcp/catalog.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The catalog of a live session: every tool `call` can run, as AI SDK tools.
+ * `observe` shows the whole screen, the grammar is what the target's engine
+ * honors — `screenshot` and `tap_at` among it while pixels may leave the
+ * runner — `locate` tries a semantic locator the way a test would, and the
+ * project's own tools follow. Built-in
+ * names win: a project tool named like one is neither listed nor reachable,
+ * the precedence the testing agent's toolset applies.
+ */
+import type { ToolSet } from 'ai';
+import type { StepExecutor, StepExecutorContext } from '../agent/executor.ts';
+import type { ScreenPresenter } from '../agent/screen-update.ts';
+import type { LocatorExpression, SemanticNode, TargetSession } from '../engine/surface.ts';
+import type { LocatorEngine } from '../locator/engine.ts';
+/** True for a grammar tool name, whether or not this session's engine declares the verb: a missing one is not a typo. */
+export declare function isGrammarVerb(name: string): boolean;
+export interface SessionCatalog {
+    /** Every tool `call` can run, in the order `tools` lists them. */
+    readonly tools: ToolSet;
+    /** The tools that change nothing on the app. */
+    readonly readOnly: ReadonlySet<string>;
+}
+export interface CatalogOptions {
+    readonly context: StepExecutorContext;
+    readonly screen: ScreenPresenter;
+    readonly locator: LocatorEngine;
+    readonly session: TargetSession;
+    /** The configured executor, whose project tools are served when it came from `createAgent`. */
+    readonly executor: StepExecutor | undefined;
+    readonly warn: (message: string) => void;
+}
+/** Builds the session's catalog from the step context and the target. */
+export declare function createSessionCatalog(options: CatalogOptions): SessionCatalog;
+export interface LocateArgs {
+    readonly role?: string | undefined;
+    readonly name?: string | undefined;
+    readonly text?: string | undefined;
+    readonly label?: string | undefined;
+    readonly placeholder?: string | undefined;
+    readonly testId?: string | undefined;
+    readonly exact?: boolean | undefined;
+}
+export interface LocateQuery {
+    readonly expression: LocatorExpression;
+    readonly code: string;
+}
+/** Builds the expression and the matching `screen.*` call from the tool arguments. */
+export declare function locateQuery(args: LocateArgs): LocateQuery;
+/** Renders a locate result: the count, the verdict a test would get, and the nodes. */
+export declare function describeLocate(query: LocateQuery, count: number, nodes: readonly SemanticNode[]): string;
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/mcp/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGlC,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,yHAAyH;AACzH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAsB5E;AA2CD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAqBzD;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAQxG"}

package/dist/mcp/catalog.js

@@ -0,0 +1,141 @@
+/**
+ * The catalog of a live session: every tool `call` can run, as AI SDK tools.
+ * `observe` shows the whole screen, the grammar is what the target's engine
+ * honors — `screenshot` and `tap_at` among it while pixels may leave the
+ * runner — `locate` tries a semantic locator the way a test would, and the
+ * project's own tools follow. Built-in
+ * names win: a project tool named like one is neither listed nor reachable,
+ * the precedence the testing agent's toolset applies.
+ */
+import { z } from 'zod';
+import { isDefaultAgent, projectTools } from '../agent/default-agent.js';
+import { createGrammarTools, GRAMMAR_TOOL_NAMES } from '../agent/primitives.js';
+import { ConfigurationError } from '../internal/errors.js';
+import { describeExpression, roleQuery, testIdQuery, textQuery } from '../locator/expression.js';
+/** How many matching nodes `locate` describes. */
+const MAX_LOCATE_NODES = 10;
+/** True for a grammar tool name, whether or not this session's engine declares the verb: a missing one is not a typo. */
+export function isGrammarVerb(name) {
+    return GRAMMAR_TOOL_NAMES.has(name);
+}
+/** Builds the session's catalog from the step context and the target. */
+export function createSessionCatalog(options) {
+    const { context, screen } = options;
+    // The grammar's own observe reports a diff for the model loop; the
+    // session's shows the whole screen, so it replaces the grammar's.
+    const { observe: _diffObserve, ...verbs } = createGrammarTools(context, { screen });
+    const builtIn = {
+        observe: fullObserveTool(context, screen),
+        ...verbs,
+        locate: locateTool(options.locator, options.session),
+    };
+    const defined = isDefaultAgent(options.executor) ? options.executor.tools : {};
+    const readOnly = new Set(['observe', 'locate', 'screenshot']);
+    const project = {};
+    for (const [name, tool] of Object.entries(projectTools(context, defined))) {
+        if (name in builtIn) {
+            options.warn(`project tool "${name}" is not served over MCP: the name belongs to a built-in session tool`);
+            continue;
+        }
+        project[name] = tool;
+        if (defined[name]?.annotations.mutates === false)
+            readOnly.add(name);
+    }
+    return { tools: { ...builtIn, ...project }, readOnly };
+}
+/**
+ * The session's `observe`: the whole screen, every time. Action results
+ * report what changed since the screen the agent last received, as they do
+ * for the testing agent; a coding agent that asks to look wants everything,
+ * and the presenter takes that screen as the new baseline for later changes.
+ */
+function fullObserveTool(context, screen) {
+    return {
+        description: 'Look at the whole current screen: every node with its id, role, name, and state. Action results report only what changed since the screen you last received; call this to see everything again or after waiting for something in progress.',
+        inputSchema: z.object({}),
+        execute: async () => screen.initial(await context.observe()),
+    };
+}
+/** The session's `locate`: a semantic locator tried against the live screen, with the verdict a test would get. */
+function locateTool(locator, session) {
+    return {
+        description: 'Try a semantic locator against the live screen before writing it into a test: screen.getByRole(role, { name }), getByText, getByLabel, getByPlaceholder, or getByTestId. Returns how many nodes match and which, plus the test code to use. Exactly one of role, text, label, placeholder, or testId; name narrows a role query. Matching is exact unless exact is false.',
+        inputSchema: z.object({
+            role: z.string().min(1).optional().describe('ARIA role, e.g. "button", "textbox", "link"'),
+            name: z.string().min(1).optional().describe('Accessible name, with role'),
+            text: z.string().min(1).optional(),
+            label: z.string().min(1).optional(),
+            placeholder: z.string().min(1).optional(),
+            testId: z.string().min(1).optional(),
+            exact: z.boolean().optional().describe('false for substring, case-insensitive matching'),
+        }),
+        execute: async (args) => {
+            const query = locateQuery(args);
+            const refs = await locator.resolveAll(query.expression);
+            const read = [];
+            for (const ref of refs.slice(0, MAX_LOCATE_NODES)) {
+                read.push(await session.read(ref, locator.operation()));
+            }
+            return describeLocate(query, refs.length, read);
+        },
+    };
+}
+/** Builds the expression and the matching `screen.*` call from the tool arguments. */
+export function locateQuery(args) {
+    const exact = args.exact !== false;
+    const exactOption = exact ? '' : ', exact: false';
+    const { role, name, text, label, placeholder, testId } = args;
+    const given = [role, text, label, placeholder, testId].filter((value) => value !== undefined).length;
+    if (given !== 1) {
+        throw new ConfigurationError('INVALID_ARGUMENT', 'locate needs exactly one of role, text, label, placeholder, or testId');
+    }
+    if (role !== undefined) {
+        const options = name === undefined ? '' : `, { name: ${JSON.stringify(name)}${exactOption} }`;
+        return {
+            expression: roleQuery(role, name === undefined ? undefined : { name, exact }, undefined),
+            code: `screen.getByRole(${JSON.stringify(role)}${options})`,
+        };
+    }
+    if (name !== undefined)
+        throw new ConfigurationError('INVALID_ARGUMENT', 'name only narrows a role query');
+    if (testId !== undefined)
+        return { expression: testIdQuery(testId, undefined, undefined), code: `screen.getByTestId(${JSON.stringify(testId)})` };
+    const options = exact ? '' : `, { exact: false }`;
+    if (text !== undefined)
+        return { expression: textQuery('text', text, { exact }, undefined), code: `screen.getByText(${JSON.stringify(text)}${options})` };
+    if (label !== undefined)
+        return { expression: textQuery('label', label, { exact }, undefined), code: `screen.getByLabel(${JSON.stringify(label)}${options})` };
+    return { expression: textQuery('placeholder', placeholder, { exact }, undefined), code: `screen.getByPlaceholder(${JSON.stringify(placeholder)}${options})` };
+}
+/** Renders a locate result: the count, the verdict a test would get, and the nodes. */
+export function describeLocate(query, count, nodes) {
+    const lines = [`${count === 1 ? '1 node matches' : `${count} nodes match`} ${describeExpression(query.expression)}.`];
+    if (count === 1)
+        lines.push(`Use: ${query.code}`);
+    else if (count === 0)
+        lines.push('A test using this locator would fail with LOCATOR_NOT_FOUND. Check the accessible name in the observation (observe), or loosen the match with exact: false.');
+    else
+        lines.push(`A test action on ${query.code} would fail with LOCATOR_AMBIGUOUS. Narrow it with { name }, .filter({ hasText }), .first(), or .nth(i), or scope it under a container.`);
+    for (const node of nodes)
+        lines.push(`- ${describeNode(node)}`);
+    if (count > nodes.length)
+        lines.push(`- and ${count - nodes.length} more`);
+    return lines.join('\n');
+}
+/** A located node by what names it; located refs are not observation ids, so none is shown. */
+function describeNode(node) {
+    const parts = [node.role ?? 'node'];
+    if (node.name !== undefined && node.name !== '')
+        parts.push(JSON.stringify(node.name));
+    if (node.text !== undefined && node.text !== '' && node.text !== node.name)
+        parts.push(`text ${JSON.stringify(node.text)}`);
+    if (node.value !== undefined && node.states?.secure !== true)
+        parts.push(`value ${JSON.stringify(node.value)}`);
+    const states = Object.entries(node.states ?? {})
+        .filter(([, value]) => value === true)
+        .map(([key]) => key);
+    if (states.length > 0)
+        parts.push(`[${states.join(', ')}]`);
+    return parts.join(' ');
+}
+//# sourceMappingURL=catalog.js.map

package/dist/mcp/catalog.js.map

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

package/dist/mcp/config.d.ts

@@ -0,0 +1,11 @@
+/** A project the server serves: its config, loaded fresh on every use. */
+import { type ResolvedConfig } from '../config/resolve.ts';
+export interface ProjectOptions {
+    readonly cwd: string;
+    /** An explicit config file, relative to `cwd`; otherwise the nearest `e2e.config.ts` from `cwd` upward. */
+    readonly configPath?: string | undefined;
+    readonly env: NodeJS.ProcessEnv;
+}
+/** Loads a project's config fresh: an agent edits the config, or opens another project, while the server runs. */
+export declare function loadProjectConfig(options: ProjectOptions): Promise<ResolvedConfig>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAG1E,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2GAA2G;IAC3G,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACjC;AAED,kHAAkH;AAClH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CASxF"}

package/dist/mcp/config.js

@@ -0,0 +1,16 @@
+/** A project the server serves: its config, loaded fresh on every use. */
+import { discoverConfig, loadConfigModule, missingConfigError } from '../config/load.js';
+import { resolveConfig } from '../config/resolve.js';
+/** Loads a project's config fresh: an agent edits the config, or opens another project, while the server runs. */
+export async function loadProjectConfig(options) {
+    const discovered = discoverConfig(options.cwd, options.configPath);
+    if (discovered.configPath === undefined)
+        throw missingConfigError(options.cwd);
+    const raw = await loadConfigModule(discovered.configPath);
+    return resolveConfig(raw, {
+        projectRoot: discovered.projectRoot,
+        configPath: discovered.configPath,
+        env: options.env,
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/mcp/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAS1E,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAuB;IAC7D,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1D,OAAO,aAAa,CAAC,GAAG,EAAE;QACxB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The `e2e mcp` server: a live session on the app for a coding agent, with
+ * the skill as resources, served over one stdio transport. The tool list is
+ * four tools and never changes: the session's own vocabulary is a catalog
+ * behind `call`, so it follows the config the agent opens rather than the
+ * config the server started next to. Streams are injected, so the CLI hands
+ * it the process's and a test hands it pipes.
+ */
+import type { Readable, Writable } from 'node:stream';
+export interface ServeOptions {
+    readonly cwd: string;
+    /** The config every session loads unless `open_session` names one. */
+    readonly configPath?: string | undefined;
+    /** The target every session opens on; otherwise a call names one, or the only one is used. */
+    readonly target?: string | undefined;
+    readonly headed: boolean;
+    readonly env: NodeJS.ProcessEnv;
+    readonly version: string;
+    readonly stdin: Readable;
+    /** The protocol stream: nothing else may write to it. */
+    readonly stdout: Writable;
+    /** Diagnostics for the operator, normally stderr. */
+    readonly log: (line: string) => void;
+    /** Ends the server from outside: a process signal. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** Serves until the client disconnects or `signal` aborts; resolves with the exit code. */
+export declare function serveMcp(options: ServeOptions): Promise<number>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAStD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAQD,2FAA2F;AAC3F,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDrE"}

package/dist/mcp/server.js

@@ -0,0 +1,86 @@
+/**
+ * The `e2e mcp` server: a live session on the app for a coding agent, with
+ * the skill as resources, served over one stdio transport. The tool list is
+ * four tools and never changes: the session's own vocabulary is a catalog
+ * behind `call`, so it follows the config the agent opens rather than the
+ * config the server started next to. Streams are injected, so the CLI hands
+ * it the process's and a test hands it pipes.
+ */
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readGuide, skillTopics } from '../cli/skill.js';
+import { ConfigurationError, errorMessage } from '../internal/errors.js';
+import { loadProjectConfig } from './config.js';
+import { SessionHost } from './session.js';
+import { errorResult } from './tools.js';
+const INSTRUCTIONS = `e2e is a local-first end-to-end test runner; this server drives an e2e project's app (its e2e.config.ts) live.
+Call open_session (optionally with a target and a config path) to get a session, its tool catalog, and the first observation. Then call {tool, args} runs any catalog tool: observe, tap, type, press, select, scroll, navigate, type_secret, locate, screenshot, and the project's own tools; tools lists them, tools {tool} shows one tool's arguments. close_session when done.
+Write deterministic tests (tests/*.e2e.ts) from what you saw and run them with the CLI: npx e2e run <file>. Resources e2e://guide and e2e://guide/{topic} hold the writing guide.`;
+/** Serves until the client disconnects or `signal` aborts; resolves with the exit code. */
+export async function serveMcp(options) {
+    const server = new McpServer({ name: 'e2e', title: 'e2e', version: options.version }, { capabilities: { logging: {}, tools: {}, resources: {} }, instructions: INSTRUCTIONS });
+    const log = (level, message) => {
+        options.log(`[${level}] ${message}`);
+        if (server.isConnected())
+            void server.sendLoggingMessage({ level, logger: 'e2e', data: message }).catch(() => undefined);
+    };
+    const host = new SessionHost({
+        loadConfig: (configPath) => loadProjectConfig({ cwd: options.cwd, configPath: configPath ?? options.configPath, env: options.env }),
+        env: options.env,
+        headed: options.headed,
+        defaultTarget: options.target,
+        log,
+    });
+    for (const spec of host.toolSpecs()) {
+        server.registerTool(spec.name, {
+            description: spec.description,
+            inputSchema: spec.inputSchema,
+            annotations: { readOnlyHint: spec.readOnly, openWorldHint: false },
+        }, async (args, extra) => {
+            // A failure is a result the agent can react to, never a protocol error.
+            try {
+                return await spec.call(args, { signal: extra.signal });
+            }
+            catch (cause) {
+                return errorResult(cause);
+            }
+        });
+    }
+    registerGuide(server);
+    const transport = new StdioServerTransport(options.stdin, options.stdout);
+    const closed = new Promise((resolve) => {
+        // The SDK's Server exposes a plain callback property, not an event target.
+        // oxlint-disable-next-line unicorn/prefer-add-event-listener
+        server.server.onclose = () => resolve();
+        options.signal?.addEventListener('abort', () => resolve(), { once: true });
+    });
+    await server.connect(transport);
+    log('info', `e2e mcp ${options.version} serving ${options.cwd}`);
+    await closed;
+    try {
+        const summary = await host.close('server shutdown');
+        if (summary !== 'No session is open.')
+            options.log(summary);
+    }
+    catch (cause) {
+        options.log(`session teardown failed: ${errorMessage(cause)}`);
+    }
+    await server.close().catch((cause) => options.log(`server close failed: ${errorMessage(cause)}`));
+    return 0;
+}
+/** The skill as resources, for clients that read context without a tool call. */
+function registerGuide(server) {
+    server.registerResource('guide', 'e2e://guide', { title: 'e2e guide', description: 'How to set up e2e, write tests, use agent steps, run the CLI, and read a failing run', mimeType: 'text/markdown' }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: 'text/markdown', text: readGuide(undefined) ?? 'The skill is not part of this installation.' }] }));
+    server.registerResource('guide-topic', new ResourceTemplate('e2e://guide/{topic}', {
+        list: async () => ({
+            resources: skillTopics().map((topic) => ({ uri: `e2e://guide/${topic}`, name: topic, mimeType: 'text/markdown' })),
+        }),
+    }), { title: 'e2e guide topic', description: `One topic of the guide: ${skillTopics().join(', ')}`, mimeType: 'text/markdown' }, async (uri, variables) => {
+        const topic = String(variables['topic']);
+        const text = readGuide(topic);
+        if (text === undefined)
+            throw new ConfigurationError('UNKNOWN_TOPIC', `unknown topic "${topic}"; topics: ${skillTopics().join(', ')}`);
+        return { contents: [{ uri: uri.href, mimeType: 'text/markdown', text }] };
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/session.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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 type { ResolvedConfig } from '../config/resolve.ts';
+import { type McpToolCallExtra, type McpToolResult, type McpToolSpec } from './tools.ts';
+export interface OpenSessionOptions {
+    /** The target to open; otherwise the server's `--target`, else the config's only target. */
+    readonly target?: string | undefined;
+    /** A config file to load instead of the server's default, relative to the server's directory. */
+    readonly config?: string | undefined;
+}
+export interface SessionHostOptions {
+    /** Loads a config fresh for each session, so an edited config applies without a restart; `configPath` overrides the server's default. */
+    readonly loadConfig: (configPath: string | undefined) => Promise<ResolvedConfig>;
+    readonly env: NodeJS.ProcessEnv;
+    readonly headed: boolean;
+    /** The target every session opens on, from `--target`; a call may still name one. */
+    readonly defaultTarget?: string | undefined;
+    readonly log: (level: 'info' | 'warning' | 'error', message: string) => void;
+    readonly idleMs?: number | undefined;
+    readonly ttlMs?: number | undefined;
+}
+/** Owns at most one live session and the fixed MCP tools that drive it. */
+export declare class SessionHost {
+    private readonly options;
+    private live;
+    private opening;
+    /** Why the previous session ended, for the error a call on a closed session gets. */
+    private lastEnd;
+    constructor(options: SessionHostOptions);
+    get isOpen(): boolean;
+    /** The server's tools: the same four whatever the project, the config, or the target. */
+    toolSpecs(): readonly McpToolSpec[];
+    /** Opens a session and returns its opening text: the summary, the catalog, and the first screen. */
+    open(options: OpenSessionOptions): Promise<string>;
+    /** Closes the live session, if any, and returns what happened. */
+    close(reason: string, session?: string): Promise<string>;
+    /** The session's catalog, or one tool's full contract. */
+    catalog(session: string | undefined, tool: string | undefined): string;
+    /** Runs one catalog tool inside the live session's step. */
+    call(session: string | undefined, name: string, args: Record<string, unknown>, extra: McpToolCallExtra): Promise<McpToolResult>;
+    private openSession;
+    /** Opens the app when the engine can navigate, then observes. */
+    private firstScreen;
+    private openingText;
+    private catalogLines;
+    private resolveTarget;
+    /** Every configured credential's password as a step secret, so `type_secret` can fill it. */
+    private secretParams;
+    private requireLive;
+    private wrongSession;
+    private unknownTool;
+    private touch;
+    /** Runs one tool body inside the live session's step. */
+    private run;
+    private openSpec;
+    private catalogSpec;
+    private callSpec;
+    private closeSpec;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/mcp/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,sBAAsB,CAAC;AAS3E,OAAO,EAA0E,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAwBjK,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,yIAAyI;IACzI,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,2EAA2E;AAC3E,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,OAAO,CAA8B;IAC7C,qFAAqF;IACrF,OAAO,CAAC,OAAO,CAAqB;IAEpC,YAA6B,OAAO,EAAE,kBAAkB,EAAI;IAE5D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,yFAAyF;IACzF,SAAS,IAAI,SAAS,WAAW,EAAE,CAElC;IAED,oGAAoG;IACpG,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAajD;IAED,kEAAkE;IAC5D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe7D;IAED,0DAA0D;IAC1D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQrE;IAED,4DAA4D;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAK9H;YAEa,WAAW;IA8EzB,iEAAiE;YACnD,WAAW;IAazB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;IAmBrB,6FAA6F;IAC7F,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,KAAK;IAWb,yDAAyD;IACzD,OAAO,CAAC,GAAG;IAQX,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,SAAS;CAWlB"}