import type { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
import { Type } from "typebox";
import { type VerificationResult } from "../verification/index.js";
import { clearComponentManifestCache } from "./component-manifests.js";
import { type PageFileBaseline } from "./page-architecture.js";
export interface FrontendToolState {
    /** Whether the task-scoped frontend component capability is active. */
    capabilityActive?: boolean;
    capabilityActivationReason?: string;
    dirtyFiles: Set<string>;
    pendingValidationFiles?: Set<string>;
    pendingVerification?: boolean;
    readOnlyCallsSinceMutation?: number;
    baselineCaptureAttempted?: boolean;
    verificationBaseline?: VerificationResult;
    previewedFiles?: Set<string>;
    validatedRoutes?: Map<string, string>;
    validationMode?: FrontendValidationMode;
    /** @deprecated Use validationMode. Kept for integrations created before 0.1.6. */
    visualValidationRequired?: boolean;
    sceneTemplateRequired?: boolean;
    sceneTemplateLookup?: {
        status: "not-started" | "in-progress" | "resolved";
        compatible?: boolean;
        templateId?: string;
        variant?: "versatile" | "kpc";
        requiredRootComponent?: string;
        targetFile?: string;
    };
    templateComponents?: Set<string>;
    selectedSceneTemplates?: Map<string, string>;
    selectedSceneTemplateContracts?: Map<string, {
        templateId: string;
        variant: "versatile" | "kpc";
        requiredRootComponent?: string;
    }>;
    requiredReferenceImages?: Set<string>;
    referenceComparisons?: Map<string, string>;
    pageFileBaselines?: Map<string, PageFileBaseline>;
    componentEvidence?: Map<string, {
        contract: boolean;
        usage: boolean;
    }>;
    pendingComponentEvidenceGaps?: Map<string, {
        file: string;
        packageName: string;
        component: string;
        requiredEvidence: "installed-usage" | "contract-or-usage";
    }>;
    previewArtifacts?: Set<string>;
    validationFingerprints?: Map<string, {
        fingerprint: string;
        repeats: number;
    }>;
    stalledValidationFiles?: Set<string>;
    verificationFingerprints?: Map<string, {
        fingerprint: string;
        repeats: number;
    }>;
    stalledVerificationFiles?: Set<string>;
    diagnosticRecoveryUnlocked?: boolean;
    mockDataRequested?: boolean;
    componentCompositions?: Map<string, {
        root: string;
        related: string[];
    }>;
    previewFailures?: Map<string, {
        fingerprint: string;
        repeats: number;
        nonRetryable: boolean;
        infrastructureFailure?: boolean;
        error: string;
    }>;
    lastFinishResult?: {
        passed: boolean;
        blockers: string[];
    };
    finishFailure?: {
        fingerprint: string;
        repeats: number;
        blockers: string[];
        files: string[];
        remediation: string[];
    };
    finishRecoveryUnlocked?: boolean;
    providerRateLimit?: {
        requestCount: number;
        totalWaitMs: number;
        lastWaitMs: number;
        lastRawEstimatedTokens: number;
        lastEstimatedTokens: number;
        lastUsedTokens: number;
        effectiveTokensPerMinute: number;
        calibrationFactor: number;
    };
    preWriteComponentResearchCalls?: number;
}
export type FrontendValidationMode = "code" | "visual";
type PiExecutor = Pick<ExtensionAPI, "exec">;
export { clearComponentManifestCache };
export declare function createFrontendProjectInspectTool(): ToolDefinition<Type.TObject<{
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createFrontendSceneTemplateTool(state?: FrontendToolState): ToolDefinition<Type.TObject<{
    query: Type.TString;
    targetFile: Type.TOptional<Type.TString>;
    language: Type.TOptional<Type.TUnion<[Type.TLiteral<"auto">, Type.TLiteral<"ts">, Type.TLiteral<"js">]>>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createComponentQueryTool(state?: FrontendToolState): ToolDefinition<Type.TObject<{
    query: Type.TUnion<[Type.TString, Type.TArray<Type.TString>]>;
    packageName: Type.TOptional<Type.TUnion<Type.TLiteral<"@ksyun-internal/versatile" | "@king-design/vue">[]>>;
    limit: Type.TOptional<Type.TInteger>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createComponentContractTool(state?: FrontendToolState): ToolDefinition<Type.TObject<{
    component: Type.TString;
    packageName: Type.TUnion<Type.TLiteral<"@ksyun-internal/versatile" | "@king-design/vue">[]>;
    sections: Type.TOptional<Type.TArray<Type.TUnion<Type.TLiteral<"props" | "events" | "slots" | "methods" | "models" | "exposed">[]>>>;
    members: Type.TOptional<Type.TArray<Type.TString>>;
    force: Type.TOptional<Type.TBoolean>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createComponentUsageTool(state?: FrontendToolState): ToolDefinition<Type.TObject<{
    component: Type.TString;
    packageName: Type.TUnion<Type.TLiteral<"@ksyun-internal/versatile" | "@king-design/vue">[]>;
    force: Type.TOptional<Type.TBoolean>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createComponentValidateTool(state?: FrontendToolState): ToolDefinition<Type.TObject<{
    files: Type.TArray<Type.TString>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createFrontendVerifyTool(pi: PiExecutor, state?: FrontendToolState): ToolDefinition<Type.TObject<{
    mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"fast">, Type.TLiteral<"full">]>>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createFrontendPreviewTool(pi: PiExecutor, state: FrontendToolState): ToolDefinition<Type.TObject<{
    file: Type.TString;
    route: Type.TOptional<Type.TString>;
    referenceImage: Type.TOptional<Type.TString>;
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createFrontendFinishTool(pi: PiExecutor, state: FrontendToolState): ToolDefinition<Type.TObject<{
    projectRoot: Type.TOptional<Type.TString>;
}>, unknown, any>;
export declare function createFrontendTools(pi: PiExecutor, state: FrontendToolState): ToolDefinition[];
//# sourceMappingURL=tools.d.ts.map