import type { PiIntegrationTestArtifacts, PiIntegrationTestOptions, PiIntegrationTestResult } from "../scenario/types.js";
export interface PiIntegrationTestRuntimeArtifacts {
    readonly directory: string;
    readonly config: string;
    readonly sessionDirectory: string;
    readonly terminalOutput: string;
    readonly trace: string;
    readonly tuiRenderedOutput: string;
}
interface PrepareArtifactsInput {
    readonly artifacts: PiIntegrationTestArtifacts;
    readonly runtime: PiIntegrationTestRuntimeArtifacts;
    readonly options: PiIntegrationTestOptions;
}
export declare function createIntegrationTestArtifacts(options: PiIntegrationTestOptions): PiIntegrationTestArtifacts;
export declare function createIntegrationTestRuntimeArtifacts(artifacts: PiIntegrationTestArtifacts): PiIntegrationTestRuntimeArtifacts;
export declare function prepareIntegrationTestArtifacts(input: PrepareArtifactsInput): Promise<void>;
export declare function writeRunBundle(artifacts: PiIntegrationTestArtifacts, runtime: PiIntegrationTestRuntimeArtifacts, cwd: string, options: PiIntegrationTestOptions, prompt: string, result: PiIntegrationTestResult, outcome: {
    status: "settled" | "timeout" | "error";
    startedMonotonicMs: number;
    endedMonotonicMs: number;
}): Promise<void>;
/** Save completed trace records on failure, retaining the raw tail for diagnosis. */
export declare function writePartialRunBundle(artifacts: PiIntegrationTestArtifacts, runtime: PiIntegrationTestRuntimeArtifacts, cwd: string, options: PiIntegrationTestOptions, prompt: string, error: unknown, startedMonotonicMs: number): Promise<void>;
export declare function writeIntegrationTestError(artifacts: PiIntegrationTestArtifacts, error: unknown): Promise<void>;
export declare function removeIntegrationTestRuntimeArtifacts(runtime: PiIntegrationTestRuntimeArtifacts): Promise<void>;
/**
 * Return a stable artifact group for an integration test source file.
 *
 * Pass `import.meta.filename` (or the test runner's equivalent). The source file must
 * be inside `process.cwd()` so the returned path cannot escape the artifact root.
 */
export declare function testArtifactsDir(testPath: string | undefined, root?: string): string;
export {};