craftdriver 1.7.0 → 1.9.0

package/dist/cli/mcp/server.js

@@ -1,182 +1,317 @@
 /**
- * MCP server — JSON-RPC 2.0 over stdio.
+ * MCP server — JSON-RPC 2.0 over newline-delimited stdio.
  *
- * Hand-rolled because the spec we use (initialize / tools/list /
- * tools/call) is ~6 methods, and pulling `@modelcontextprotocol/sdk`
- * would multiply our runtime-dep footprint. If the spec grows we can
- * swap in the SDK without changing tool definitions in `tools.ts`.
- *
- * Protocol version we advertise: 2024-11-05. If the client offers a
- * newer one we just echo theirs back — the methods we implement are
- * stable across versions to date.
- *
- * Lifecycle:
- *   client → initialize         → server returns capabilities + info
- *   client → notifications/initialized   (no response)
- *   client ⇆ tools/list, tools/call, ...
- *   stdin EOF (or SIGINT/SIGTERM)        → close browser, exit 0
+ * The protocol functions in this module only decode, classify, route, and
+ * render messages. Browser commands always execute through AgentSession.
  */
-import { Browser } from '../../lib/browser.js';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { assertLocalOnlyLaunch } from '../../lib/launchTarget.js';
 import { CraftdriverError, ErrorCode } from '../../lib/errors.js';
-import { createBrowserHandle } from '../dispatcher.js';
-import { TOOLS, getTool, runTool } from './tools.js';
-import { renderDelta, renderFull, takeSnapshot } from '../snapshot.js';
-import { ArtifactStore, resolveSpillBytes, spillPreview, } from './artifacts.js';
-const PROTOCOL_VERSION = '2024-11-05';
+import { AgentSession, } from '../agentSession.js';
+import { TOOLS, getTool, inputSchemaFor, validateToolArgs, runToolDetailed, } from './tools.js';
+import { renderFull } from '../snapshot.js';
+import { BoundedLineReader, MAX_FRAME_BYTES } from '../lineReader.js';
+import { boundToolResult, resolveMaxResponseBytes, truncateUtf8 } from './bounds.js';
+import { ArtifactStore, ArtifactQuotaError, resolveSpillBytes, spillPreview, } from './artifacts.js';
+/**
+ * Protocol versions this server has actually been tested against, newest
+ * first. Negotiation picks from this list and never echoes an unknown
+ * requested version: claiming to speak a revision nobody verified is how a
+ * client ends up relying on behaviour that was never implemented.
+ */
+const SUPPORTED_PROTOCOL_VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'];
+const PROTOCOL_VERSION = SUPPORTED_PROTOCOL_VERSIONS[SUPPORTED_PROTOCOL_VERSIONS.length - 1];
 const SERVER_NAME = 'craftdriver';
-const SERVER_VERSION = '0.1.0';
+/**
+ * Read from the installed package rather than a hand-maintained constant,
+ * which had drifted to 0.1.0 against a 1.7.0 package — so every client was
+ * told the wrong server version.
+ */
+function readServerVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        // dist/cli/mcp/server.js and src/cli/mcp/server.ts are both three levels
+        // below the package root.
+        const pkg = JSON.parse(readFileSync(resolvePath(here, '..', '..', '..', 'package.json'), 'utf8'));
+        return typeof pkg.version === 'string' && pkg.version.length > 0 ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const SERVER_VERSION = readServerVersion();
+/**
+ * Choose the protocol version to answer with.
+ *
+ * A client asking for a version we support gets it. Anything else — unknown,
+ * malformed, or missing — gets our default, which the spec allows and which
+ * is honest about what this server actually implements.
+ */
+export function negotiateProtocolVersion(requested) {
+    return typeof requested === 'string' &&
+        SUPPORTED_PROTOCOL_VERSIONS.includes(requested)
+        ? requested
+        : PROTOCOL_VERSION;
+}
+/** Maximum UTF-8 payload for one MCP JSON line. Shared with the daemon. */
+export const MCP_MAX_FRAME_BYTES = MAX_FRAME_BYTES;
+/** Decode exactly one JSON value after newline framing has completed. */
+export function decodeJsonLine(line) {
+    return JSON.parse(line);
+}
+/** Classify by presence of an `id`; validation remains a separate concern. */
+export function classifyJsonRpcMessage(value) {
+    const message = value;
+    return {
+        kind: Object.prototype.hasOwnProperty.call(message, 'id')
+            ? 'request'
+            : 'notification',
+        message,
+    };
+}
+export function serializeJsonRpcResponse(response) {
+    return JSON.stringify(response) + '\n';
+}
+export function sendJsonRpcResponse(output, response) {
+    output.write(serializeJsonRpcResponse(response));
+}
 export async function runMcpServer(opts) {
     // The MCP server is a local dev tool only — never reachable against a
     // Grid/cloud. Fail fast at startup, not on first browser use.
     assertLocalOnlyLaunch(opts.launch);
     const input = opts.input ?? process.stdin;
     const output = opts.output ?? process.stdout;
-    const handle = createBrowserHandle(() => Browser.launch(opts.launch));
-    const ctx = { handle, launchOptions: opts.launch };
-    // Snapshot state: one most-recent snapshot per session for diffing.
-    let lastSnapshot = null;
-    const snapshotsOn = opts.snapshot !== 'none';
-    // Artifact store: large content blocks spill here so they don't burn
-    // context tokens on every turn.
-    const artifacts = new ArtifactStore(opts.artifactsDir);
-    const spillBytes = opts.spillBytes ?? resolveSpillBytes();
-    function send(msg) {
-        output.write(JSON.stringify(msg) + '\n');
-    }
-    async function handleRequest(req) {
-        const id = req.id ?? null;
-        try {
-            switch (req.method) {
-                case 'initialize':
-                    return ok(id, {
-                        protocolVersion: req.params?.protocolVersion ?? PROTOCOL_VERSION,
-                        capabilities: { tools: {} },
-                        serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },
-                        instructions: 'craftdriver browser automation. Probe selectors with browser_exists ' +
-                            'before acting; errors carry a stable `code` field; the post-action ' +
-                            'a11y snapshot diff tells you what changed.',
-                    });
-                case 'notifications/initialized':
-                    return null; // notification — no response
-                case 'ping':
-                    return ok(id, {});
-                case 'tools/list':
-                    return ok(id, {
-                        tools: TOOLS.map((t) => ({
-                            name: t.name,
-                            description: t.description,
-                            inputSchema: t.inputSchema,
-                        })),
-                    });
-                case 'tools/call': {
-                    const name = req.params?.name;
-                    const args = req.params?.arguments ?? {};
-                    if (!name)
-                        return rpcError(id, -32602, 'tools/call: missing "name"');
-                    const tool = getTool(name);
-                    if (!tool) {
-                        return ok(id, toolError(`unknown tool: ${name}`, ErrorCode.INVALID_ARGUMENT));
-                    }
-                    const result = await callTool(ctx, tool, args, {
-                        snapshotsOn,
-                        getPrev: () => lastSnapshot,
-                        setLast: (s) => {
-                            lastSnapshot = s;
-                        },
-                        artifacts,
-                        spillBytes,
-                    });
-                    return ok(id, result);
-                }
-                case 'resources/list':
-                    // Resources land with Item 7 (trace summaries). Empty list now
-                    // keeps clients that probe for resource capability happy.
-                    return ok(id, { resources: [] });
-                default:
-                    return rpcError(id, -32601, `method not found: ${req.method}`);
+    const signalSource = opts.signalSource ?? process;
+    const session = opts.sessionFactory?.() ?? new AgentSession({
+        launchOptions: opts.launch,
+        autoSnapshot: opts.snapshot !== 'none',
+    });
+    const router = {
+        session,
+        snapshotState: {
+            snapshotsOn: opts.snapshot !== 'none',
+            artifacts: new ArtifactStore(opts.artifactsDir),
+            spillBytes: opts.spillBytes ?? resolveSpillBytes(),
+            maxResponseBytes: opts.maxResponseBytes ?? resolveMaxResponseBytes(),
+        },
+    };
+    const reader = new BoundedLineReader();
+    const pending = new Set();
+    let routeTail = Promise.resolve();
+    let accepting = true;
+    const trackMessage = (classified) => {
+        const route = async () => {
+            const response = await routeJsonRpcMethod(classified, router);
+            if (response)
+                sendJsonRpcResponse(output, response);
+        };
+        const isToolCall = classified.message.method === 'tools/call';
+        const task = isToolCall ? routeTail.then(route) : route();
+        if (isToolCall)
+            routeTail = task.catch(() => undefined);
+        pending.add(task);
+        void task.then(() => pending.delete(task), () => pending.delete(task));
+    };
+    const onData = (chunk) => {
+        if (!accepting)
+            return;
+        for (const event of reader.push(chunk)) {
+            if (event.kind === 'oversized') {
+                sendJsonRpcResponse(output, rpcError(null, -32700, `input frame exceeds ${MCP_MAX_FRAME_BYTES}-byte limit`));
+                continue;
             }
-        }
-        catch (e) {
-            return rpcError(id, -32000, e.message ?? String(e));
-        }
-    }
-    // Line-delimited JSON over stdin. Tolerate \r\n and trailing whitespace.
-    let buf = '';
-    input.setEncoding?.('utf8');
-    input.on('data', (chunk) => {
-        buf += typeof chunk === 'string' ? chunk : chunk.toString('utf8');
-        let nl;
-        while ((nl = buf.indexOf('\n')) !== -1) {
-            const line = buf.slice(0, nl).trim();
-            buf = buf.slice(nl + 1);
+            const line = event.line.trim();
             if (!line)
                 continue;
-            let parsed;
             try {
-                parsed = JSON.parse(line);
+                trackMessage(classifyJsonRpcMessage(decodeJsonLine(line)));
             }
             catch {
-                send({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'parse error' } });
-                continue;
+                sendJsonRpcResponse(output, rpcError(null, -32700, 'parse error'));
             }
-            // Run async; responses may interleave but each carries its own id.
-            void handleRequest(parsed).then((resp) => {
-                if (resp)
-                    send(resp);
-            });
         }
+    };
+    input.setEncoding?.('utf8');
+    input.on('data', onData);
+    let finish;
+    const stopped = new Promise((resolve) => {
+        finish = resolve;
     });
-    await new Promise((resolve) => {
-        const done = () => resolve();
-        input.once('end', done);
-        input.once('close', done);
-        process.once('SIGINT', done);
-        process.once('SIGTERM', done);
-    });
-    await handle.close();
+    let stopping = false;
+    const stop = () => {
+        if (stopping)
+            return;
+        stopping = true;
+        accepting = false;
+        finish();
+    };
+    input.once('end', stop);
+    input.once('close', stop);
+    signalSource.once('SIGINT', stop);
+    signalSource.once('SIGTERM', stop);
+    try {
+        await stopped;
+        await Promise.allSettled([...pending]);
+    }
+    finally {
+        input.removeListener('data', onData);
+        input.removeListener('end', stop);
+        input.removeListener('close', stop);
+        signalSource.off('SIGINT', stop);
+        signalSource.off('SIGTERM', stop);
+        await session.close();
+    }
+}
+export async function routeJsonRpcMethod(classified, ctx) {
+    const req = classified.message;
+    const id = req.id ?? null;
+    // JSON-RPC forbids replying to a notification. Only `notifications/
+    // initialized` was handled explicitly, so every other notification fell
+    // through to the method-not-found default and got an unsolicited
+    // `id: null` error frame — which strict MCP clients treat as a protocol
+    // violation. Silence is the correct response to all of them.
+    if (classified.kind === 'notification')
+        return null;
+    try {
+        switch (req.method) {
+            case 'initialize':
+                return ok(id, {
+                    protocolVersion: negotiateProtocolVersion(req.params?.protocolVersion),
+                    capabilities: { tools: {} },
+                    serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },
+                    instructions: 'craftdriver browser automation. Probe selectors with browser_exists ' +
+                        'before acting; errors carry a stable `code` field; the post-action ' +
+                        'a11y snapshot diff tells you what changed.',
+                });
+            case 'ping':
+                return ok(id, {});
+            case 'tools/list':
+                return ok(id, {
+                    tools: TOOLS.map((tool) => ({
+                        name: tool.name,
+                        description: tool.description,
+                        inputSchema: inputSchemaFor(tool),
+                        annotations: tool.annotations,
+                    })),
+                });
+            case 'tools/call': {
+                const name = req.params?.name;
+                const args = req.params?.arguments ?? {};
+                if (!name)
+                    return rpcError(id, -32602, 'tools/call: missing "name"');
+                const tool = getTool(name);
+                // A tool that does not exist is a caller mistake about the protocol,
+                // not a browser failure, so it is a JSON-RPC error rather than a
+                // successful result carrying isError. Normal action failures — a
+                // missing element, a timeout — stay successful results.
+                if (!tool)
+                    return rpcError(id, -32602, `tools/call: unknown tool "${name}"`);
+                let validated;
+                try {
+                    // Validate before the session queue: a malformed call should not
+                    // wait behind a slow browser action to be told it was malformed,
+                    // and nothing invalid should reach the dispatcher at all.
+                    validated = validateToolArgs(tool, args);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    return rpcError(id, -32602, message, {
+                        ...(error instanceof CraftdriverError && error.detail ? { detail: error.detail } : {}),
+                    });
+                }
+                try {
+                    const invocation = await invokeTool(ctx.session, tool, validated, ctx.snapshotState);
+                    return ok(id, await serializeToolSuccess(tool, invocation.value, {
+                        artifacts: ctx.snapshotState.artifacts,
+                        spillBytes: ctx.snapshotState.spillBytes,
+                        delta: invocation.delta,
+                        maxResponseBytes: ctx.snapshotState.maxResponseBytes,
+                    }));
+                }
+                catch (error) {
+                    return ok(id, serializeToolFailure(error, ctx.snapshotState.maxResponseBytes));
+                }
+            }
+            case 'resources/list':
+                return ok(id, { resources: [] });
+            default:
+                return rpcError(id, -32601, `method not found: ${req.method}`);
+        }
+    }
+    catch (error) {
+        return rpcError(id, -32000, error.message ?? String(error));
+    }
 }
-async function callTool(ctx, tool, args, snap) {
-    // Screenshot path allocation: if the caller didn't supply a path,
-    // give them one inside the artifact directory so the PNG bytes are
-    // actually persisted somewhere they can read.
-    if (tool.name === 'browser_screenshot' && !args.path) {
-        args = { ...args, path: await snap.artifacts.allocate('screenshot.png') };
+async function invokeTool(session, tool, inputArgs, snapshotState) {
+    let args = inputArgs;
+    let screenshotPath;
+    if (tool.name === 'browser_screenshot') {
+        // Always server-allocated. The tool takes no destination, so this is the
+        // only path a screenshot can land on, which is what its description says.
+        screenshotPath = await snapshotState.artifacts.allocate('screenshot.png');
+        args = {
+            ...args,
+            path: screenshotPath,
+        };
     }
-    let value;
+    // The session captures the post-action snapshot in the same operation
+    // as the action, against the one baseline explicit snapshots also
+    // advance. The adapter renders that result; it never owns a second one.
+    let detailed;
     try {
-        value = await runTool(ctx, tool, args);
+        detailed = await runToolDetailed(session, tool, args);
+        if (screenshotPath)
+            await snapshotState.artifacts.commitAllocated(screenshotPath);
     }
-    catch (e) {
-        if (e instanceof CraftdriverError) {
-            return toolError(e.message, e.code, e.hint, compactErrorDetail(e.detail));
-        }
-        return toolError(e.message ?? String(e), ErrorCode.DRIVER_ERROR);
+    catch (error) {
+        if (screenshotPath)
+            await snapshotState.artifacts.releaseAllocated(screenshotPath);
+        throw error;
     }
+    if (!snapshotState.snapshotsOn)
+        return { value: detailed.value };
+    return { value: detailed.value, ...(detailed.delta ? { delta: detailed.delta } : {}) };
+}
+/** Render an already-computed tool value without invoking browser work. */
+export async function serializeToolSuccess(tool, value, ctx) {
     const content = [];
-    // Render result. The snapshot tool returns a structured shape we
-    // know how to print compactly; everything else falls through to
-    // the generic summariser. Both paths run through `maybeSpill` so
-    // large payloads land on disk instead of in the context window.
     let primaryText;
-    if (tool.name === 'browser_snapshot' && value && typeof value === 'object' && 'lines' in value) {
-        primaryText = await maybeSpill(renderFull(value), 'snapshot.txt', snap.artifacts, snap.spillBytes);
+    if (tool.name === 'browser_snapshot' &&
+        value &&
+        typeof value === 'object' &&
+        'lines' in value) {
+        primaryText = await maybeSpill(renderFull(value), 'snapshot.txt', ctx.artifacts, ctx.spillBytes);
     }
     else {
-        primaryText = await summariseValue(tool.name, value, snap.artifacts, snap.spillBytes);
+        primaryText = await summariseValue(tool.name, value, ctx.artifacts, ctx.spillBytes);
     }
     content.push({ type: 'text', text: primaryText });
-    // Post-action a11y diff, when this tool changed page state.
-    if (tool.mutating && snap.snapshotsOn) {
-        const next = await takeSnapshot(await ctx.handle.get()).catch(() => null);
-        const delta = renderDelta(snap.getPrev(), next);
-        if (delta) {
-            const block = await maybeSpill(delta, 'snapshot.txt', snap.artifacts, snap.spillBytes);
-            content.push({ type: 'text', text: block });
-        }
-        snap.setLast(next);
+    if (ctx.delta) {
+        content.push({
+            type: 'text',
+            text: await maybeSpill(ctx.delta, 'snapshot.txt', ctx.artifacts, ctx.spillBytes),
+        });
     }
-    return { content, structuredContent: { result: value } };
+    // Bound the complete response, not just the content blocks. Spilling a
+    // large value to an artifact while attaching the same value in full as
+    // structuredContent left a 50 KB eval on the wire behind a 514-byte preview.
+    return boundToolResult({ content, structuredContent: { result: value } }, ctx.maxResponseBytes ?? resolveMaxResponseBytes());
+}
+/**
+ * Render a tool failure without requiring a session or transport.
+ *
+ * Bounded like a success. An error carries page-derived text — an assertion
+ * message quoting a whole element, a driver error echoing a selector — so
+ * leaving the failure path unbounded left the envelope cap trivially
+ * bypassable by whatever the page put in the message.
+ */
+export function serializeToolFailure(error, maxResponseBytes = resolveMaxResponseBytes()) {
+    const result = error instanceof CraftdriverError
+        ? toolError(error.message, error.code, error.hint, compactErrorDetail(error.detail))
+        : toolError(error?.message ?? String(error), ErrorCode.DRIVER_ERROR);
+    return boundToolResult(result, maxResponseBytes);
 }
 async function summariseValue(toolName, value, artifacts, spillBytes) {
     if (value === null || value === undefined)
@@ -188,8 +323,17 @@ async function maybeSpill(text, nameHint, artifacts, spillBytes) {
     const size = Buffer.byteLength(text, 'utf8');
     if (size <= spillBytes)
         return text;
-    const written = await artifacts.write(nameHint, text);
-    return spillPreview(text, written);
+    try {
+        const written = await artifacts.write(nameHint, text);
+        return spillPreview(text, written);
+    }
+    catch (error) {
+        if (!(error instanceof ArtifactQuotaError))
+            throw error;
+        // A full artifact store must not fail the command the agent asked for.
+        // Fall back to an inline value; the envelope bound trims it either way.
+        return truncateUtf8(text, spillBytes) + `\n… (truncated — ${error.message})`;
+    }
 }
 function safeJson(value) {
     try {
@@ -225,7 +369,17 @@ function toolError(message, code, hint, detail) {
 function ok(id, result) {
     return { jsonrpc: '2.0', id, result };
 }
-function rpcError(id, code, message) {
-    return { jsonrpc: '2.0', id, error: { code, message } };
+function rpcError(id, code, message, extra) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: {
+            code,
+            message,
+            // `data` carries the machine-readable part (which field, what was
+            // allowed) so a client need not parse the message to correct itself.
+            ...(extra?.detail !== undefined ? { data: extra.detail } : {}),
+        },
+    };
 }
 //# sourceMappingURL=server.js.map

package/dist/cli/mcp/server.js.map

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

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

@@ -1,33 +1,78 @@
 /**
  * MCP tool registry.
  *
- * Each tool: a JSON Schema for the model + a thin handler that maps
- * the arguments onto the existing dispatcher. The dispatcher already
- * speaks `{ cmd, args }` and throws `CraftdriverError` with stable
- * codes — we reuse it untouched so library, CLI, and MCP all behave
- * identically when given the same selector.
+ * Each tool is a parameter descriptor plus a thin mapping onto an existing
+ * dispatcher command. Three rules keep this an adapter rather than a second
+ * implementation:
  *
- * Compact set per §6 of the AI-productivity plan: ~12 tools, one-line
- * descriptions and merged variants behind options.
+ * - **No MCP-only browser semantics.** Every tool dispatches a command the CLI
+ *   also has, with the same arguments. Where the CLI command takes an `action`,
+ *   the tool does too — mirroring its shape rather than inventing a nicer one
+ *   is what keeps the two from drifting.
+ * - **One declaration per argument.** `params` produces both the advertised
+ *   `inputSchema` and the runtime validation, so a tool cannot promise a
+ *   constraint it does not enforce.
+ * - **Whether an action mutates the page is not declared here.** The
+ *   dispatcher's `MUTATING` set decides, and the presence of a post-action
+ *   delta is the only signal. A per-tool flag was a second source of truth
+ *   once already: it marked `browser_advanced_eval` mutating while the
+ *   dispatcher did not, so the one tool that can rewrite a page never
+ *   reported its changes.
+ *
+ * The set is kept deliberately smaller than the CLI's command list. Every tool
+ * costs context in `tools/list` on every agent turn, so element actions that
+ * share a signature are grouped behind one `action` argument instead of
+ * becoming seven tools.
  */
-import type { DispatchContext } from '../dispatcher.js';
+import type { AgentDetailedResult, AgentSessionRunner } from '../agentSession.js';
+import { type ParamSpecs } from './params.js';
+/**
+ * MCP tool annotations.
+ *
+ * Accuracy matters more than completeness here: a client may use these to
+ * decide what to auto-approve, so a wrong `readOnlyHint` is worse than an
+ * absent one.
+ */
+export interface ToolAnnotations {
+    title: string;
+    /** Does not change the page or any persistent state. */
+    readOnlyHint: boolean;
+    /** May destroy state a user would not want destroyed. */
+    destructiveHint: boolean;
+    /** Repeating the call with the same arguments changes nothing further. */
+    idempotentHint: boolean;
+    /** Interacts with the outside world (the web, the filesystem). */
+    openWorldHint: boolean;
+}
 export interface ToolDef {
     name: string;
     description: string;
-    /** JSON Schema, restricted to types MCP clients reliably support. */
-    inputSchema: Record<string, unknown>;
-    /** Map MCP args → dispatcher args. Defaults to identity. */
+    params: ParamSpecs;
+    annotations: ToolAnnotations;
+    /** Map validated MCP args → dispatcher args. */
     toDispatch: (args: Record<string, unknown>) => {
         cmd: string;
         args: Record<string, unknown>;
     };
-    /** When true, this action mutates page state — caller should take a snapshot. */
-    mutating: boolean;
-    /** When true, the result includes binary content (image bytes). */
-    returnsImage?: boolean;
 }
 export declare const TOOLS: ToolDef[];
 export declare function getTool(name: string): ToolDef | undefined;
-/** Run a tool against the dispatcher. Throws CraftdriverError on failure. */
-export declare function runTool(ctx: DispatchContext, tool: ToolDef, args: Record<string, unknown>): Promise<unknown>;
+/** The advertised schema for a tool, derived from its parameter descriptor. */
+export declare function inputSchemaFor(tool: ToolDef): Record<string, unknown>;
+/**
+ * Validate arguments against the tool's descriptor.
+ *
+ * Separate from dispatch so the server can reject before touching the session
+ * queue: an invalid call should not wait behind a slow browser action to be
+ * told it was malformed.
+ */
+export declare function validateToolArgs(tool: ToolDef, args: unknown): Record<string, unknown>;
+/** Map a tool to a dispatcher command and run it through the shared session. */
+export declare function runTool(session: AgentSessionRunner, tool: ToolDef, args: Record<string, unknown>): Promise<unknown>;
+/**
+ * As {@link runTool}, but keeps the post-action snapshot the session captured
+ * in the same operation. The MCP adapter renders that as the second content
+ * block; it does not compute or own it.
+ */
+export declare function runToolDetailed(session: AgentSessionRunner, tool: ToolDef, args: Record<string, unknown>): Promise<AgentDetailedResult>;
 //# sourceMappingURL=tools.d.ts.map