copperhead 0.10.0 → 0.11.0

package/dist/mcp/server.js

@@ -0,0 +1,485 @@
+/**
+ * `copperhead mcp` — a stdio MCP server exposing the gated pipeline to MCP
+ * hosts as five opaque, outcome-level tools (design D1).
+ *
+ * The security boundary is tool granularity, not prompt wording. Hosts get
+ * `check`, `do`, `sync` and `init` as whole-pipeline invocations, plus the
+ * read-only `doctor` probe, and nothing finer: no file-edit tool, no raw KiCad
+ * tool, no way to drive one step of the loop. There is therefore no sequence of MCP calls that skips the spec gate or
+ * the verification gate, because every mutating path runs the same loop the CLI
+ * runs. Safety rails are inherited rather than restated — this module is a
+ * transport adapter over the existing command entry points, and deliberately
+ * owns no policy of its own.
+ *
+ * Two rails are enforced here because they are properties of the transport
+ * rather than of the pipeline: stdout carries only the JSON-RPC stream (every
+ * human-readable byte goes to stderr, or the protocol corrupts), and mutating
+ * calls are serialized per repo *within this server process*. That lock is
+ * in-memory, so it does not interlock two separately spawned servers or a
+ * concurrent CLI run — those are held apart by the loop's own dirty-tree
+ * preflight, not by this.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { loadConfig, resolveModel } from '../config.js';
+import { runCheck } from '../commands/check.js';
+import { syncVerify, syncResolve, formatSyncReport } from '../commands/sync.js';
+import { runInit, InitError } from '../memory/scaffold.js';
+import { SandboxError } from '../util/paths.js';
+import { runDoctor } from '../commands/doctor.js';
+import { runAgentLoop } from '../agent/loop.js';
+import { kicadCliVersion } from '../kicad/cli.js';
+import { seal } from '../agent/envelope.js';
+import { plainRenderer } from '../agent/render.js';
+/** The copperhead package version, for run self-description (AC-8.1). This is
+ *  deliberately not MCP_PROTOCOL_VERSION: run metadata records which copperhead
+ *  produced a commit, and the transport's own version would be a false answer. */
+const { version: COPPERHEAD_VERSION } = createRequire(import.meta.url)('../../package.json');
+/**
+ * Unstable by declaration (design D7). The `0.` major is load-bearing: it is
+ * the signal to hosts that tool names, input schemas and result shapes may
+ * change in any release, and it is what defers a registry listing until the
+ * stabilization criteria in the proposal are met. A test asserts the `0.`, so
+ * removing the experimental status is a deliberate edit rather than a drift.
+ */
+export const MCP_PROTOCOL_VERSION = '0.1.0';
+/** The entire surface. Anything not on this list is not reachable over MCP. */
+export const PIPELINE_TOOL_NAMES = [
+    'copperhead_check',
+    'copperhead_do',
+    'copperhead_sync',
+    'copperhead_init',
+    'copperhead_doctor',
+];
+/**
+ * Per-tool input schema versions, bumped when a tool's inputs change shape.
+ * Separate from MCP_PROTOCOL_VERSION so one tool changing does not imply the
+ * whole surface did.
+ */
+export const TOOL_SCHEMA_VERSIONS = {
+    copperhead_check: 1,
+    copperhead_do: 1,
+    copperhead_sync: 1,
+    copperhead_init: 1,
+    copperhead_doctor: 1,
+};
+/** Human-readable output goes to stderr; stdout belongs to JSON-RPC alone. */
+const note = (line) => {
+    process.stderr.write(`${line}\n`);
+};
+/** A sealed failure envelope. `seal` redacts, so a key can never ride out. */
+export function failure(kind, message) {
+    return seal({ ok: false, summary: message, error: { kind, message } });
+}
+/**
+ * Resolve the model for an LLM-backed tool, converting the two ways model
+ * resolution can fail into typed errors a host agent can act on: no credential
+ * at all, and two credentials with nothing to choose between them. Neither is
+ * an exception — a host that cannot run `do` should be told why in a result.
+ */
+async function resolveModelOrFail(repoRoot) {
+    try {
+        const config = await loadConfig(repoRoot);
+        const { model, source } = resolveModel(undefined, config);
+        return { model, source };
+    }
+    catch (err) {
+        // `unavailable` rather than `validation`: the call was well-formed, the
+        // environment just cannot serve it.
+        return { error: failure('unavailable', err.message) };
+    }
+}
+/** kicad-cli is a hard precondition for every tool, exactly as in the CLI. */
+async function requireKicad() {
+    try {
+        return { version: await kicadCliVersion() };
+    }
+    catch (err) {
+        return {
+            error: failure('unavailable', `kicad-cli is not available: ${err.message}. Install KiCad 9+ and ensure kicad-cli is on PATH.`),
+        };
+    }
+}
+/**
+ * Mutating tools are serialized per repo. Rejecting rather than queueing is
+ * deliberate: a `do` run can take minutes, and a host blocked on an invisible
+ * queue looks hung, while a typed busy error is something an agent can relay
+ * and retry. Concurrent `check` calls are unrestricted — they mutate nothing.
+ */
+export class RepoLocks {
+    busy = new Set();
+    tryAcquire(repoRoot) {
+        if (this.busy.has(repoRoot))
+            return false;
+        this.busy.add(repoRoot);
+        return true;
+    }
+    release(repoRoot) {
+        this.busy.delete(repoRoot);
+    }
+    isBusy(repoRoot) {
+        return this.busy.has(repoRoot);
+    }
+}
+/**
+ * A ProgressRenderer that mirrors loop progress onto MCP progress
+ * notifications. `progress` is a monotonically rising count of observed events
+ * rather than a percentage: the loop cannot know how many turns a run will take,
+ * and inventing a denominator would be a worse lie than an open-ended counter.
+ */
+export function mcpRenderer(sink) {
+    let ticks = 0;
+    const emit = (message) => {
+        ticks += 1;
+        sink({ message, progress: ticks });
+    };
+    const base = plainRenderer((line) => {
+        note(line);
+    });
+    return {
+        log: (line) => {
+            base.log(line);
+        },
+        turnStart: (turn, maxTurns, tokensIn, tokensOut) => {
+            base.turnStart(turn, maxTurns, tokensIn, tokensOut);
+            emit(`turn ${turn}/${maxTurns}`);
+        },
+        toolResult: (name, firstLine, ok, viewHint) => {
+            base.toolResult(name, firstLine, ok, viewHint);
+            emit(`${name}: ${firstLine}`);
+        },
+        status: (text) => {
+            base.status(text);
+        },
+        heartbeat: (info) => {
+            base.heartbeat(info);
+            emit('working');
+        },
+        finish: (line) => {
+            base.finish(line);
+            emit(line);
+        },
+    };
+}
+/**
+ * Map a finished run onto the status vocabulary hosts see. `rolled_back` is the
+ * honest default for every non-success exit path that is not a refusal: the
+ * loop restores its git snapshot on the way out, so "the run failed" and "the
+ * tree is back where it started" are the same fact.
+ */
+export function runStatus(res, dryRun) {
+    if (res.outcome === 'refused')
+        return 'refused';
+    if (res.outcome === 'success')
+        return dryRun ? 'dry_run' : 'committed';
+    return 'rolled_back';
+}
+/**
+ * Build the server and register the tools. Exported separately from
+ * `startMcpServer` so tests can drive the tool surface without a transport.
+ */
+export function createMcpServer(opts) {
+    const { repoRoot } = opts;
+    const locks = new RepoLocks();
+    const server = new McpServer({ name: 'copperhead', version: MCP_PROTOCOL_VERSION }, {
+        instructions: 'EXPERIMENTAL, UNSTABLE SURFACE: tool names, inputs and result shapes may change in any release. ' +
+            'Use these tools to change or verify a KiCad project instead of editing .kicad_sch / .kicad_pcb files ' +
+            'directly. Every mutation runs a spec-gated, verified, rollback-on-failure pipeline; editing the files ' +
+            'yourself bypasses all of it.',
+    });
+    const toMcp = (result) => ({
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        ...(result.ok ? {} : { isError: true }),
+    });
+    server.registerTool('copperhead_check', {
+        title: 'Verify the KiCad project',
+        description: 'Run ERC, DRC, doc-drift and spec validation on the project. Makes no model call and no network call, ' +
+            'and changes nothing. Safe to call at any time, including concurrently.',
+        inputSchema: {},
+        _meta: { schemaVersion: TOOL_SCHEMA_VERSIONS.copperhead_check },
+    }, async () => {
+        const kicad = await requireKicad();
+        if ('error' in kicad)
+            return toMcp(kicad.error);
+        try {
+            const res = await runCheck(repoRoot, (s) => {
+                note(s);
+            });
+            return toMcp(seal({
+                ok: res.ok,
+                summary: res.ok ? 'check passed' : 'check found violations',
+                viewHint: 'diagnostic',
+                data: res,
+            }));
+        }
+        catch (err) {
+            return toMcp(failure('exception', err.message));
+        }
+    });
+    server.registerTool('copperhead_doctor', {
+        title: 'Check that this host can run copperhead',
+        description: 'Probe the environment copperhead needs: node, kicad-cli, git, openspec, and whether a model credential ' +
+            'resolves. Makes no model call and no network call, and changes nothing. Call this first when another ' +
+            'tool reports that something is unavailable.',
+        inputSchema: {},
+        _meta: { schemaVersion: TOOL_SCHEMA_VERSIONS.copperhead_doctor },
+    }, async () => {
+        // Deliberately no requireKicad() preflight. A missing kicad-cli is the
+        // single most likely thing a host needs told about, and gating this tool
+        // on it would make the diagnostic fail in exactly the case it exists for;
+        // runDoctor probes kicad-cli and reports it as a failed check instead.
+        try {
+            const report = await runDoctor({ repoRoot });
+            const failed = report.checks.filter((c) => c.status === 'fail');
+            return toMcp(seal({
+                ok: report.ok,
+                summary: report.ok
+                    ? 'environment is ready'
+                    : `${failed.length} check(s) failed: ${failed.map((c) => c.name).join(', ')}`,
+                viewHint: 'diagnostic',
+                data: report,
+            }));
+        }
+        catch (err) {
+            return toMcp(failure('exception', err.message));
+        }
+    });
+    server.registerTool('copperhead_init', {
+        title: 'Scaffold design docs from the schematic',
+        description: 'Generate the docs/ memory scaffold from an existing schematic. Also installs a git pre-commit hook ' +
+            'that runs copperhead check before each commit. Idempotent, and refuses rather than overwriting docs ' +
+            'a human has hand-edited.',
+        inputSchema: {
+            path: z.string().optional().describe('where to look for KiCad files, relative to the repo root'),
+        },
+        _meta: { schemaVersion: TOOL_SCHEMA_VERSIONS.copperhead_init },
+    }, async ({ path: searchPath }) => {
+        const kicad = await requireKicad();
+        if ('error' in kicad)
+            return toMcp(kicad.error);
+        if (!locks.tryAcquire(repoRoot)) {
+            return toMcp(failure('unavailable', 'another copperhead run is in progress for this repo; retry shortly'));
+        }
+        try {
+            const res = await runInit({
+                repoRoot,
+                ...(searchPath ? { searchPath } : {}),
+                force: false,
+                installHooks: true,
+            });
+            const refused = res.refused.length > 0;
+            return toMcp(seal({
+                ok: !refused,
+                summary: refused
+                    ? `init refused ${res.refused.length} hand-edited doc(s)`
+                    : `init wrote ${res.created.length} file(s)`,
+                viewHint: 'mutation',
+                data: res,
+            }));
+        }
+        catch (err) {
+            // A missing schematic is the user's situation, not a crash: report it
+            // as a validation failure so the host can ask for a path.
+            // A missing schematic and a path that escapes the repo are both the
+            // caller's situation, not a crash: report them as validation failures
+            // so the host can correct the input rather than retrying blindly.
+            const kind = err instanceof InitError || err instanceof SandboxError ? 'validation' : 'exception';
+            return toMcp(failure(kind, err.message));
+        }
+        finally {
+            locks.release(repoRoot);
+        }
+    });
+    server.registerTool('copperhead_do', {
+        title: 'Make a verified change to the project',
+        description: 'Run the full gated pipeline for a change request: propose, spec-gate, edit, verify with ERC/DRC, repair, ' +
+            'and commit — or roll back to the pre-run state if verification cannot be satisfied. This is the only way ' +
+            'to change the project. Long-running; progress is streamed. Requires an API key in the environment.',
+        inputSchema: {
+            request: z.string().min(1).describe('the change request, in natural language'),
+            dry_run: z.boolean().optional().describe('propose the change and write nothing'),
+        },
+        _meta: { schemaVersion: TOOL_SCHEMA_VERSIONS.copperhead_do },
+    }, async ({ request, dry_run: dryRun }, extra) => {
+        const kicad = await requireKicad();
+        if ('error' in kicad)
+            return toMcp(kicad.error);
+        const resolved = await resolveModelOrFail(repoRoot);
+        if ('error' in resolved)
+            return toMcp(resolved.error);
+        if (!locks.tryAcquire(repoRoot)) {
+            return toMcp(failure('unavailable', 'another copperhead run is in progress for this repo; retry shortly'));
+        }
+        const progressToken = extra?._meta?.progressToken;
+        const sink = (update) => {
+            if (progressToken === undefined)
+                return;
+            void extra
+                ?.sendNotification({
+                method: 'notifications/progress',
+                params: { progressToken, progress: update.progress, message: update.message },
+            })
+                .catch(() => {
+                // A host that stopped listening must not fail the run.
+            });
+        };
+        try {
+            const res = await runAgentLoop({
+                repoRoot,
+                request,
+                model: resolved.model,
+                // allowDirty is deliberately not exposed: it is a safety rail, and a
+                // tool input that switches a rail off is a rail a host can bypass.
+                allowDirty: false,
+                dryRun: dryRun ?? false,
+                // No confirm callback and no budget-extension prompt: there is no
+                // human on this transport, so the loop must fail rather than block.
+                interactive: false,
+                renderer: mcpRenderer(sink),
+                meta: {
+                    command: 'do',
+                    modelSource: resolved.source,
+                    version: COPPERHEAD_VERSION,
+                    kicadCliVersion: kicad.version,
+                },
+            });
+            const status = runStatus(res, dryRun ?? false);
+            return toMcp(seal({
+                // A rollback is a successful tool call whose result says the run
+                // did not land (design D6). Only `refused` is reported as not-ok,
+                // because that is the pipeline declining rather than failing.
+                ok: status !== 'refused',
+                summary: `${status}: ${res.summary}`,
+                viewHint: 'mutation',
+                data: {
+                    status,
+                    commit: res.commit,
+                    filesTouched: res.filesTouched,
+                    transcriptDir: res.transcriptDir,
+                    exitPath: res.exitPath,
+                    stats: res.stats,
+                },
+            }));
+        }
+        catch (err) {
+            return toMcp(failure('exception', err.message));
+        }
+        finally {
+            locks.release(repoRoot);
+        }
+    });
+    server.registerTool('copperhead_sync', {
+        title: 'Verify design-state consistency, and optionally resolve drift',
+        description: 'Run the deterministic consistency check across docs, constraints and the KiCad files. With resolve=true, ' +
+            'additionally run the gated loop to fix the drift it found. Requirement violations are always reported and ' +
+            'never auto-resolved — those are for a human. resolve=true requires an API key in the environment.',
+        inputSchema: {
+            resolve: z.boolean().optional().describe('run the LLM resolve phase for resolvable drift'),
+        },
+        _meta: { schemaVersion: TOOL_SCHEMA_VERSIONS.copperhead_sync },
+    }, async ({ resolve }, extra) => {
+        const kicad = await requireKicad();
+        if ('error' in kicad)
+            return toMcp(kicad.error);
+        let report;
+        try {
+            report = await syncVerify(repoRoot);
+        }
+        catch (err) {
+            return toMcp(failure('exception', err.message));
+        }
+        const verdict = (summary, ok = true) => seal({ ok, summary, viewHint: resolve ? 'mutation' : 'diagnostic', data: report });
+        if (!resolve)
+            return toMcp(verdict(formatSyncReport(report)));
+        // Truth precedence (design D14): a requirement violation is never
+        // silently resolved, so the resolve phase does not start when one exists.
+        if (report.violations.length) {
+            return toMcp(verdict(`${report.violations.length} requirement violation(s) found; these are never auto-resolved. ` +
+                `Resolve them by hand or change the requirement.\n\n${formatSyncReport(report)}`, false));
+        }
+        if (!report.resolvable.length)
+            return toMcp(verdict('design state is consistent; nothing to resolve'));
+        const resolved = await resolveModelOrFail(repoRoot);
+        if ('error' in resolved)
+            return toMcp(resolved.error);
+        if (!locks.tryAcquire(repoRoot)) {
+            return toMcp(failure('unavailable', 'another copperhead run is in progress for this repo; retry shortly'));
+        }
+        // The report above was computed before the lock was held, so another run
+        // may have rewritten the tree in between. Re-verify now that nothing else
+        // can move, rather than asking the loop to fix drift that is already gone.
+        const fresh = await syncVerify(repoRoot);
+        if (fresh.violations.length || !fresh.resolvable.length) {
+            locks.release(repoRoot);
+            return toMcp(seal({
+                ok: !fresh.violations.length,
+                summary: fresh.violations.length
+                    ? `${fresh.violations.length} requirement violation(s) found; these are never auto-resolved.`
+                    : 'design state is consistent; nothing to resolve',
+                viewHint: 'diagnostic',
+                data: fresh,
+            }));
+        }
+        const progressToken = extra?._meta?.progressToken;
+        const sink = (update) => {
+            if (progressToken === undefined)
+                return;
+            void extra
+                ?.sendNotification({
+                method: 'notifications/progress',
+                params: { progressToken, progress: update.progress, message: update.message },
+            })
+                .catch(() => {
+                // A host that stopped listening must not fail the run.
+            });
+        };
+        try {
+            const res = await syncResolve(repoRoot, fresh, resolved.model, (s) => {
+                note(s);
+            }, {
+                renderer: mcpRenderer(sink),
+                meta: {
+                    command: 'sync',
+                    modelSource: resolved.source,
+                    version: COPPERHEAD_VERSION,
+                    kicadCliVersion: kicad.version,
+                },
+            });
+            return toMcp(seal({
+                ok: res.ok,
+                summary: res.ok ? 'drift resolved and verified' : `resolve did not land: ${res.run.summary}`,
+                viewHint: 'mutation',
+                data: {
+                    resolved: res.ok,
+                    report: fresh,
+                    commit: res.run.commit,
+                    filesTouched: res.run.filesTouched,
+                    transcriptDir: res.run.transcriptDir,
+                    exitPath: res.run.exitPath,
+                },
+            }));
+        }
+        catch (err) {
+            return toMcp(failure('exception', err.message));
+        }
+        finally {
+            locks.release(repoRoot);
+        }
+    });
+    return server;
+}
+/** Start the server on stdio and serve until the host closes the transport. */
+export async function startMcpServer(opts) {
+    if (!existsSync(opts.repoRoot)) {
+        throw new Error(`repo not found: ${opts.repoRoot}`);
+    }
+    const server = createMcpServer(opts);
+    note(`copperhead mcp ${MCP_PROTOCOL_VERSION} (EXPERIMENTAL — unstable surface: tool names, inputs and results may ` +
+        `change in any release)`);
+    note(`repo: ${opts.repoRoot}`);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/memory/scaffold.js

@@ -4,6 +4,7 @@ import { createHash } from 'node:crypto';
 import path from 'node:path';
 import { listSymbols, pinNets } from '../kicad/sexp.js';
 import { configPath, loadConfig } from '../config.js';
+import { resolveInRepo } from '../util/paths.js';
 export class InitError extends Error {
 }
 const sha = (s) => createHash('sha256').update(s).digest('hex');
@@ -150,7 +151,13 @@ exec copperhead check
 }
 export async function runInit(opts) {
     const { repoRoot } = opts;
-    const searchRoot = path.resolve(repoRoot, opts.searchPath ?? '.');
+    // AC-4.2: the search root comes from an untrusted caller — a CLI flag, and
+    // now an MCP tool input chosen by a host agent. Bare path.resolve lets an
+    // absolute or `../` value win outright, which would scaffold this repo's docs
+    // from a foreign project and durably write an out-of-repo config.schematic
+    // that every later check/do would then operate on. Contain it like every
+    // other file path in the codebase.
+    const searchRoot = resolveInRepo(repoRoot, opts.searchPath ?? '.');
     const { sch, pcb } = await findKicadFiles(searchRoot);
     if (!sch) {
         throw new InitError(`no .kicad_sch found under ${path.relative(repoRoot, searchRoot) || '.'} — point copperhead at a KiCad project (copperhead init --path <dir>)`);

package/dist/memory/scaffold.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copperhead",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Cursor for circuit boards: an AI agent that designs, documents, and validates real PCBs on KiCad repositories",
   "license": "Apache-2.0",
   "author": "Animesh Chouhan <animeshchouhan@outlook.com>",
@@ -58,13 +58,16 @@
     "docs:build": "npm --prefix docs run build",
     "docs:preview": "npm --prefix docs run preview",
     "refboards": "bash scripts/draft-reference-boards.sh",
+    "scoresheets": "tsx scripts/score-sheets.ts",
     "realdesigns": "tsx scripts/draft-real-designs.ts"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.113.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "commander": "^12.1.0",
     "execa": "^9.5.2",
-    "openai": "^6.49.0"
+    "openai": "^6.49.0",
+    "zod": "^4.4.3"
   },
   "optionalDependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.217"

package/src/agent/context.ts

@@ -0,0 +1,35 @@
+import type { CopperheadConfig } from '../config.js';
+import type { CheckReport } from '../kicad/report.js';
+import type { ObligationsLedger } from './ledger.js';
+import type { Transcript } from './transcript.js';
+
+export interface FinishRequest {
+  outcome: 'done' | 'refuse';
+  summary: string;
+}
+
+/** Mutable state one run threads through every tool call. */
+export interface RunContext {
+  repoRoot: string;
+  config: CopperheadConfig;
+  transcript: Transcript;
+  ledger: ObligationsLedger;
+  runId: string;
+  interactive: boolean;
+  confirm: (question: string) => Promise<boolean>;
+  editsUnlocked: boolean;
+  changeId: string | null;
+  proposalValidated: boolean;
+  filesTouched: Set<string>;
+  decisions: string[];
+  lastErc: CheckReport | null;
+  lastDrc: CheckReport | null;
+  /** Last check_legibility counts; feeds the run summary's verification section. */
+  lastLegibility: { error: number; advisory: number } | null;
+  /** Last score composite (AC-16.21); recorded in the run summary. */
+  lastScore: number | null;
+  /** Last `check_drift` output; used by `generate_report` completion. */
+  lastDrift?: string | null;
+  repairCycles: number;
+  finishRequest: FinishRequest | null;
+}

package/src/agent/dock-renderer.ts

@@ -10,6 +10,7 @@
 import { rule, statusBar } from './box.js';
 import { copper, dim, styleOutcome, toolLine, warn } from './theme.js';
 import { fmtDuration, fmtTokens, turnMarker, type ProgressRenderer } from './render.js';
+import type { ViewHint } from './envelope.js';
 import type { TerminalDock } from '../util/dock.js';
 
 const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
@@ -57,8 +58,8 @@ export class DockRenderer implements ProgressRenderer {
     this.emit(line);
   }
 
-  toolResult(name: string, firstLine: string): void {
-    this.emit(toolLine(name, firstLine));
+  toolResult(name: string, firstLine: string, ok?: boolean, viewHint?: ViewHint): void {
+    this.emit(toolLine(name, firstLine, ok, viewHint));
   }
 
   private turnStartMs = Date.now();