import type * as HydraDB from "../../../../index.js";
/**
 * @example
 *     {
 *         requestId: "9d13aef4-02f4-4e73-8c62-4c2601d04f9d"
 *     }
 */
export interface FeedbackSubmitRequest {
    /** Optional collection scope for this feedback. A collection is scoped to a database, so `database` must be sent alongside it; sending `collection` on its own is rejected. */
    collection?: string;
    /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
    database?: string;
    /** Free-text comment describing what was right or wrong about the results. Required unless `ground_truth` is supplied. */
    feedback?: string;
    /** What you already know the right answer to be, when you know it. Supply an expected `answer`, the `source_ids` that contain it, or both — at least one is required if the field is present. Machine-checkable, so it is a stronger signal than a comment: submit it alone and `feedback` becomes optional. */
    groundTruth?: HydraDB.FeedbackGroundTruth;
    /** Free-form key-value context stored alongside the feedback (e.g. agent name, conversation or eval-run ID). */
    metadata?: Record<string, string>;
    /** Optional overall judgement: `positive`, `negative`, or `neutral`. Omit to send a comment with no rating. */
    rating?: HydraDB.FeedbackRating;
    /** The `request_id` from `response.meta` of the query this feedback is about. Required — it is what links the feedback to the query that ran. */
    requestId: string;
    /** Who is submitting: `user` (default) or `agent`. */
    source?: HydraDB.FeedbackSource;
    /** deprecated: use collection */
    subTenantId?: string;
    /** deprecated: use database */
    tenantId?: string;
}