e2e 0.15.1 → 0.16.0

package/dist/internal/json-value.d.ts

@@ -12,4 +12,3 @@ export interface JsonValueRules {
 }
 /** Validates that a value is JSON-safe, throwing a labeled TestError otherwise. */
 export declare function validateJsonValue(value: unknown, label: string, rules?: JsonValueRules): void;
-//# sourceMappingURL=json-value.d.ts.map

package/dist/internal/json-value.js

@@ -58,4 +58,3 @@ export function validateJsonValue(value, label, rules = {}) {
     };
     visit(value);
 }
-//# sourceMappingURL=json-value.js.map

package/dist/internal/keys.d.ts

@@ -1,4 +1,3 @@
 /** The harness-side check of a `press` key against the contract's key grammar. */
 /** Throws `INVALID_ARGUMENT` for anything but a key in the grammar `parseKey` accepts. */
 export declare function requireKey(key: unknown): asserts key is string;
-//# sourceMappingURL=keys.d.ts.map

package/dist/internal/keys.js

@@ -9,4 +9,3 @@ export function requireKey(key) {
         `and one key joined by "+", where the key is a single character or one of ${KEY_NAMES.join(', ')} ` +
         '(for example "Enter", "Control+a", "Shift+Tab")');
 }
-//# sourceMappingURL=keys.js.map

package/dist/internal/node-version.d.ts

@@ -7,4 +7,3 @@
 export declare const MINIMUM_NODE_VERSION = "22.12.0";
 /** Explains an unsupported runtime, or undefined when `current` meets the floor. */
 export declare function unsupportedNodeMessage(current: string, minimum?: string): string | undefined;
-//# sourceMappingURL=node-version.d.ts.map

package/dist/internal/node-version.js

@@ -25,4 +25,3 @@ export function unsupportedNodeMessage(current, minimum = MINIMUM_NODE_VERSION)
     }
     return undefined;
 }
-//# sourceMappingURL=node-version.js.map

package/dist/internal/objects.d.ts

@@ -18,4 +18,3 @@ type PlainObject<T> = T extends readonly unknown[] ? never : T;
  */
 export declare function obj<T extends object>(value: PlainObject<T>): WithoutUndefined<T>;
 export {};
-//# sourceMappingURL=objects.d.ts.map

package/dist/internal/objects.js

@@ -11,4 +11,3 @@
 export function obj(value) {
     return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
 }
-//# sourceMappingURL=objects.js.map

package/dist/internal/options.d.ts

@@ -26,4 +26,3 @@ export declare function unknownKeyMessage(label: string, value: object, keys: re
  * for an argument a test passes.
  */
 export declare function rejectUnknownKeys(label: string, value: object, keys: readonly string[], code?: 'INVALID_CONFIG' | 'INVALID_ARGUMENT'): void;
-//# sourceMappingURL=options.d.ts.map

package/dist/internal/options.js

@@ -61,4 +61,3 @@ export function rejectUnknownKeys(label, value, keys, code = 'INVALID_CONFIG') {
         return;
     throw code === 'INVALID_CONFIG' ? new ConfigurationError(code, message) : new TestError(code, message);
 }
-//# sourceMappingURL=options.js.map

package/dist/internal/package-manager.d.ts

@@ -11,4 +11,3 @@ export declare function runScriptCommand(manager: PackageManager, name: string):
 export declare function execCommand(manager: PackageManager, command: string): string;
 /** The command that adds `name` as a dev dependency with the given manager. */
 export declare function addDevDependencyCommand(manager: PackageManager, name: string): string;
-//# sourceMappingURL=package-manager.d.ts.map

package/dist/internal/package-manager.js

@@ -66,4 +66,3 @@ export function addDevDependencyCommand(manager, name) {
             return `bun add -d ${name}`;
     }
 }
-//# sourceMappingURL=package-manager.js.map

package/dist/internal/package-version.d.ts

@@ -5,4 +5,3 @@
 export declare function packageVersion(fromUrl: string, specifier: string, fallback: string): string;
 /** Reads a JSON file through require resolution relative to the caller's module URL, or undefined when absent. */
 export declare function readJson(fromUrl: string, specifier: string): unknown;
-//# sourceMappingURL=package-version.d.ts.map

package/dist/internal/package-version.js

@@ -20,4 +20,3 @@ export function readJson(fromUrl, specifier) {
         return undefined;
     }
 }
-//# sourceMappingURL=package-version.js.map

package/dist/internal/paths.d.ts

@@ -20,4 +20,3 @@ export declare function realpathOfExisting(target: string): string;
 export declare function relativeToProjectRoot(projectRoot: string, target: string): string | undefined;
 /** Whether `target` is a path strictly below the project root; see `relativeToProjectRoot`. */
 export declare function insideProjectRoot(projectRoot: string, target: string): boolean;
-//# sourceMappingURL=paths.d.ts.map

package/dist/internal/paths.js

@@ -63,4 +63,3 @@ export function relativeToProjectRoot(projectRoot, target) {
 export function insideProjectRoot(projectRoot, target) {
     return relativeToProjectRoot(projectRoot, target) !== undefined;
 }
-//# sourceMappingURL=paths.js.map

package/dist/internal/realm-slot.d.ts

@@ -10,4 +10,3 @@ export interface RealmSlot<T> {
     delete(host: object): void;
 }
 export declare function realmSlot<T>(key: string | symbol): RealmSlot<T>;
-//# sourceMappingURL=realm-slot.d.ts.map

package/dist/internal/realm-slot.js

@@ -20,4 +20,3 @@ export function realmSlot(key) {
         },
     };
 }
-//# sourceMappingURL=realm-slot.js.map

package/dist/internal/recording-modes.d.ts

@@ -54,4 +54,3 @@ export declare function isRetryMode(mode: RecordingMode): boolean;
 export declare function attemptRecording(recording: ResolvedRecording, attemptIndex: number): AttemptRecording | undefined;
 /** Whether any attempt of a test with `retries` records under `mode`: what the engine has to be able to honour before the run starts. */
 export declare function recordsOnSomeAttempt(mode: RecordingMode, retries: number): boolean;
-//# sourceMappingURL=recording-modes.d.ts.map

package/dist/internal/recording-modes.js

@@ -48,4 +48,3 @@ export function attemptRecording(recording, attemptIndex) {
 export function recordsOnSomeAttempt(mode, retries) {
     return isRetryMode(mode) ? retries >= 1 : mode !== 'off';
 }
-//# sourceMappingURL=recording-modes.js.map

package/dist/internal/redact.d.ts

@@ -111,4 +111,3 @@ export declare class StreamRedactor {
     /** Redacts and returns whatever is held, an unfinished character included; nothing more will follow. */
     flush(): string;
 }
-//# sourceMappingURL=redact.d.ts.map

package/dist/internal/redact.js

@@ -548,4 +548,3 @@ export class StreamRedactor {
         return this.ledger.redact(text);
     }
 }
-//# sourceMappingURL=redact.js.map

package/dist/internal/regexp.d.ts

@@ -7,4 +7,3 @@ export declare function escapeRegexpChar(ch: string): string;
  * sticky/global state can never leak between matches.
  */
 export declare function testPattern(source: string, flags: string, input: string): boolean;
-//# sourceMappingURL=regexp.d.ts.map

package/dist/internal/regexp.js

@@ -24,4 +24,3 @@ export function testPattern(source, flags, input) {
     pattern.lastIndex = 0;
     return pattern.test(input);
 }
-//# sourceMappingURL=regexp.js.map

package/dist/internal/roles.d.ts

@@ -8,4 +8,3 @@ export declare function isEditable(node: Pick<SemanticNode, 'role'>): boolean;
  * told apart from a heading, which has no value at all, by its role.
  */
 export declare function isValueControl(node: Pick<SemanticNode, 'role'>): boolean;
-//# sourceMappingURL=roles.d.ts.map

package/dist/internal/roles.js

@@ -19,4 +19,3 @@ export function isEditable(node) {
 export function isValueControl(node) {
     return VALUE_ROLES.has(node.role ?? '');
 }
-//# sourceMappingURL=roles.js.map

package/dist/internal/skip.d.ts

@@ -38,4 +38,3 @@ export declare function parseSkipCall(first: unknown, second: unknown): SkipCall
  */
 export declare function skipRunningTest(condition: boolean, reason: string | undefined): void;
 export {};
-//# sourceMappingURL=skip.d.ts.map

package/dist/internal/skip.js

@@ -55,4 +55,3 @@ export function skipRunningTest(condition, reason) {
     }
     throw new RuntimeSkip(reason);
 }
-//# sourceMappingURL=skip.js.map

package/dist/internal/source.d.ts

@@ -29,4 +29,3 @@ export declare function projectRelativePath(projectRoot: string, file: string):
 export declare function userFrame(stack: string | undefined, projectRoot: string | undefined): StackFrame | undefined;
 /** The user's frame in a stack as the report keeps it: project-relative, POSIX; nothing when the stack named no project line. */
 export declare function sourceLocation(stack: string | undefined, projectRoot: string | undefined): SourceLocation | undefined;
-//# sourceMappingURL=source.d.ts.map

package/dist/internal/source.js

@@ -61,4 +61,3 @@ export function sourceLocation(stack, projectRoot) {
         return undefined;
     return { file: relative, line: Math.max(1, frame.line), column: Math.max(1, frame.column) };
 }
-//# sourceMappingURL=source.js.map

package/dist/internal/standard-schema.d.ts

@@ -4,4 +4,3 @@ import type { StandardSchemaV1 } from '../types.ts';
 export declare function requireStandardSchema(schema: unknown, label: string): asserts schema is StandardSchemaV1;
 /** One issue as `users.0.email: Invalid email`, or the bare message for an issue at the root. */
 export declare function describeIssue(issue: StandardSchemaV1.Issue): string;
-//# sourceMappingURL=standard-schema.d.ts.map

package/dist/internal/standard-schema.js

@@ -14,4 +14,3 @@ export function describeIssue(issue) {
         .join('.');
     return fieldPath === '' ? issue.message : `${fieldPath}: ${issue.message}`;
 }
-//# sourceMappingURL=standard-schema.js.map

package/dist/internal/suggest.d.ts

@@ -17,4 +17,3 @@ export declare function isTypoOf(word: string, candidate: string): boolean;
 export declare function didYouMean(word: string, candidates: readonly string[]): string;
 /** ` (did you mean x?)` for a note right after the word in a list, or the empty string. */
 export declare function suggestionNote(word: string, candidates: readonly string[]): string;
-//# sourceMappingURL=suggest.d.ts.map

package/dist/internal/suggest.js

@@ -74,4 +74,3 @@ function editDistance(a, b) {
     }
     return rows[a.length][b.length];
 }
-//# sourceMappingURL=suggest.js.map

package/dist/internal/text.d.ts

@@ -32,6 +32,8 @@ export interface TextComparison {
     readonly mode: 'equals' | 'contains';
     /** Whether both sides are whitespace-normalized first. `false` compares the raw strings, as a form control's value is. */
     readonly normalize: boolean;
+    /** Compares a string pattern case-insensitively. A RegExp reads case from its flags; `withIgnoreCase` sets them. */
+    readonly ignoreCase?: boolean | undefined;
 }
 /**
  * Matches normalized text against a pattern. String matching is exact by
@@ -46,6 +48,11 @@ export declare function matchesText(actual: string, pattern: TextPattern): boole
  * platform reports verbatim.
  */
 export declare function compareText(actual: string, pattern: TextPattern, comparison: TextComparison): boolean;
+/**
+ * The pattern under Playwright's `ignoreCase`: `true` adds a RegExp's `i`
+ * flag, `false` removes it, `undefined` keeps the flags it came with. A string
+ * pattern is returned as it is; `compareText` folds its case.
+ */
+export declare function withIgnoreCase(pattern: TextPattern, ignoreCase: boolean | undefined): TextPattern;
 /** Renders a pattern for diagnostics. */
 export declare function describePattern(pattern: TextPattern): string;
-//# sourceMappingURL=text.d.ts.map

package/dist/internal/text.js

@@ -63,7 +63,19 @@ export function compareText(actual, pattern, comparison) {
     const expected = comparison.normalize ? normalizeText(pattern.value) : pattern.value;
     if (!pattern.exact)
         return subject.toLowerCase().includes(expected.toLowerCase());
-    return comparison.mode === 'equals' ? subject === expected : subject.includes(expected);
+    const fold = (text) => (comparison.ignoreCase === true ? text.toLowerCase() : text);
+    return comparison.mode === 'equals' ? fold(subject) === fold(expected) : fold(subject).includes(fold(expected));
+}
+/**
+ * The pattern under Playwright's `ignoreCase`: `true` adds a RegExp's `i`
+ * flag, `false` removes it, `undefined` keeps the flags it came with. A string
+ * pattern is returned as it is; `compareText` folds its case.
+ */
+export function withIgnoreCase(pattern, ignoreCase) {
+    if (pattern.kind !== 'regexp' || ignoreCase === undefined)
+        return pattern;
+    const flags = pattern.flags.replace('i', '');
+    return { ...pattern, flags: normalizeRegexpFlags(ignoreCase ? `${flags}i` : flags) };
 }
 /** Renders a pattern for diagnostics. */
 export function describePattern(pattern) {
@@ -71,4 +83,3 @@ export function describePattern(pattern) {
         return JSON.stringify(pattern.value);
     return `/${pattern.source}/${pattern.flags}`;
 }
-//# sourceMappingURL=text.js.map

package/dist/internal/time.d.ts

@@ -53,4 +53,3 @@ export declare function withinCleanupBudget(promise: Promise<unknown>, budget: {
     readonly signal: AbortSignal;
     readonly timeoutMs: number;
 }): Promise<void>;
-//# sourceMappingURL=time.d.ts.map

package/dist/internal/time.js

@@ -151,4 +151,3 @@ export function withinCleanupBudget(promise, budget) {
             settle();
     });
 }
-//# sourceMappingURL=time.js.map

package/dist/internal/urls.d.ts

@@ -55,4 +55,3 @@ export declare function sameSite(url: string | URL, site: string): boolean;
  * Anything else is `INVALID_ARGUMENT`, the `toTextPattern` rule.
  */
 export declare function urlMatches(current: string, expected: string | RegExp, baseHref: string): boolean;
-//# sourceMappingURL=urls.d.ts.map

package/dist/internal/urls.js

@@ -183,4 +183,3 @@ function serializeForComparison(url) {
         return url;
     }
 }
-//# sourceMappingURL=urls.js.map

package/dist/internal/vcs.d.ts

@@ -18,4 +18,3 @@ export interface VcsInfo {
  * answers, else from the CI variables GitHub Actions sets, else undefined.
  */
 export declare function detectVcs(projectRoot: string, env: NodeJS.ProcessEnv): Promise<VcsInfo | undefined>;
-//# sourceMappingURL=vcs.d.ts.map

package/dist/internal/vcs.js

@@ -29,4 +29,3 @@ export async function detectVcs(projectRoot, env) {
     const ciBranch = env['GITHUB_HEAD_REF'] || env['GITHUB_REF_NAME'];
     return { commit: ciCommit, ...(ciBranch === undefined || ciBranch === '' ? {} : { branch: ciBranch }) };
 }
-//# sourceMappingURL=vcs.js.map

package/dist/internal/zip.d.ts

@@ -29,4 +29,3 @@ export declare function zipEntry(name: string, data: Uint8Array, like?: Pick<Zip
 /** Serializes entries into one archive. */
 export declare function writeZip(entries: readonly ZipEntry[]): Buffer;
 export {};
-//# sourceMappingURL=zip.d.ts.map

package/dist/internal/zip.js

@@ -180,4 +180,3 @@ function dosStamp(date) {
         dosDate: ((year - 1980) << 9) | ((date.getMonth() + 1) << 5) | date.getDate(),
     };
 }
-//# sourceMappingURL=zip.js.map

package/dist/locator/engine.d.ts

@@ -150,4 +150,3 @@ export declare function locatorDetails(expression: LocatorExpression, waitedMs?:
 /** Translates an engine error into the runner-owned public taxonomy. */
 export declare function translateLocatorError(cause: unknown, expression?: LocatorExpression): E2EError;
 export {};
-//# sourceMappingURL=engine.d.ts.map

package/dist/locator/engine.js

@@ -378,4 +378,3 @@ export function translateLocatorError(cause, expression) {
     const suffix = expression === undefined ? '' : `: ${describeExpression(expression)}`;
     return translateEngineError(cause, suffix);
 }
-//# sourceMappingURL=engine.js.map

package/dist/locator/expression.d.ts

@@ -28,4 +28,3 @@ export declare function indexExpression(source: LocatorExpression, index: number
 export declare function expressionHints(expression: LocatorExpression): Pick<ErrorDetails, 'role' | 'name' | 'testId'>;
 /** Renders an expression for diagnostics. */
 export declare function describeExpression(expression: LocatorExpression): string;
-//# sourceMappingURL=expression.d.ts.map

package/dist/locator/expression.js

@@ -140,4 +140,3 @@ export function describeExpression(expression) {
             return `frameLocator(${JSON.stringify(expression.selector)}) >> ${describeExpression(expression.source)}`;
     }
 }
-//# sourceMappingURL=expression.js.map

package/dist/locator/screen.d.ts

@@ -32,4 +32,3 @@ export declare function createScreen(context: ScreenContext): Screen;
 export declare function createScopedScreen(context: ScreenContext, wrap: (expression: LocatorExpression) => LocatorExpression): Screen;
 /** Creates a public locator from a raw expression (a contributed fixture's platform selector). */
 export declare function createLocator(context: ScreenContext, expression: LocatorExpression): Locator;
-//# sourceMappingURL=screen.d.ts.map

package/dist/locator/screen.js

@@ -482,4 +482,3 @@ function requireModifiers(value, api) {
     }
     return modifiers.length === 0 ? {} : { modifiers };
 }
-//# sourceMappingURL=screen.js.map

package/dist/mcp/catalog.d.ts

@@ -24,6 +24,8 @@ export interface SessionCatalog {
     readonly tools: ToolSet;
     /** The tools that change nothing on the app. */
     readonly readOnly: ReadonlySet<string>;
+    /** The project's own tools among them. */
+    readonly project: ReadonlySet<string>;
 }
 export interface CatalogOptions {
     readonly context: StepExecutorContext;
@@ -37,6 +39,8 @@ export interface CatalogOptions {
     /** The session's recorder, when the engine records video. */
     readonly recorder: SessionRecorder | undefined;
     readonly warn: (message: string) => void;
+    /** Told the cause of every grammar action that failed into a result. */
+    readonly onActionFailed?: ((cause: unknown) => void) | undefined;
 }
 /** Builds the session's catalog from the step context and the target. */
 export declare function createSessionCatalog(options: CatalogOptions): SessionCatalog;
@@ -57,4 +61,3 @@ export interface LocateQuery {
 export declare function locateQuery(args: LocateArgs): LocateQuery;
 /** Renders a locate result: the count, the verdict a test would get, and the nodes, each through the attempt's redactor. */
 export declare function describeLocate(query: LocateQuery, count: number, nodes: readonly SemanticNode[], redact: (text: string) => string): string;
-//# sourceMappingURL=catalog.d.ts.map

package/dist/mcp/catalog.js

@@ -29,7 +29,7 @@ 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 { observe: _diffObserve, ...verbs } = createGrammarTools(context, { screen, onActionFailed: options.onActionFailed });
     const recording = options.recorder === undefined ? {} : recordingTools(options.recorder);
     const builtIn = {
         observe: fullObserveTool(context, screen),
@@ -49,7 +49,7 @@ export function createSessionCatalog(options) {
         if (defined[name]?.annotations.mutates === false)
             readOnly.add(name);
     }
-    return { tools: { ...builtIn, ...project }, readOnly };
+    return { tools: { ...builtIn, ...project }, readOnly, project: new Set(Object.keys(project)) };
 }
 /**
  * The session's `observe`: the whole screen, every time. Action results
@@ -149,4 +149,3 @@ function describeNode(node) {
         parts.push(`[${states.join(', ')}]`);
     return parts.join(' ');
 }
-//# sourceMappingURL=catalog.js.map

package/dist/mcp/config.d.ts

@@ -20,4 +20,3 @@ export declare function locateProjectConfig(options: ProjectOptions): string;
  * config. The project root is the config's directory.
  */
 export declare function loadProjectConfig(configPath: string, env: NodeJS.ProcessEnv): Promise<LoadedConfig>;
-//# sourceMappingURL=config.d.ts.map

package/dist/mcp/config.js

@@ -21,4 +21,3 @@ export async function loadProjectConfig(configPath, env) {
     const raw = await loadConfigModule(configPath, { graph: true });
     return { ...resolveConfig(raw, { projectRoot: path.dirname(configPath), configPath, env }), configPath };
 }
-//# sourceMappingURL=config.js.map

package/dist/mcp/recording.d.ts

@@ -74,4 +74,3 @@ export declare class SessionRecorder {
 export declare function describeRecording(recording: FinishedRecording): string;
 /** The session's `start_recording` and `stop_recording` tools. */
 export declare function recordingTools(recorder: SessionRecorder): ToolSet;
-//# sourceMappingURL=recording.d.ts.map

package/dist/mcp/recording.js

@@ -152,4 +152,3 @@ export function recordingTools(recorder) {
         },
     };
 }
-//# sourceMappingURL=recording.js.map

package/dist/mcp/server.d.ts

@@ -7,6 +7,12 @@
  * it the process's and a test hands it pipes.
  */
 import type { Readable, Writable } from 'node:stream';
+import type { McpSessionSummary } from './usage.ts';
+/** The client as it named itself in `initialize`. */
+export interface McpClient {
+    readonly name: string;
+    readonly version: string;
+}
 export interface ServeOptions {
     readonly cwd: string;
     /** The config every session loads unless `open_session` names one. */
@@ -25,7 +31,8 @@ export interface ServeOptions {
     readonly log: (line: string) => void;
     /** Ends the server from outside: a process signal. */
     readonly signal?: AbortSignal | undefined;
+    /** Told once per `open_session`, when its session closes or its open fails, with the client that asked; undefined before `initialize`. */
+    readonly onSessionEnd?: ((summary: McpSessionSummary, client: McpClient | undefined) => void) | 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.js

@@ -6,8 +6,8 @@
  * 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 { McpServer, ResourceTemplate } from '@modelcontextprotocol/server';
+import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
 import { readGuide, skillTopics } from '../cli/skill.js';
 import { ConfigurationError, errorMessage } from '../internal/errors.js';
 import { loadProjectConfig, locateProjectConfig } from './config.js';
@@ -34,16 +34,20 @@ export async function serveMcp(options) {
         maxSessions: options.maxSessions,
         defaultTarget: options.target,
         log,
+        onSessionEnd: (summary) => {
+            const client = server.server.getClientVersion();
+            options.onSessionEnd?.(summary, client === undefined ? undefined : { name: client.name, version: client.version });
+        },
     });
     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) => {
+        }, async (args, ctx) => {
             // A failure is a result the agent can react to, never a protocol error.
             try {
-                return await spec.call(args, { signal: extra.signal });
+                return await spec.call(args, { signal: ctx.mcpReq.signal });
             }
             catch (cause) {
                 return errorResult(cause);
@@ -100,4 +104,3 @@ function registerGuide(server) {
         return { contents: [{ uri: uri.href, mimeType: 'text/markdown', text }] };
     });
 }
-//# sourceMappingURL=server.js.map

package/dist/mcp/session.d.ts

@@ -12,6 +12,7 @@
  * restart and the client's tool list never changes.
  */
 import type { LoadedConfig } from './config.ts';
+import { type McpSessionSummary, type SessionEndedBy } from './usage.ts';
 import { type McpToolCallExtra, type McpToolResult, type McpToolSpec } from './tools.ts';
 /** How many sessions `e2e mcp --max-sessions` allows at once, each a browser or a device. */
 export declare const SESSION_BOUNDS: {
@@ -39,6 +40,8 @@ export interface SessionHostOptions {
     readonly ttlMs?: number | undefined;
     /** How many sessions may be open at once, from `--max-sessions`; default `SESSION_BOUNDS.default`. */
     readonly maxSessions?: number | undefined;
+    /** Told once per `open_session`, when its session closes or its open fails. */
+    readonly onSessionEnd?: ((summary: McpSessionSummary) => void) | undefined;
 }
 /** Owns the live sessions, up to the server's limit, and the fixed MCP tools that drive them. */
 export declare class SessionHost {
@@ -60,7 +63,7 @@ export declare class SessionHost {
      */
     open(options: OpenSessionOptions, signal?: AbortSignal): Promise<string>;
     /** Closes one session, the only one when `session` is omitted, and returns what happened; a session already closing returns that close. */
-    close(reason: string, session?: string): Promise<string>;
+    close(reason: string, session?: string, endedBy?: SessionEndedBy): Promise<string>;
     /** Closes every session, for a server that is shutting down; undefined when none was open. */
     closeAll(reason: string): Promise<string | undefined>;
     private teardown;
@@ -101,4 +104,3 @@ export declare class SessionHost {
     private callSpec;
     private closeSpec;
 }
-//# sourceMappingURL=session.d.ts.map