import type { ConnectorAssist } from "@cotal-ai/core";
export interface AssistContext {
    /** Failed step slug (as shown to the user and written to the log). */
    step: string;
    error: Error;
    /** Local paths and doc URLs the harness should read for context: referenced in the
     *  prompt, never inlined, so it works without a repo clone. */
    context: string[];
    logPath: string;
}
/** A debug handoff is offered only on a TTY and when not opted out via COTAL_SKIP_ASSIST=1 (CI).
 *  Which harness hosts it is the connectors' answer, not this file's. */
export declare function assistAllowed(): boolean;
/** Hand the terminal to a connector's debug session primed with the failure context. Resolves when
 *  the user exits the harness and setup resumes. */
export declare function runHandoff(assist: ConnectorAssist, ctx: AssistContext): Promise<void>;
/** The line the failure menu prints when no handoff can be offered, so the absence is explained. */
export declare function noAssistLine(reason: string): string;
//# sourceMappingURL=assist.d.ts.map