@e2edev/e2e 0.11.0 → 0.12.0

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 --no-install 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":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoBzC,MAAM,YAAY,GAAG;;+LAE0K,CAAC;AAIhM,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAqB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EACvD,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CACxF,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAe,EAAE,OAAe,EAAQ,EAAE;QACrD,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,WAAW,EAAE;YAAE,KAAK,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3H,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC;QAC3B,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QACnI,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,GAAG;KACJ,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE;SACnE,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YACpB,wEAAwE;YACxE,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IACD,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC3C,2EAA2E;QAC3E,6DAA6D;QAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,MAAM,EAAE,WAAW,OAAO,CAAC,OAAO,YAAY,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjE,MAAM,MAAM,CAAC;IACb,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,qBAAqB;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,4BAA4B,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3G,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iFAAiF;AACjF,SAAS,aAAa,CAAC,MAAiB;IACtC,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,aAAa,EACb,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,sFAAsF,EAAE,QAAQ,EAAE,eAAe,EAAE,EACtJ,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,6CAA6C,EAAE,CAAC,EAAE,CAAC,CAC3J,CAAC;IACF,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,IAAI,gBAAgB,CAAC,qBAAqB,EAAE;QAC1C,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,SAAS,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;SACnH,CAAC;KACH,CAAC,EACF,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,2BAA2B,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC3H,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,KAAK,cAAc,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvI,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC,CACF,CAAC;AACJ,CAAC"}

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;AAQ3E,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;IA6EzB,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"}

package/dist/mcp/session.js

@@ -0,0 +1,317 @@
+/**
+ * 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 { 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) {
+        const config = 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), locate, screenshot, 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":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAwB,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAA0B,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAA+D,MAAM,YAAY,CAAC;AAEjK,uDAAuD;AACvD,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC1C,0FAA0F;AAC1F,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACvC,mGAAmG;AACnG,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AACjC,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAmC3F,2EAA2E;AAC3E,MAAM,OAAO,WAAW;IAMO,OAAO;IAL5B,IAAI,CAA0B;IAC9B,OAAO,CAA8B;IAC7C,qFAAqF;IAC7E,OAAO,CAAqB;IAEpC,YAA6B,OAA2B;uBAA3B,OAAO;IAAuB,CAAC;IAE5D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;IACjC,CAAC;IAED,yFAAyF;IACzF,SAAS;QACP,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,oGAAoG;IACpG,IAAI,CAAC,OAA2B;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,kBAAkB,CACpB,cAAc,EACd,WAAW,IAAI,CAAC,IAAI,CAAC,EAAE,+BAA+B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,mCAAmC,CAC/G,CACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACtD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAgB;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,qBAAqB,CAAC;QACrD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,CAAC,WAAW,IAAI,CAAC,EAAE,YAAY,MAAM,MAAM,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;QACzF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,gCAAgC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3G,KAAK,MAAM,KAAK,IAAI,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,0DAA0D;IAC1D,OAAO,CAAC,OAA2B,EAAE,IAAwB;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,gFAAgF,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChO,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,OAA2B,EAAE,IAAY,EAAE,IAA6B,EAAE,KAAuB;QACpG,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,OAA2B;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,IAAI,OAAsC,CAAC;QAC3C,IAAI,IAAiC,CAAC;QACtC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,qBAAqB,CAAC;gBACpC,MAAM;gBACN,MAAM;gBACN,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC3B,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;gBACrB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,SAAS,EAAE,KAAK,GAAG,cAAc;gBACjC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC;gBACjE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,KAAK,OAAO,EAAE,CAAC;aAC7E,CAAC,CAAC;YACH,uEAAuE;YACvE,yCAAyC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,YAAY,EAAE;gBACrD,WAAW,EAAE,mBAAmB;gBAChC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;gBAC3C,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,oBAAoB,CAAC;gBACnC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM;gBACN,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;gBAC/B,OAAO,EAAE,IAAI,aAAa,CAAC;oBACzB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;iBAC1C,CAAC;gBACF,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC;aACxD,CAAC,CAAC;YACH,MAAM,IAAI,GAAgB;gBACxB,EAAE;gBACF,MAAM;gBACN,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,eAAe;gBAClE,OAAO;gBACP,IAAI;gBACJ,MAAM;gBACN,OAAO;gBACP,KAAK;gBACL,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,CAAC;aACX,CAAC;YACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,uEAAuE;YACvE,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACpC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;oBAAE,OAAO;gBAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACrG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;gBAC3D,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sEAAsE;YACtE,qEAAqE;YACrE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,MAAM,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACpG,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9C,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,iEAAiE;IACzD,KAAK,CAAC,WAAW,CAAC,IAAiB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACnE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,IAAI,YAAY,YAAY,CAAC,KAAK,CAAC,2CAA2C,CAAC;YACnG,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAEO,WAAW,CAAC,IAAiB,EAAE,MAAsB,EAAE,MAAc;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAClC,MAAM,KAAK,GAAG;YACZ,WAAW,IAAI,CAAC,EAAE,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,YAAY,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,YAAY,IAAI,CAAC,UAAU,GAAG;SACvP,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,sBAAsB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClH,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CACpD,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CACzF,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,4FAA4F,CAAC,CAAC;QAC/I,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,gFAAgF,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACzH,KAAK,CAAC,IAAI,CACR,oLAAoL,CACrL,CAAC;QACF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,MAAM,EAAE,CAAC;IAC5C,CAAC;IAEO,YAAY,CAAC,IAAiB;QACpC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5H,CAAC;IAEO,aAAa,CAAC,MAAsB,EAAE,SAA6B;QACzE,MAAM,IAAI,GAAG,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC3E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,mBAAmB,IAAI,0BAA0B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3I,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnE,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,gCAAgC,CAAC,CAAC;QACzG,MAAM,IAAI,kBAAkB,CAC1B,iBAAiB,EACjB,wCAAwC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kEAAkE,CAC3H,CAAC;IACJ,CAAC;IAED,6FAA6F;IACrF,YAAY,CAAC,MAAsB;QACzC,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACpD,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnH,CAAC;IAEO,WAAW,CAAC,OAA2B;QAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iCAAiC,IAAI,CAAC,OAAO,GAAG,CAAC;YACpG,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,8CAA8C,QAAQ,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAEO,YAAY,CAAC,IAAiB,EAAE,OAAe;QACrD,OAAO,IAAI,kBAAkB,CAAC,YAAY,EAAE,YAAY,OAAO,sCAAsC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClH,CAAC;IAEO,WAAW,CAAC,IAAiB,EAAE,IAAY;QACjD,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,kBAAkB,CAC3B,wBAAwB,EACxB,SAAS,IAAI,6DAA6D,IAAI,CAAC,MAAM,CAAC,IAAI,uDAAuD,CAClJ,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,kBAAkB,CAAC,cAAc,EAAE,SAAS,IAAI,8CAA8C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzJ,CAAC;IAEO,KAAK,CAAC,IAAiB;QAC7B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO;YAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,IAAI,CAAC,EAAE,aAAa,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC9G,KAAK,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,yDAAyD;IACjD,GAAG,CAAI,IAAiB,EAAE,IAAsB;QACtD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,0BAA0B;IAElB,QAAQ;QACd,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,mWAAmW;YACrW,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;gBACvH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;aACpJ,CAAC;YACF,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAEO,WAAW;QACjB,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,WAAW,EACT,8RAA8R;YAChS,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;gBACzF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;aAC3F,CAAC;YACF,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;SACxE,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ;QACd,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,8SAA8S;YAChT,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;gBACtG,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;gBAChH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;aAC3F,CAAC;YACF,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;SAClF,CAAC,CAAC;IACL,CAAC;IAEO,SAAS;QACf,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,8GAA8G;YAC3H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;aAC3F,CAAC;YACF,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SACxF,CAAC,CAAC;IACL,CAAC;CACF"}

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"}