/**
 * Agent-Oriented Workflow Tools
 *
 * Provides:
 * - agentValidateProject: Pre-flight project validation and readiness report.
 * - agentBuildDiagnose: Build execution with structured diagnostic classification.
 * - agentSafePinAudit: Heuristic GPIO safety audit for board-specific pin risks.
 * - agentFlashMonitorVerify: Flash + runtime serial verification workflow.
 * - agentGetLastReport: Retrieves the persisted last agent report.
 * - agentGenerateBoardReport: Builds and caches board intelligence metadata.
 */
import { type MonitorHealthResult, type MonitorNotificationReason } from "../core/monitor-health.js";
import { type TargetBinding, type TargetResolutionResult } from "../core/target-resolution.js";
import type { AgentBoardReport, AgentBuildDiagnoseResult, AgentFlashMonitorVerifyResult, AgentGetLastReportResult, AgentPinAuditResult, AgentValidateProjectResult } from "../types.js";
/**
 * Validates a PlatformIO project for agent readiness.
 *
 * @param projectDir - Path to the PlatformIO project directory.
 * @returns Structured project readiness report.
 */
export declare function agentValidateProject(projectDir: string): Promise<AgentValidateProjectResult>;
/**
 * Builds a project and returns a rich diagnostic classification payload.
 *
 * @param projectDir - Path to the PlatformIO project directory.
 * @param environment - Optional environment name.
 * @param verbose - Optional verbose build flag.
 * @param background - Optional background dispatch flag.
 * @returns Structured build + diagnostics result.
 */
export declare function agentBuildDiagnose(projectDir: string, environment?: string, verbose?: boolean, background?: boolean): Promise<AgentBuildDiagnoseResult>;
/**
 * Performs a heuristic static pin audit against board profile rules.
 *
 * @param projectDir - Path to the PlatformIO project directory.
 * @param boardId - Target board ID for profile-based pin safety rules.
 * @returns Pin-risk findings discovered during static scan.
 */
export declare function agentSafePinAudit(projectDir: string, boardId: string): Promise<AgentPinAuditResult[]>;
/**
 * Builds (if needed), flashes, monitors, and verifies runtime behavior.
 *
 * @param input - Flash + monitor verification options.
 * @returns Structured flash and runtime verification report.
 */
export declare function agentFlashMonitorVerify(input: {
    projectDir: string;
    environment?: string;
    port?: string;
    targetBinding?: TargetBinding;
    expectAll?: string[];
    rejectPatterns?: string[];
    timeoutSeconds?: number;
    stabilityWindowSeconds?: number;
    autoBuild?: boolean;
    maxRunDurationSeconds?: number;
}): Promise<AgentFlashMonitorVerifyResult>;
/**
 * Retrieves the most recently persisted agent report.
 *
 * @param projectDir - Path to the PlatformIO project directory.
 * @returns Last report payload or a missing-report descriptor.
 */
export declare function agentGetLastReport(projectDir: string): Promise<AgentGetLastReportResult>;
/**
 * Generates and caches a board intelligence report.
 *
 * @param projectDir - Path to the PlatformIO project directory.
 * @param boardId - Target PlatformIO board ID.
 * @returns Board intelligence report payload.
 */
export declare function agentGenerateBoardReport(projectDir: string, boardId: string): Promise<AgentBoardReport>;
/** Result from one interactive or scheduled serial-health check. */
export interface AgentMonitorHealthResult {
    success: boolean;
    target: TargetResolutionResult;
    health: MonitorHealthResult;
    automationKey?: string;
    targetChanged: boolean;
    shouldNotify: boolean;
    notificationReason?: MonitorNotificationReason;
}
/**
 * Resolves one target, captures a bounded serial window, and tracks changes.
 *
 * @param input - Target selectors, assertions, and optional automation key.
 * @returns Change-aware health result with no raw unbounded device output.
 */
export declare function agentMonitorHealth(input: {
    projectDir: string;
    environment?: string;
    port?: string;
    baudRate?: number;
    captureDurationSeconds?: number;
    maxBytes?: number;
    expectedMarkers?: string[];
    rejectedPatterns?: string[];
    automationKey?: string;
    cursor?: string;
    failureThreshold?: number;
}): Promise<AgentMonitorHealthResult>;
//# sourceMappingURL=agent.d.ts.map