@mongodb-js/harness-tester 3.0.0-prerelease.4 → 3.0.4

package/dist/harness/shared.js

@@ -0,0 +1,46 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Canonicalize a path so config keys match the agent's view of the filesystem
+ * (macOS resolves `/var` -> `/private/var`; a non-canonical key silently misses).
+ */
+export function canonicalPath(p) {
+    try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return path.resolve(p);
+    }
+}
+/** New content = everything after the previous snapshot (scrollback grows monotonically). */
+export function diffTranscript(full, start) {
+    const idx = full.indexOf(start);
+    return idx >= 0 ? full.slice(idx + start.length) : full;
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Debug switch: single `AGENT_E2E_DEBUG` env var for the whole harness. */
+export function isHarnessDebug() {
+    return !!process.env.AGENT_E2E_DEBUG;
+}
+/** Default timeout for a single `prompt()` turn. */
+export const DEFAULT_PROMPT_TIMEOUT_MS = 2 * 60 * 1000;
+const SUPPORTED_TUI_BACKENDS = ["alacritty", "ghostty", "rio"];
+/** Validate an env-var backend override (`AGENT_E2E_TUI_BACKEND`) against the supported backends. */
+export function resolveBackend(explicit) {
+    if (explicit) {
+        return explicit;
+    }
+    const fromEnv = process.env.AGENT_E2E_TUI_BACKEND;
+    if (fromEnv && SUPPORTED_TUI_BACKENDS.includes(fromEnv)) {
+        return fromEnv;
+    }
+    return "alacritty";
+}
+/** Strip the `<server>.` / `mcp__<server>__` prefix agents render before tool names. */
+export function normalizeToolName(name) {
+    const lastSegment = name.split(/__|\./).pop();
+    return lastSegment ?? name;
+}
+//# sourceMappingURL=shared.js.map

package/dist/harness/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/harness/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACnC,IAAI,CAAC;QACD,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AACzC,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,MAAM,sBAAsB,GAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAEnF,qGAAqG;AACrG,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAClD,IAAI,OAAO,IAAK,sBAA4C,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,OAAO,OAAkB,CAAC;IAC9B,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;IAC9C,OAAO,WAAW,IAAI,IAAI,CAAC;AAC/B,CAAC"}

package/dist/harness/tuiSession.d.ts

@@ -0,0 +1,73 @@
+import type { TuiTest } from "@microsoft/tui-test";
+import type { AgentHarnessOptions, AgentSession, AgentTurn, AgentTurnState, ToolCallRecord } from "./types.js";
+/** Per-poll state shared by both agent TUI sessions. */
+export interface TuiState {
+    /** True while the session's status/footer shows an in-progress turn. */
+    working: boolean;
+    /** True once the composer shows its idle line (turn finished). */
+    composerIdle: boolean;
+    /** Full live viewport text (or the transcript when the viewport is gone). */
+    viewport: string;
+    /** ms since the poll loop started (first poll after Enter). */
+    elapsedMs: number;
+}
+/**
+ * Shared polling loop + terminal helpers for agent TUI sessions. Subclasses
+ * supply only the agent-specific bits: the label, the in-progress and idle
+ * markers, and how to extract tool calls for a completed turn.
+ */
+export declare abstract class TuiSessionBase implements AgentSession {
+    protected readonly terminal: TuiTest;
+    protected readonly options: AgentHarnessOptions;
+    private readonly onState;
+    private _log;
+    /** Length of the turn delta already streamed to stdout (debug streaming). */
+    private lastShownDeltaLength;
+    /** Transcript snapshot the current turn started from (so chooseOption can continue it). */
+    private currentTurnStartText;
+    private currentState;
+    get state(): AgentTurnState;
+    protected constructor({ terminal, options, onState, }: {
+        terminal: TuiTest;
+        options: AgentHarnessOptions;
+        onState?: (state: TuiState) => void;
+    });
+    /** Agent label used in debug/error output (e.g. "codex"). */
+    protected abstract get label(): string;
+    private get log();
+    /** Whether the viewport shows an in-progress turn. */
+    protected abstract isWorking(text: string): boolean;
+    /** Whether the composer has returned to idle (turn finished). */
+    protected abstract isComposerIdle(text: string): boolean;
+    /** Extract tool calls for a completed turn's transcript delta. */
+    protected abstract extractToolCalls(delta: string): ToolCallRecord[];
+    /** Wait until the composer is ready for a prompt. */
+    initialise(): Promise<void>;
+    /**
+     * Answer a pending elicitation (`confirm`/`decline`) and run the turn to
+     * completion, returning the completed {@link AgentTurn}.
+     */
+    chooseOption(choice: "confirm" | "decline"): Promise<AgentTurn>;
+    /**
+     * Submit `choice` in the confirmation prompt currently on screen. Each agent
+     * renders it with different labels/controls, so subclasses implement this.
+     */
+    protected abstract sendChoice(choice: "confirm" | "decline"): Promise<void>;
+    /** Codex interposes its own tool-approval prompt before the server's elicitation. */
+    protected isToolApproval(text: string): boolean;
+    protected approveTool(): Promise<void>;
+    prompt(prompt: string): Promise<AgentTurn>;
+    /**
+     * Poll until the turn completes or, when `stopOnElicitation`, the agent is
+     * awaiting a confirmation (auto-approving codex's tool-permission prompt).
+     */
+    private pollTurn;
+    /** Whether the composer has returned to its idle prompt (turn finished). */
+    private waitIdleComposer;
+    private viewportText;
+    private transcriptText;
+    private buildTurn;
+    private printState;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=tuiSession.d.ts.map

package/dist/harness/tuiSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuiSession.d.ts","sourceRoot":"","sources":["../../src/harness/tuiSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAY/G,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACrB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,8BAAsB,cAAe,YAAW,YAAY;IACxD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,IAAI,CAA4B;IACxC,6EAA6E;IAC7E,OAAO,CAAC,oBAAoB,CAAqB;IACjD,2FAA2F;IAC3F,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,YAAY,CAA+B;IAEnD,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,SAAS,aAAa,EAClB,QAAQ,EACR,OAAO,EACP,OAAO,GACV,EAAE;QACC,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;KACvC;IAMD,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC;IACvC,OAAO,KAAK,GAAG,GAEd;IACD,sDAAsD;IACtD,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IACnD,iEAAiE;IACjE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IACxD,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAEpE,qDAAqD;IAC/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAKrE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3E,qFAAqF;IACrF,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;cAI/B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAShD;;;OAGG;YACW,QAAQ;IA0GtB,4EAA4E;YAC9D,gBAAgB;YAahB,YAAY;YAIZ,cAAc;YAId,SAAS;IAgBvB,OAAO,CAAC,UAAU;IAWZ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}

package/dist/harness/tuiSession.js

@@ -0,0 +1,202 @@
+import { DEFAULT_PROMPT_TIMEOUT_MS, diffTranscript, sleep } from "./shared.js";
+import { HarnessLogger } from "./logger.js";
+/** Delay between typing a prompt and pressing Enter (agents drop a same-tick Enter). */
+const TYPE_TO_ENTER_DELAY_MS = 800;
+/** How long an idle+not-working composer may persist before we accept a turn as complete
+ * even without observing the turn start (guard against pathological no-activity hangs). */
+const IDLE_BAIL_GRACE_MS = 30000;
+/** How long the not-working+not-idle state must persist before we treat it as an awaited confirmation. */
+const CONFIRMATION_PENDING_GRACE_MS = 1000;
+/**
+ * Shared polling loop + terminal helpers for agent TUI sessions. Subclasses
+ * supply only the agent-specific bits: the label, the in-progress and idle
+ * markers, and how to extract tool calls for a completed turn.
+ */
+export class TuiSessionBase {
+    get state() {
+        return this.currentState;
+    }
+    constructor({ terminal, options, onState, }) {
+        /** Transcript snapshot the current turn started from (so chooseOption can continue it). */
+        this.currentTurnStartText = "";
+        this.currentState = "completed";
+        this.terminal = terminal;
+        this.options = options;
+        this.onState = onState ?? ((state) => this.printState(state));
+    }
+    get log() {
+        return (this._log ?? (this._log = new HarnessLogger(`${this.label}-tui`)));
+    }
+    /** Wait until the composer is ready for a prompt. */
+    async initialise() {
+        await this.waitIdleComposer(30000);
+    }
+    /**
+     * Answer a pending elicitation (`confirm`/`decline`) and run the turn to
+     * completion, returning the completed {@link AgentTurn}.
+     */
+    async chooseOption(choice) {
+        await this.sendChoice(choice);
+        return this.pollTurn(false);
+    }
+    /** Codex interposes its own tool-approval prompt before the server's elicitation. */
+    isToolApproval(text) {
+        return /Allow the .* MCP server to run tool/.test(text);
+    }
+    async approveTool() {
+        await this.terminal.keyboard.press("Enter");
+    }
+    async prompt(prompt) {
+        // Enter after a short settle: agents drop a same-tick Enter, leaving the prompt in the composer.
+        this.currentTurnStartText = await this.transcriptText();
+        await this.terminal.type(prompt);
+        await sleep(TYPE_TO_ENTER_DELAY_MS);
+        await this.terminal.keyboard.press("Enter");
+        return this.pollTurn(true);
+    }
+    /**
+     * Poll until the turn completes or, when `stopOnElicitation`, the agent is
+     * awaiting a confirmation (auto-approving codex's tool-permission prompt).
+     */
+    async pollTurn(stopOnElicitation) {
+        const startText = this.currentTurnStartText;
+        const timeoutMs = this.options.promptTimeoutMs ?? DEFAULT_PROMPT_TIMEOUT_MS;
+        const deadline = Date.now() + timeoutMs;
+        const startedAt = Date.now();
+        let lastError = "";
+        // A turn is only "real" once we have observed it begin: the working marker,
+        // the composer leaving its idle placeholder, or the transcript growing past
+        // the prompt echo. Without this the first poll after Enter (before the agent
+        // has rendered anything) satisfies `!working && composerIdle` and returns a
+        // bogus empty turn.
+        let sawTurnActivity = false;
+        let confirmationPendingSinceMs;
+        let prevDeltaLength;
+        let idleSinceMs;
+        while (Date.now() < deadline) {
+            const full = await this.transcriptText();
+            const delta = diffTranscript(full, startText);
+            const viewport = await this.viewportText();
+            const state = {
+                working: this.isWorking(viewport),
+                composerIdle: this.isComposerIdle(viewport),
+                viewport,
+                elapsedMs: Date.now() - startedAt,
+            };
+            this.onState(state);
+            if (state.working ||
+                !state.composerIdle ||
+                (prevDeltaLength !== undefined && delta.length > prevDeltaLength)) {
+                sawTurnActivity = true;
+            }
+            prevDeltaLength = delta.length;
+            // Agent is awaiting input when not working and not idle; require that
+            // state to persist a couple of polls so we do not fire mid-transition.
+            if (sawTurnActivity && !state.working && !state.composerIdle) {
+                confirmationPendingSinceMs ?? (confirmationPendingSinceMs = state.elapsedMs);
+                if (state.elapsedMs - confirmationPendingSinceMs >= CONFIRMATION_PENDING_GRACE_MS) {
+                    if (this.isToolApproval(viewport)) {
+                        await this.approveTool();
+                        confirmationPendingSinceMs = undefined;
+                        continue;
+                    }
+                    if (stopOnElicitation) {
+                        this.currentState = "elicitation";
+                        this.lastShownDeltaLength = delta.length;
+                        return { text: delta, toolCalls: [], state: "elicitation", confirmation: viewport };
+                    }
+                }
+            }
+            else {
+                confirmationPendingSinceMs = undefined;
+            }
+            // Turn done when the in-progress marker is gone and the composer is idle.
+            if (!state.working && state.composerIdle) {
+                if (sawTurnActivity ||
+                    (idleSinceMs !== undefined && state.elapsedMs - idleSinceMs >= IDLE_BAIL_GRACE_MS)) {
+                    this.log.debug(`<<turn complete after ${state.elapsedMs}ms>>`);
+                    this.onState({
+                        ...state,
+                        viewport: `turn complete after ${state.elapsedMs}ms\n` + delta.slice(-1200),
+                    });
+                    return await this.buildTurn(startText);
+                }
+                idleSinceMs ?? (idleSinceMs = state.elapsedMs);
+            }
+            else {
+                idleSinceMs = undefined;
+            }
+            // Debug: stream the transcript as it grows.
+            if (delta.length > (this.lastShownDeltaLength ?? 0)) {
+                const chunk = delta.slice(this.lastShownDeltaLength ?? 0);
+                this.log.debug(chunk);
+                this.lastShownDeltaLength = delta.length;
+            }
+            // Session exited (e.g. the TUI crashed).
+            const exitCode = await this.terminal.getExitCode().catch(() => null);
+            if (exitCode !== null) {
+                lastError = `${this.label} TUI exited with code ${exitCode}`;
+                break;
+            }
+            lastError = "";
+            await sleep(500);
+        }
+        const text = await this.transcriptText();
+        const delta = diffTranscript(text, startText);
+        const message = lastError || `${this.label} TUI turn timed out after ${timeoutMs}ms`;
+        this.log.debug(`<<aborting: ${message}>>\n${delta}`);
+        this.currentState = "completed";
+        // Fail loudly with the raw transcript attached for diagnosis.
+        return {
+            text: `ERROR: ${message}${text ? "\n\n--- terminal content ---\n" + text : ""}`,
+            toolCalls: [],
+            state: "completed",
+        };
+    }
+    /** Whether the composer has returned to its idle prompt (turn finished). */
+    async waitIdleComposer(timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        let text = "";
+        while (Date.now() < deadline) {
+            text = await this.viewportText();
+            if (!this.isWorking(text) && this.isComposerIdle(text)) {
+                return;
+            }
+            await sleep(1000);
+        }
+        throw new Error(`${this.label} TUI composer did not become idle within ${timeoutMs}ms:\n${text.slice(-2000)}`);
+    }
+    async viewportText() {
+        return this.terminal.text({ full: false });
+    }
+    async transcriptText() {
+        return this.terminal.text({ full: true });
+    }
+    async buildTurn(startText) {
+        const full = await this.transcriptText();
+        let delta = diffTranscript(full, startText);
+        // Append the viewport: the final reply may still be live, not in the scrollback.
+        const viewport = await this.viewportText();
+        if (viewport && !delta.includes(viewport.replace(/\s+$/, ""))) {
+            delta = delta + "\n" + viewport;
+        }
+        this.currentState = "completed";
+        return {
+            text: delta,
+            toolCalls: this.extractToolCalls(delta),
+            state: "completed",
+        };
+    }
+    printState(state) {
+        const tail = state.viewport
+            .split("\n")
+            .filter((l) => l.trim())
+            .slice(-7);
+        this.log.debug(`t=${Math.round(state.elapsedMs / 1000)}s working=${state.working} idle=${state.composerIdle}\n` +
+            tail.join("\n"));
+    }
+    async dispose() {
+        await this.terminal.closeQuiet();
+    }
+}
+//# sourceMappingURL=tuiSession.js.map

package/dist/harness/tuiSession.js.map

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

package/dist/harness/types.d.ts

@@ -0,0 +1,91 @@
+export interface ToolCallRecord {
+    /** Normalized tool name, e.g. "mcp__server__list-databases" -> "list-databases". */
+    name: string;
+    /** The raw tool name as reported by the harness, when it differs. */
+    rawName?: string;
+    /** Tool arguments as reported by the harness (best-effort). */
+    args?: unknown;
+}
+export interface AgentTurn {
+    /** Raw terminal content captured at the end of the turn (scrollback delta + live viewport). */
+    text: string;
+    /** Tool calls observed during the turn, deduplicated. */
+    toolCalls: ToolCallRecord[];
+    /** "elicitation" when the turn paused for a confirmation; otherwise "completed". */
+    state: AgentTurnState;
+    /** Raw confirmation screen when `state` is "elicitation". */
+    confirmation?: string;
+}
+/** How a turn ended: completed normally, or paused for an elicitation confirmation. */
+export type AgentTurnState = "completed" | "elicitation";
+export interface AgentHarnessOptions {
+    /**
+     * URL of the MongoDB MCP server (streamable HTTP), e.g.
+     * `http://127.0.0.1:PORT/mcp`. Mutually exclusive with `stdioServer`.
+     */
+    serverUrl?: string;
+    /**
+     * Stdio server spec; when set, the harness spawns the MCP server itself.
+     * Mutually exclusive with `serverUrl`.
+     */
+    stdioServer?: {
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+    };
+    /** Name under which the MCP server is registered with the harness. */
+    mcpServerName?: string;
+    /** Working directory for the harness session (created by the test). */
+    workDir: string;
+    /** Optional model override (harness/provider default used when omitted). */
+    model?: string;
+    /** Timeout for a single `prompt()` call (ms). */
+    promptTimeoutMs?: number;
+    /** Dump the generated config (redacted) to the test logs. */
+    debug?: boolean;
+}
+export interface AgentHarness {
+    readonly name: string;
+    /**
+     * True when the binary + auth are available (tests skip otherwise).
+     * Must be synchronous: `describe.skipIf` treats a Promise as truthy.
+     */
+    isAvailable(): boolean;
+    start(options: AgentHarnessOptions): Promise<AgentSession>;
+}
+export interface AgentSession {
+    /**
+     * Run one turn: submit the prompt and wait. Resolves with
+     * `state: "elicitation"` when the agent is awaiting a confirmation
+     * (call {@link AgentSession.chooseOption}), else `state: "completed"`.
+     */
+    prompt(prompt: string): Promise<AgentTurn>;
+    /**
+     * Answer a pending elicitation (`confirm`/`decline`) and run the turn to
+     * completion, returning the completed `AgentTurn`.
+     */
+    chooseOption(choice: "confirm" | "decline"): Promise<AgentTurn>;
+    /** Current state of the last turn: "completed" or "elicitation". */
+    readonly state: AgentTurnState;
+    /** Release any resources. */
+    dispose(): Promise<void>;
+}
+/** Config generator for an agent CLI harness: builds agent-specific config content for a hermetic session. */
+export interface AgentHarnessConfig {
+    /**
+     * Env var pointing the agent at its config home (e.g. `"CODEX_HOME"`);
+     * set to a per-session hermetic directory.
+     */
+    readonly homeDirEnvVar: string;
+    /** Config file within the home dir (e.g. `"config.toml"`); empty when the config is the whole home dir. */
+    readonly configFileName: string;
+    /** The developer's real config home (e.g. `~/.codex`), read without mutating it. */
+    getHostHomeDir(): string;
+    /**
+     * Build the agent-specific config file content for a hermetic session.
+     * @param sessionHomeDir per-session hermetic home the file is written into
+     *        (configs can reference files placed next to it).
+     */
+    buildConfig(options: AgentHarnessOptions, sessionHomeDir: string): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,oFAAoF;IACpF,KAAK,EAAE,cAAc,CAAC;IACtB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uFAAuF;AACvF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/E,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC;IACvB,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChE,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,6BAA6B;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,8GAA8G;AAC9G,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,2GAA2G;IAC3G,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,oFAAoF;IACpF,cAAc,IAAI,MAAM,CAAC;IAEzB;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7E"}

package/dist/harness/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":""}

package/dist/harnesses.d.ts

@@ -0,0 +1,3 @@
+import type { AgentHarness } from "./harness/types.js";
+export declare const AGENT_HARNESSES: readonly (new () => AgentHarness)[];
+//# sourceMappingURL=harnesses.d.ts.map

package/dist/harnesses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnesses.d.ts","sourceRoot":"","sources":["../src/harnesses.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,UAAU,YAAY,CAAC,EAAwC,CAAC"}

package/dist/harnesses.js

@@ -0,0 +1,4 @@
+import { CodexTuiHarness } from "./harness/codex/codexHarness.js";
+import { ClaudeTuiHarness } from "./harness/claude/claudeHarness.js";
+export const AGENT_HARNESSES = [CodexTuiHarness, ClaudeTuiHarness];
+//# sourceMappingURL=harnesses.js.map

package/dist/harnesses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnesses.js","sourceRoot":"","sources":["../src/harnesses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,MAAM,CAAC,MAAM,eAAe,GAAwC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { ClaudeTuiHarness } from "./harness/claude/claudeHarness.js";
+import { CodexTuiHarness } from "./harness/codex/codexHarness.js";
+export { useAgent, type AgentContext } from "./useAgent.js";
+export { AGENT_HARNESSES } from "./harnesses.js";
+export type { AgentHarness, AgentHarnessConfig, AgentHarnessOptions, AgentSession, AgentTurn, AgentTurnState, ToolCallRecord, } from "./harness/types.js";
+export { ClaudeTuiHarness, CodexTuiHarness };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EACR,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+import { ClaudeTuiHarness } from "./harness/claude/claudeHarness.js";
+import { CodexTuiHarness } from "./harness/codex/codexHarness.js";
+export { useAgent } from "./useAgent.js";
+export { AGENT_HARNESSES } from "./harnesses.js";
+export { ClaudeTuiHarness, CodexTuiHarness };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUjD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC"}

package/dist/useAgent.d.ts

@@ -0,0 +1,16 @@
+import type { AgentHarness, AgentHarnessOptions } from "./harness/types.js";
+export interface AgentContext {
+    harness: AgentHarness;
+    workDir: () => string;
+    /** Cached availability probe; the skip gate doesn't re-probe per test. */
+    isHarnessAvailable: () => boolean;
+    buildOptions: (overrides?: Partial<AgentHarnessOptions>) => AgentHarnessOptions;
+}
+/**
+ * Agent e2e suite setup: temp workdir, availability skip gate, and base
+ * session options. Call inside a `describe` block with the harness to drive.
+ */
+export declare function useAgent({ harness }: {
+    harness: AgentHarness;
+}): AgentContext;
+//# sourceMappingURL=useAgent.d.ts.map

package/dist/useAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.d.ts","sourceRoot":"","sources":["../src/useAgent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAClC,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,KAAK,mBAAmB,CAAC;CACnF;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG,YAAY,CA0C7E"}

package/dist/useAgent.js

@@ -0,0 +1,47 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterAll, beforeAll, beforeEach } from "vitest";
+import { DEFAULT_PROMPT_TIMEOUT_MS } from "./harness/shared.js";
+/**
+ * Agent e2e suite setup: temp workdir, availability skip gate, and base
+ * session options. Call inside a `describe` block with the harness to drive.
+ */
+export function useAgent({ harness }) {
+    let workDir = "";
+    let harnessAvailable;
+    const isHarnessAvailable = () => (harnessAvailable ?? (harnessAvailable = harness.isAvailable()));
+    beforeAll(async () => {
+        workDir = await fs.mkdtemp(path.join(os.tmpdir(), "e2e-tests-"));
+    });
+    beforeEach((ctx) => {
+        if (!isHarnessAvailable()) {
+            ctx.skip(`harness '${harness.name}' not available; agent e2e suite skipped`);
+        }
+    });
+    afterAll(async () => {
+        if (workDir) {
+            await fs.rm(workDir, { recursive: true, force: true });
+        }
+    });
+    return {
+        harness,
+        workDir: () => workDir,
+        isHarnessAvailable,
+        buildOptions: (overrides = {}) => ({
+            workDir,
+            // Model: per-harness env var > shared AGENT_E2E_MODEL > harness default.
+            ...(() => {
+                const model = (harness.name === "codex-tui" && process.env.AGENT_E2E_CODEX_MODEL) ||
+                    (harness.name === "claude-tui" && process.env.AGENT_E2E_CLAUDE_MODEL) ||
+                    process.env.AGENT_E2E_MODEL;
+                return model ? { model } : {};
+            })(),
+            promptTimeoutMs: DEFAULT_PROMPT_TIMEOUT_MS,
+            // AGENT_E2E_DEBUG: per-session debug dumps across the suite.
+            debug: !!process.env.AGENT_E2E_DEBUG,
+            ...overrides,
+        }),
+    };
+}
+//# sourceMappingURL=useAgent.js.map

package/dist/useAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.js","sourceRoot":"","sources":["../src/useAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAWhE;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,OAAO,EAA6B;IAC3D,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,IAAI,gBAAqC,CAAC;IAC1C,MAAM,kBAAkB,GAAG,GAAY,EAAE,CAAC,CAAC,gBAAgB,KAAhB,gBAAgB,GAAK,OAAO,CAAC,WAAW,EAAE,EAAC,CAAC;IAEvF,SAAS,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,IAAI,0CAA0C,CAAC,CAAC;QACjF,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAChB,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;QACtB,kBAAkB;QAClB,YAAY,EAAE,CAAC,SAAS,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO;YACP,yEAAyE;YACzE,GAAG,CAAC,GAAuB,EAAE;gBACzB,MAAM,KAAK,GACP,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;oBACnE,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;oBACrE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;gBAChC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClC,CAAC,CAAC,EAAE;YACJ,eAAe,EAAE,yBAAyB;YAC1C,6DAA6D;YAC7D,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe;YACpC,GAAG,SAAS;SACf,CAAC;KACkB,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mongodb-js/harness-tester",
-  "version": "3.0.0-prerelease.4",
+  "version": "3.0.4",
   "type": "module",
   "description": "Tooling to drive real LLM coding-agent CLIs (codex, claude) interactively through their TUIs for end-to-end tests",
   "license": "Apache-2.0",
@@ -20,10 +20,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc --build tsconfig.build.json",
-    "check": "tsc --noEmit --project tsconfig.json"
-  },
   "dependencies": {
     "@microsoft/tui-test": "0.1.0-beta.2",
     "vitest": "^4.1.5"
@@ -34,5 +30,9 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "check": "tsc --noEmit --project tsconfig.json"
   }
-}
+}