import type { PublicIdForPrefix } from "./public-id.js";
import type { PaginationOptions } from "./types.js";
export type AgentReportId = PublicIdForPrefix<"agr">;
export interface ProjectContextInput {
    business: string;
    audience: string;
    products: string;
    goals: string;
    agent_rules: string;
}
export interface ProjectContext extends ProjectContextInput {
    updated_at: string | null;
}
export interface AgentReportSummary {
    id: AgentReportId;
    title: string;
    kind: string;
    created_at: string;
}
export interface AgentReport extends AgentReportSummary {
    body: Record<string, unknown>;
    provenance: Record<string, unknown>;
}
export interface CreateAgentReportInput {
    /** External analysis kind. site_audit, ai_visibility and prompt_explorer are reserved. */
    kind: string;
    title: string;
    body: Record<string, unknown>;
    provenance?: Record<string, unknown>;
}
export interface ListAgentReportsOptions extends PaginationOptions {
    kind?: string;
}
export interface AiAnalysisInput {
    brand: string;
    /** Public hostname without a scheme or path. */
    domain: string;
    /** Maximum accepted provider cost. Cache reads and estimates do not spend credits. */
    max_cost_cents: number;
    estimate_only?: boolean;
    fresh?: boolean;
}
export interface AnalyzeBrandVisibilityInput extends AiAnalysisInput {
    platform?: "chat_gpt" | "google";
    target_type?: "brand" | "domain";
    language_code?: string;
    location_code?: number;
    limit?: number;
}
/** AI response engines available in Prompt Explorer engine mode. */
export type AiEngine = "chat_gpt" | "claude" | "gemini" | "perplexity";
export interface CompareAiPromptsInput extends Omit<AiAnalysisInput, "max_cost_cents"> {
    max_cost_cents?: number;
    cost_policy?: "hard_cap" | "provider_actual_cost";
    actual_cost_acknowledgement?: "non_guaranteed_estimate_v1";
    estimated_cost_limit_cents?: number;
    idempotency_key?: string;
    estimate_credentials_ref?: string;
    web_search?: boolean;
    country_iso_code?: string;
    response_language?: string;
    max_output_tokens?: number;
    prompt: string;
    models?: string[];
    /**
     * Engine mode on Credits: each engine answers with its calibrated flagship model under the
     * hard cap. Omit `models` and `max_output_tokens`; requires a server with engine mode.
     */
    engines?: AiEngine[];
}
export type AiEvidence = "observed_dataset" | "synthetic_prompt_test";
export interface AiAnalysisRow {
    prompt: string;
    model: string;
    /** Engine that answered in engine mode. */
    engine?: AiEngine;
    requested_model?: string;
    actual_model?: string | null;
    answer: string;
    observed_at: string | null;
    brand_mentioned: boolean;
    domain_cited: boolean;
    citations: Array<{
        title: string;
        url: string;
        target_domain: boolean;
    }>;
    content_truncated?: boolean;
}
export interface AiAnalysisResult {
    evidence: AiEvidence;
    rows: AiAnalysisRow[];
    total_available: number | null;
    truncated: boolean;
    fetched_at: string;
    cost_cents: number;
    cost_status: "confirmed" | "unknown";
    failure: string | null;
}
export type AiAnalysisOutcome = {
    ok: true;
    estimate: true;
    estimated_cost_cents: number;
    evidence: AiEvidence;
    estimate_kind?: "forecast" | "admission_bound";
    is_guaranteed_maximum?: boolean;
    credential_source?: "own" | "hosted";
    estimate_credentials_ref?: string;
    is_partial_estimate?: boolean;
    pricing_policy?: "legacy_dated" | "current_catalog" | "provider_actual_cost" | "measured_engines";
    pricing_checked_at?: string;
    forecast_exclusions?: string[];
    forecast_scope?: "tokens_and_base_only";
    forecast_assumptions?: string[];
} | {
    ok: true;
    estimate: false;
    cached: boolean;
    report_id: AgentReportId;
    cost_cents: number;
    result: AiAnalysisResult;
    retry_blocked?: boolean;
};
export interface RunSiteAuditInput {
    /** Maximum pages in the bounded crawl, from 1 to 15. Defaults to 10. */
    max_pages?: number;
}
export interface SiteAuditIssue {
    code: string;
    severity: "error" | "warning" | "info";
    message: string;
}
export interface SiteAuditPage {
    url: string;
    final_url: string;
    status: number | null;
    response_time_ms: number;
    title: string | null;
    description: string | null;
    canonical: string | null;
    headings: Array<{
        level: number;
        text: string;
    }>;
    h1_count: number;
    indexable: boolean;
    robots: string | null;
    internal_link_count: number;
    external_link_count: number;
    internal_links: string[];
    image_count: number;
    missing_alt_count: number;
    issues: SiteAuditIssue[];
}
export interface SiteAuditResult {
    version: 1;
    target: string;
    started_at: string;
    completed_at: string;
    state: "complete" | "partial";
    stop_reason: "finished" | "page_limit" | "time_limit" | "request_limit";
    limits: {
        max_pages: number;
        max_requests: number;
        max_duration_ms: number;
        max_page_bytes: number;
    };
    requests: number;
    pages: SiteAuditPage[];
    summary: {
        pages: number;
        errors: number;
        warnings: number;
        indexable: number;
    };
    limitations: string[];
}
export interface SiteAudit {
    id: AgentReportId;
    created_at: string;
    cached: boolean;
    result: SiteAuditResult;
}
//# sourceMappingURL=research-workspace.d.ts.map