/**
 * Mode system — resolves the active mode (ask/plan/build/debug), loads the
 * mode's system prompt, filters active tools, and exposes the /mode, /plan,
 * /grill, /goal, and /approve commands.
 *
 * Mode prompt search order (first hit wins):
 *   - `./.hoocode/modes/{mode}/system.md`
 *   - `~/.hoocode/modes/{mode}/system.md`
 *   - each configured/contributed external dir in declared order
 *   - built-in MODE_DEFAULTS for the four known modes
 */
import type { ExtensionAPI } from "../../core/extensions/types.js";
/**
 * Returns the system prompt for the active mode.
 *
 * Search order (first hit wins):
 *   - `./.hoocode/modes/{mode}/system.md`
 *   - `~/.hoocode/modes/{mode}/system.md`
 *   - each of `externalDirs` in declared order (config + CLI + extension contributions)
 *   - built-in MODE_DEFAULTS for the four known modes
 */
export declare function buildSystemPrompt(mode: string, cwd: string, options?: {
    modePaths?: string[];
}): string | undefined;
export interface PlanSections {
    goal?: string;
    filesToModify?: string;
    newFiles?: string;
    tests?: string;
    verification?: string;
    /** Original full text, used as fallback if no sections parsed */
    raw: string;
}
/**
 * Parses `.hoocode/plan.md` into named sections.
 *
 * Recognises both ATX headings (`## Goal`) and bold labels (`**Goal**`).
 * Section names matched (case-insensitive): Goal, Files to modify, New files,
 * Tests, Verification.
 */
export declare function parsePlanSections(planContent: string): PlanSections;
/**
 * Builds the user message sent to the agent when `/approve` is run.
 *
 * If the plan has recognisable sections, each is presented as a numbered step
 * so the agent works through them sequentially. Otherwise the raw plan is used.
 *
 * Execution order:
 *   1. Modify existing files
 *   2. Create new files
 *   3. Update / add tests
 *   4. Run verification commands
 */
export declare function buildApproveMessage(sections: PlanSections): string;
/** Which half (or both) of the grill flow to run. */
export type GrillTarget = "both" | "me" | "plan";
/**
 * Parses the `/grill` argument into a target.
 *
 * Bare `/grill` runs both phases, `/grill me` only questions the user, and
 * `/grill plan` only critiques the plan. Anything else returns undefined so the
 * caller shows usage rather than guessing at intent.
 */
export declare function parseGrillTarget(args: string): GrillTarget | undefined;
/**
 * Builds the follow-up message injected by `/grill`.
 *
 * The two phases are ordered rather than alternative: underspecification sits
 * upstream of plan weakness, so critiquing a plan built on a misread request
 * produces a well-reviewed plan for the wrong job. Bare `/grill` therefore asks
 * first and folds the answers into the critique.
 */
export declare function buildGrillMessage(sections: PlanSections, target: GrillTarget): string;
/** A parsed `/goal` invocation. */
export interface GoalInvocation {
    /** Explicit objective; falls back to the plan's Goal section when absent. */
    objective?: string;
    /** Turn budget passed through to the autonomous loop. */
    maxTurns?: number;
}
/**
 * Parses `/goal [--max-turns N] [objective]`.
 *
 * Returns undefined when `--max-turns` is present but not followed by a
 * non-negative integer, so the caller shows usage instead of silently running
 * with the default budget.
 */
export declare function parseGoalArgs(args: string): GoalInvocation | undefined;
/** The two messages `/goal` hands to the autonomous loop. */
export interface GoalMessages {
    /** Delivered once, to start the run. */
    task: string;
    /** Re-sent on each continuation to keep the target in view. */
    continuePrompt: string;
}
/**
 * Builds the messages for a `/goal` run.
 *
 * When the plan carries a Verification section it becomes the completion
 * condition, which is the difference between a loop that stops when it feels
 * finished and one that stops when something it can run says so. Both messages
 * restate the objective, because the loop's continuation prompt is all that
 * holds the target in place as the transcript grows.
 */
export declare function buildGoalMessages(objective: string, verification?: string): GoalMessages;
export declare function setupMode(hoo: ExtensionAPI): void;
//# sourceMappingURL=modes.d.ts.map