synorch 0.2.0 → 0.4.0-beta.0

package/dist/harness/core/stream.js

@@ -0,0 +1,102 @@
+import { modelStreamEventSchema, PROVIDER_ERROR_RETRYABLE, } from "../contracts/index.js";
+const ABORTED = Symbol("aborted");
+export function providerError(code, message) {
+    return { code, message: message.slice(0, 2000) || code, retryable: PROVIDER_ERROR_RETRYABLE[code] };
+}
+/**
+ * Consumes one adapter stream into a single outcome. Abort always wins: a stream cancelled by the
+ * signal is `failed{cancelled}` even if the adapter ignores the signal or still reports `done`.
+ * Adapters must not throw, but a throwing or malformed stream is contained here as well.
+ */
+export async function consumeStream(source, signal, inspect = () => undefined) {
+    const texts = new Map();
+    let usage;
+    let quota;
+    const partial = () => texts.size === 0
+        ? undefined
+        : { role: "assistant", content: [...texts.entries()].sort(([left], [right]) => left - right).map(([, text]) => ({ type: "text", text })) };
+    const failed = (error, reported) => ({ kind: "failed", error, partial: reported ?? partial(), usage, quota });
+    const cancelled = (reported, error) => failed(error?.code === "cancelled" ? error : providerError("cancelled", "request cancelled"), reported);
+    let iterator;
+    try {
+        iterator = source[Symbol.asyncIterator]();
+    }
+    catch (error) {
+        return signal.aborted ? cancelled() : failed(providerError("stream_interrupted", describe(error)));
+    }
+    try {
+        for (;;) {
+            if (signal.aborted) {
+                closeQuietly(iterator);
+                return cancelled();
+            }
+            const next = await nextOrAbort(iterator, signal);
+            if (next === ABORTED) {
+                closeQuietly(iterator);
+                return cancelled();
+            }
+            if (next.done === true) {
+                return signal.aborted ? cancelled() : failed(providerError("protocol_mismatch", "stream ended without done or error"));
+            }
+            const parsed = modelStreamEventSchema.safeParse(next.value);
+            if (!parsed.success) {
+                closeQuietly(iterator);
+                return failed(providerError("protocol_mismatch", `adapter emitted an invalid stream event: ${parsed.error.issues[0]?.message ?? "unknown"}`));
+            }
+            const event = parsed.data;
+            const rejection = inspect(event);
+            if (rejection !== undefined) {
+                closeQuietly(iterator);
+                return failed(rejection);
+            }
+            switch (event.type) {
+                case "text_delta":
+                    texts.set(event.index, (texts.get(event.index) ?? "") + event.text);
+                    break;
+                case "usage":
+                    usage = event.usage;
+                    break;
+                case "quota":
+                    quota = event.quota;
+                    break;
+                case "done":
+                    closeQuietly(iterator);
+                    if (signal.aborted)
+                        return cancelled(event.message);
+                    return { kind: "done", stopReason: event.stop_reason, message: event.message, usage: event.usage ?? usage, quota };
+                case "error":
+                    closeQuietly(iterator);
+                    if (signal.aborted || event.error.code === "cancelled")
+                        return cancelled(event.partial, event.error);
+                    return failed(event.error, event.partial);
+                default:
+                    break;
+            }
+        }
+    }
+    catch (error) {
+        return signal.aborted ? cancelled() : failed(providerError("stream_interrupted", describe(error)));
+    }
+}
+function nextOrAbort(iterator, signal) {
+    return new Promise((resolve, reject) => {
+        const onAbort = () => resolve(ABORTED);
+        signal.addEventListener("abort", onAbort, { once: true });
+        iterator.next().then((result) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(result);
+        }, (error) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(error);
+        });
+    });
+}
+function closeQuietly(iterator) {
+    void Promise.resolve()
+        .then(() => iterator.return?.())
+        .catch(() => undefined);
+}
+export function describe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=stream.js.map

package/dist/harness/core/stream.js.map

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

package/dist/harness/core/testing.d.ts

@@ -0,0 +1,80 @@
+import { type AgentBackendAdapter, type AgentRole, type AnyModelAdapter, type BackendSession, type BlobStore, type ContextBuilder, type EffectivePolicy, type EventStore, type ModelAdapter, type ModelRequest, type ModelRoute, type ModelRouter, type ModelStreamEvent, type ProviderId, type ResolvedCredential, type RunId, type ToolBridge, type ToolCallOutcome, type ToolCallRequest, type ToolGateway, type ToolInvocationScope, type ToolRegistry, type ToolResult } from "../contracts/index.ts";
+/**
+ * In-memory doubles for the driver's seams, for I1's own tests and for other workstreams that need
+ * a scripted loop. None of them is used by production code.
+ */
+export declare function testRoute(kind?: "model" | "agent-backend"): ModelRoute;
+export declare function testPolicy(runId: RunId, role?: AgentRole): EffectivePolicy;
+export declare function testCredential(): ResolvedCredential;
+export type ScriptStep = readonly ModelStreamEvent[] | ((request: ModelRequest, signal: AbortSignal) => AsyncIterable<ModelStreamEvent>);
+/** A `ModelAdapter` that replays one scripted stream per request and records what it was asked. */
+export declare class ScriptedModelAdapter implements ModelAdapter {
+    #private;
+    readonly kind: "model";
+    readonly adapterId = "scripted";
+    readonly providerId: ProviderId;
+    readonly authMethod: "api-key";
+    readonly requests: ModelRequest[];
+    constructor(script: readonly ScriptStep[]);
+    discoverCapabilities(): never;
+    prepare(): never;
+    stream(request: ModelRequest, _credential: ResolvedCredential, signal: AbortSignal): AsyncIterable<ModelStreamEvent>;
+    health(): Promise<never>;
+}
+export declare function textTurn(request: ModelRequest, text: string): ModelStreamEvent[];
+export declare function toolTurn(request: ModelRequest, calls: readonly {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: Record<string, unknown>;
+}[]): ModelStreamEvent[];
+/** Scripts each request lazily so the script can refer to the actual request id and route. */
+export declare function lazy(build: (request: ModelRequest) => readonly ModelStreamEvent[]): ScriptStep;
+export declare function testRouter(adapter: AnyModelAdapter): ModelRouter;
+/**
+ * Rebuilds the model input from the log on every step: one system block plus every recorded
+ * message (blobs resolved). Deterministic, so the same log always yields the same envelope.
+ */
+export declare function createLogContextBuilder(events: EventStore, blobs: BlobStore, tools: ToolRegistry): ContextBuilder;
+export declare function testRegistry(names?: readonly string[]): ToolRegistry;
+export type ToolHandler = (request: ToolCallRequest, signal: AbortSignal) => Promise<ToolResult>;
+/**
+ * Records `tool/call_proposed` -> `tool/execution_started` -> `tool/result_recorded` like the real
+ * gateway and runs `handler` in between; `invocations` lists every call that reached execution.
+ */
+export interface RecordingGatewayOptions {
+    /** Assign `[#n]` short refs (1, 2, …) like the real gateway (ADR-18). */
+    readonly refs?: boolean;
+    /** Names of terminal control tools: a succeeded call with `status: ok` returns `endsTurn` (ADR-20). */
+    readonly terminalTools?: readonly string[];
+}
+export declare class RecordingToolGateway implements ToolGateway {
+    #private;
+    readonly invocations: ToolCallRequest[];
+    constructor(events: EventStore, handler?: ToolHandler, options?: RecordingGatewayOptions);
+    invoke(request: ToolCallRequest, scope: ToolInvocationScope, signal: AbortSignal): Promise<ToolCallOutcome>;
+}
+export type BackendScript = (tools: ToolBridge, request: {
+    readonly requestId: string;
+}) => AsyncIterable<ModelStreamEvent>;
+/** An `AgentBackendAdapter` whose single session runs `script`, calling Synorch tools through the bridge. */
+export declare class ScriptedBackendAdapter implements AgentBackendAdapter {
+    #private;
+    readonly kind: "agent-backend";
+    readonly adapterId = "scripted-backend";
+    readonly providerId: ProviderId;
+    readonly authMethod: "cli-bridge";
+    readonly sessions: {
+        readonly resumed: string | undefined;
+        closed: boolean;
+        interrupted: boolean;
+    }[];
+    constructor(script: BackendScript);
+    probe(): Promise<never>;
+    discoverCapabilities(): Promise<never>;
+    startSession(options: {
+        readonly resumeBackendSessionId: string | undefined;
+    }): Promise<BackendSession>;
+    health(): Promise<never>;
+}
+export declare function newRunId(): RunId;
+//# sourceMappingURL=testing.d.ts.map

package/dist/harness/core/testing.d.ts.map

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

package/dist/harness/core/testing.js

@@ -0,0 +1,258 @@
+import { createId, digestOf, digestText, EVENT_VERSIONS, modelRouteSchema, effectivePolicySchema, } from "../contracts/index.js";
+import { loadRecordedMessage } from "./envelope.js";
+/**
+ * In-memory doubles for the driver's seams, for I1's own tests and for other workstreams that need
+ * a scripted loop. None of them is used by production code.
+ */
+export function testRoute(kind = "model") {
+    return modelRouteSchema.parse(kind === "model"
+        ? { provider_id: "openai", model_id: "test-model", adapter_id: "scripted", adapter_kind: "model", auth_method: "api-key", profile: "default" }
+        : { provider_id: "anthropic", model_id: "test-backend", adapter_id: "scripted-backend", adapter_kind: "agent-backend", auth_method: "cli-bridge", profile: "default" });
+}
+export function testPolicy(runId, role = "implementer") {
+    return effectivePolicySchema.parse({
+        schema_version: 1,
+        policy_version: 1,
+        mode: "autonomous",
+        role,
+        run_id: runId,
+        workspace_root: "/workspace",
+        write_scope: role === "implementer" ? ["src/**"] : [],
+        read_scope: ["**"],
+        forbidden: [],
+        effects: { read: "allow", "workspace-write": role === "implementer" ? "allow" : "deny", exec: "allow", "external-write": "deny", control: "deny" },
+        external_write_allowlist: [],
+        network: { mode: "deny", hosts: [] },
+        sandbox: { backend: "policy-only", enforcement: "partial" },
+        require_full_sandbox: false,
+        exec_confinement: "allowlist",
+        verification_commands: [],
+        layers: [{ layer: "role", source: role, digest: digestText(role) }],
+    });
+}
+export function testCredential() {
+    return {
+        providerId: "openai",
+        method: "api-key",
+        profile: "default",
+        expiresAt: undefined,
+        applyTo: () => undefined,
+        redactionValues: () => [],
+        toJSON: () => "[redacted]",
+    };
+}
+/** A `ModelAdapter` that replays one scripted stream per request and records what it was asked. */
+export class ScriptedModelAdapter {
+    kind = "model";
+    adapterId = "scripted";
+    providerId = "openai";
+    authMethod = "api-key";
+    requests = [];
+    #script;
+    constructor(script) {
+        this.#script = [...script];
+    }
+    discoverCapabilities() {
+        throw new Error("not used by the driver");
+    }
+    prepare() {
+        throw new Error("not used by the driver");
+    }
+    stream(request, _credential, signal) {
+        this.requests.push(request);
+        const step = this.#script.shift();
+        if (step === undefined)
+            return replay([{ type: "error", error: { code: "invalid_request", message: "script exhausted", retryable: false } }]);
+        return typeof step === "function" ? step(request, signal) : replay(step);
+    }
+    async health() {
+        throw new Error("not used by the driver");
+    }
+}
+async function* replay(events) {
+    for (const event of events)
+        yield event;
+}
+export function textTurn(request, text) {
+    return [
+        { type: "start", request_id: request.request_id, route: request.route },
+        { type: "text_delta", index: 0, text },
+        { type: "done", stop_reason: "stop", message: { role: "assistant", content: [{ type: "text", text }] }, usage: { input_tokens: 10, output_tokens: 2, source: "provider-reported" } },
+    ];
+}
+export function toolTurn(request, calls) {
+    return [
+        { type: "start", request_id: request.request_id, route: request.route },
+        ...calls.map((call, index) => ({ type: "tool_call_end", index, provider_call_id: call.id, name: call.name, arguments: call.arguments })),
+        {
+            type: "done",
+            stop_reason: "tool_use",
+            message: { role: "assistant", content: calls.map((call) => ({ type: "tool_call", provider_call_id: call.id, name: call.name, arguments: call.arguments })) },
+        },
+    ];
+}
+/** Scripts each request lazily so the script can refer to the actual request id and route. */
+export function lazy(build) {
+    return (request) => replay(build(request));
+}
+export function testRouter(adapter) {
+    return {
+        resolve: async () => {
+            throw new Error("not used by the driver");
+        },
+        adapterFor: () => adapter,
+        reportFailure: () => undefined,
+        proposeProviderChange: () => {
+            throw new Error("not used by the driver");
+        },
+        applyProviderChange: () => undefined,
+    };
+}
+/**
+ * Rebuilds the model input from the log on every step: one system block plus every recorded
+ * message (blobs resolved). Deterministic, so the same log always yields the same envelope.
+ */
+export function createLogContextBuilder(events, blobs, tools) {
+    return {
+        async build(input) {
+            const messages = [];
+            for await (const item of events.read()) {
+                if (item.status !== "ok")
+                    continue;
+                if (item.event.type === "message/recorded")
+                    messages.push(await loadRecordedMessage(item.event, blobs));
+                if (item.event.type === "steer/queued")
+                    messages.push({ role: "user", content: [{ type: "text", text: item.event.data.text }] });
+            }
+            const systemText = `You are the ${input.role}.`;
+            const request = {
+                request_id: input.requestId,
+                route: input.route,
+                system: [{ id: "role", source: "role", trust: "harness", text: systemText, digest: digestText(systemText) }],
+                messages,
+                tools: [...tools.visibleTo(input.role, input.policy)],
+            };
+            return {
+                ok: true,
+                request,
+                envelopeDigest: digestOf(request),
+                blocks: [
+                    { blockId: "role", source: "role", trust: "harness", tokensEstimate: 8, truncated: false },
+                    { blockId: "history", source: "history", trust: "untrusted", tokensEstimate: messages.length * 10, truncated: false },
+                ],
+                memories: [],
+            };
+        },
+    };
+}
+export function testRegistry(names = ["read_file", "exec"]) {
+    return {
+        register: () => undefined,
+        get: (name) => (names.includes(name) ? { metadata: { name } } : undefined),
+        visibleTo: () => names.map((name) => ({ name, description: `${name} tool`, input_schema: { type: "object" } })),
+    };
+}
+export class RecordingToolGateway {
+    invocations = [];
+    #events;
+    #handler;
+    #options;
+    #nextRef = 1;
+    constructor(events, handler = async (request) => ({ status: "ok", text: `ran ${request.tool_name}`, truncated: false, redactions: 0 }), options = {}) {
+        this.#events = events;
+        this.#handler = handler;
+        this.#options = options;
+    }
+    async invoke(request, scope, signal) {
+        const correlation = { run_id: scope.runId, ...(scope.taskId === undefined ? {} : { task_id: scope.taskId }) };
+        const actor = { kind: "system" };
+        const ref = this.#options.refs === true ? this.#nextRef++ : undefined;
+        await this.#events.append({
+            type: "tool/call_proposed",
+            event_version: EVENT_VERSIONS["tool/call_proposed"],
+            actor,
+            ...correlation,
+            data: {
+                tool_call_id: request.tool_call_id,
+                provider_call_id: request.provider_call_id,
+                tool_name: request.tool_name,
+                args_digest: digestOf(request.arguments),
+                ...(ref === undefined ? {} : { ref }),
+            },
+        });
+        await this.#events.append({
+            type: "tool/execution_started",
+            event_version: EVENT_VERSIONS["tool/execution_started"],
+            actor,
+            ...correlation,
+            data: { tool_call_id: request.tool_call_id, sandbox_enforcement: "partial" },
+        });
+        this.invocations.push(request);
+        const started = Date.now();
+        let result;
+        try {
+            result = await this.#handler(request, signal);
+        }
+        catch (error) {
+            result = { status: "error", text: "", truncated: false, redactions: 0, error: { code: "execution_failed", message: error instanceof Error ? error.message : String(error) } };
+        }
+        const state = signal.aborted ? "cancelled" : result.status === "ok" ? "succeeded" : "failed";
+        await this.#events.append({
+            type: "tool/result_recorded",
+            event_version: EVENT_VERSIONS["tool/result_recorded"],
+            actor,
+            ...correlation,
+            data: { tool_call_id: request.tool_call_id, state, result, duration_ms: Date.now() - started },
+        });
+        const endsTurn = state === "succeeded" && result.status === "ok" && (this.#options.terminalTools ?? []).includes(request.tool_name);
+        return {
+            toolCallId: request.tool_call_id,
+            state,
+            result,
+            decision: undefined,
+            approval: undefined,
+            ...(ref === undefined ? {} : { ref }),
+            ...(endsTurn ? { endsTurn } : {}),
+        };
+    }
+}
+/** An `AgentBackendAdapter` whose single session runs `script`, calling Synorch tools through the bridge. */
+export class ScriptedBackendAdapter {
+    kind = "agent-backend";
+    adapterId = "scripted-backend";
+    providerId = "anthropic";
+    authMethod = "cli-bridge";
+    sessions = [];
+    #script;
+    constructor(script) {
+        this.#script = script;
+    }
+    async probe() {
+        throw new Error("not used by the driver");
+    }
+    async discoverCapabilities() {
+        throw new Error("not used by the driver");
+    }
+    async startSession(options) {
+        const record = { resumed: options.resumeBackendSessionId, closed: false, interrupted: false };
+        this.sessions.push(record);
+        const script = this.#script;
+        return {
+            backendSessionId: `backend-${this.sessions.length}`,
+            runTurn: (input, bridges) => script(bridges.tools, { requestId: input.requestId }),
+            interrupt: async () => {
+                record.interrupted = true;
+            },
+            close: async () => {
+                record.closed = true;
+            },
+        };
+    }
+    async health() {
+        throw new Error("not used by the driver");
+    }
+}
+export function newRunId() {
+    return createId("run");
+}
+//# sourceMappingURL=testing.js.map

package/dist/harness/core/testing.js.map

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

package/dist/harness/mcp/approvals.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Project MCP servers are repository content: each is spawned only after the user approved exactly
+ * that definition (digest) for exactly that workspace root. Stored in the user scope
+ * (`<synorch home>/mcp-approvals.json`), never in a repository.
+ */
+export declare const MCP_APPROVALS_FILE = "mcp-approvals.json";
+export interface McpApprovalStore {
+    readonly file: string;
+    isApproved(root: string, name: string, digest: string): boolean;
+    approve(root: string, name: string, digest: string): Promise<void>;
+    revoke(root: string, name: string): Promise<boolean>;
+}
+export declare function createMcpApprovalStore(home: string, now?: () => Date): McpApprovalStore;
+//# sourceMappingURL=approvals.d.ts.map

package/dist/harness/mcp/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../../src/harness/mcp/approvals.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAQvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,IAAuB,GAAG,gBAAgB,CAuCzG"}

package/dist/harness/mcp/approvals.js

@@ -0,0 +1,60 @@
+import { randomBytes } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+/**
+ * Project MCP servers are repository content: each is spawned only after the user approved exactly
+ * that definition (digest) for exactly that workspace root. Stored in the user scope
+ * (`<synorch home>/mcp-approvals.json`), never in a repository.
+ */
+export const MCP_APPROVALS_FILE = "mcp-approvals.json";
+const fileSchema = z.strictObject({
+    schema_version: z.literal(1),
+    approvals: z.array(z.strictObject({ root: z.string().min(1), name: z.string().min(1), digest: z.string().min(1), approved_at: z.string().min(1) })).max(4096),
+});
+export function createMcpApprovalStore(home, now = () => new Date()) {
+    const file = path.join(path.resolve(home), MCP_APPROVALS_FILE);
+    const read = () => {
+        try {
+            const parsed = fileSchema.safeParse(JSON.parse(readFileSync(file, "utf8")));
+            if (parsed.success)
+                return parsed.data;
+        }
+        catch {
+            // Missing or unreadable: nothing is approved.
+        }
+        return { schema_version: 1, approvals: [] };
+    };
+    const persist = async (data) => {
+        await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+        const temporary = `${file}.${randomBytes(6).toString("hex")}.tmp`;
+        try {
+            await writeFile(temporary, `${JSON.stringify(data, null, 2)}\n`, { mode: 0o600, flag: "wx" });
+            await rename(temporary, file);
+        }
+        catch (error) {
+            await rm(temporary, { force: true }).catch(() => undefined);
+            throw error;
+        }
+    };
+    return {
+        file,
+        isApproved: (root, name, digest) => read().approvals.some((entry) => entry.root === root && entry.name === name && entry.digest === digest),
+        async approve(root, name, digest) {
+            const data = read();
+            const approvals = data.approvals.filter((entry) => !(entry.root === root && entry.name === name));
+            approvals.push({ root, name, digest, approved_at: now().toISOString() });
+            await persist({ schema_version: 1, approvals });
+        },
+        async revoke(root, name) {
+            const data = read();
+            const approvals = data.approvals.filter((entry) => !(entry.root === root && entry.name === name));
+            if (approvals.length === data.approvals.length)
+                return false;
+            await persist({ schema_version: 1, approvals });
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=approvals.js.map

package/dist/harness/mcp/approvals.js.map

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

package/dist/harness/mcp/client.d.ts

@@ -0,0 +1,74 @@
+import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
+import type { McpServerDefinition } from "./config.ts";
+/**
+ * One live connection to an MCP server through the official TypeScript SDK (stdio, streamable
+ * HTTP, or legacy SSE). The server's stderr goes to a log file (`<logs>/<server>.log`), never to
+ * the terminal; its last lines are kept for `/mcp` and error messages. The SDK is loaded on the
+ * first connection only, so sessions without MCP servers never pay for it.
+ */
+export interface McpToolInfo {
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: Readonly<Record<string, unknown>> | undefined;
+}
+export interface McpContentPart {
+    readonly type: string;
+    readonly text?: string;
+    readonly data?: string;
+    readonly mimeType?: string;
+    readonly uri?: string;
+    readonly name?: string;
+    readonly resource?: {
+        readonly uri?: string;
+        readonly text?: string;
+        readonly mimeType?: string;
+        readonly blob?: string;
+    };
+}
+export interface McpCallResult {
+    readonly content: readonly McpContentPart[];
+    readonly structuredContent: unknown;
+    readonly isError: boolean;
+}
+export interface McpConnectOptions {
+    readonly workspaceRoot: string;
+    readonly logDirectory: string;
+    readonly clientVersion: string;
+    /** Parent environment for extra pass-through variables (proxies, Windows shell basics). */
+    readonly environment: Readonly<Record<string, string | undefined>>;
+    readonly platform?: NodeJS.Platform;
+    /** Remote servers: the stored MCP OAuth sign-in (tokens attached and refreshed by the SDK). */
+    readonly authProvider?: OAuthClientProvider;
+}
+export declare class McpConnection {
+    readonly definition: McpServerDefinition;
+    tools: readonly McpToolInfo[];
+    serverVersion: string | undefined;
+    private readonly client;
+    private readonly transport;
+    /** The stdio transport (pid, stderr), when the server is a local process. */
+    private readonly stdio;
+    private readonly log;
+    private readonly platform;
+    private stderrTail;
+    private closed;
+    private disposed;
+    private readonly closeListeners;
+    private constructor();
+    /** Connects, initializes and lists the tools; throws with the server's last stderr lines on failure. */
+    static connect(definition: McpServerDefinition, options: McpConnectOptions): Promise<McpConnection>;
+    get isClosed(): boolean;
+    get lastStderr(): string;
+    onClose(listener: (reason: string) => void): () => void;
+    callTool(name: string, args: Readonly<Record<string, unknown>>, signal: AbortSignal, timeoutMs: number): Promise<McpCallResult>;
+    close(): Promise<void>;
+    /** Synchronous best effort for process exit handlers. */
+    killSync(): void;
+    private listAllTools;
+    private noteStderr;
+    private markClosed;
+}
+/** Where a server's stderr log lives. */
+export declare function mcpLogFile(logDirectory: string, name: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/harness/mcp/client.d.ts.map

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