/**
 * Import warmup module for Godot MCP Enhanced.
 *
 * Godot headless mode does NOT run the resource import pipeline,
 * so `.godot/imported/` may be missing or stale, causing `load()` to fail.
 *
 * This module detects stale/missing imported resources and runs
 * `godot --headless --import` to warm up the cache before execution.
 */
import { type ImportIntegrityReport } from './import-integrity.js';
/**
 * Reset import cache — for test isolation.
 */
export declare function resetImportCache(): void;
/**
 * Check whether a project needs an import warmup run.
 *
 * Returns true when:
 * 1. `GODOT_MCP_AUTO_IMPORT=false` is NOT set, AND
 * 2. `.godot/imported/` does not exist, OR new asset files have been detected
 *    (based on mtime comparison with cached state).
 */
export declare function needsImport(projectPath: string): boolean;
/**
 * Run `godot --headless --import` to warm up the resource import cache.
 *
 * 能力 D (2026-09-21)：导入完成后执行 .import 完整性自检（TMXYH5 反馈：
 * --import 曾把位图字体引用的 png.import 重写为只剩 [remap] 段）。返回检测
 * 报告——gutted 非空时调用方可上浮到工具输出；自动 warmup 链至少有 logger
 * 告警（warnIfGutted）。
 *
 * @throws Error if the import process fails or times out.
 */
export declare function runImport(projectPath: string, godotPath: string, timeoutMs?: number): Promise<ImportIntegrityReport>;