/** Directory for spooled command output (under the wstack global root). */
export declare function toolOutputDir(): string;
/** Reset module state — test hook (per-process sweep memo + nothing else). */
export declare function _resetOutputSpoolForTests(): void;
interface SpoolInfo {
    /** Absolute path of the spool file. */
    path: string;
    /** Total bytes of output produced (including what reached the file). */
    bytes: number;
    /** Bytes dropped due to disk backpressure (0 in the normal case). */
    droppedBytes: number;
}
interface OutputSpool {
    /** Feed every raw output chunk. Never throws. */
    write(text: string): void;
    /**
     * Close the file (if one was opened) and return its info, or null when the
     * output never exceeded the threshold. Idempotent.
     */
    finalize(): SpoolInfo | null;
}
interface CreateOutputSpoolOptions {
    /** Tool name used in the spool filename (sanitized). */
    tool: string;
    /**
     * Output size at which the spool activates. Should match the tool's
     * in-memory cap so files are only created for output the model can't
     * already see in full. Default 32 KB.
     */
    thresholdBytes?: number | undefined;
}
/**
 * Render the marker line appended to a capped tool result. Kept in one place
 * so every command tool phrases it identically (and tests can match it).
 */
export declare function spoolNote(info: SpoolInfo): string;
export declare function createOutputSpool(opts: CreateOutputSpoolOptions): OutputSpool;
export {};
//# sourceMappingURL=_output-spool.d.ts.map