import { APIResource } from "../../../core/resource.js";
import * as JobsAPI from "./jobs.js";
import { APIPromise } from "../../../core/api-promise.js";
import { RequestOptions } from "../../../internal/request-options.js";
/**
 * Ask questions about a video and get structured answers.
 */
export declare class AskQuestions extends APIResource {
    /**
     * Creates a new job that uses AI to answer questions about a Mux Video asset.
     *
     * @example
     * ```ts
     * const askQuestionsJob =
     *   await client.robotsPreview.jobs.askQuestions.create({
     *     parameters: {
     *       asset_id: 'mux_asset_123abc',
     *       questions: [
     *         {
     *           question:
     *             'How many people are speaking on camera?',
     *           answer_options: ['one', 'two', 'three or more'],
     *         },
     *       ],
     *     },
     *   });
     * ```
     */
    create(body: AskQuestionCreateParams, options?: RequestOptions): APIPromise<AskQuestionsJob>;
    /**
     * Retrieves the current status and results of an 'ask-questions' job.
     *
     * @example
     * ```ts
     * const askQuestionsJob =
     *   await client.robotsPreview.jobs.askQuestions.retrieve(
     *     'rjob_lK9w2kI5J1',
     *   );
     * ```
     */
    retrieve(jobID: string, options?: RequestOptions): APIPromise<AskQuestionsJob>;
}
export interface AskQuestionsJob {
    /**
     * Unique job identifier.
     */
    id: string;
    /**
     * Unix timestamp (seconds) when the job was created.
     */
    created_at: number;
    parameters: AskQuestionsJobParameters;
    /**
     * Current job status.
     */
    status: JobsAPI.JobStatus;
    /**
     * Number of Mux AI units consumed by this job.
     */
    units_consumed: number;
    /**
     * Unix timestamp (seconds) when the job was last updated.
     */
    updated_at: number;
    workflow: 'ask-questions';
    /**
     * Error details. Present when status is 'errored'.
     */
    errors?: Array<JobsAPI.JobError>;
    /**
     * Workflow results. Present when status is 'completed'.
     */
    outputs?: AskQuestionsJobOutputs;
    /**
     * Arbitrary string supplied at creation, returned as-is.
     */
    passthrough?: string;
    /**
     * Related Mux resources linked to this job.
     */
    resources?: AskQuestionsJob.Resources;
}
export declare namespace AskQuestionsJob {
    /**
     * Related Mux resources linked to this job.
     */
    interface Resources {
        /**
         * Mux assets associated with this job.
         */
        assets: Array<Resources.Asset>;
    }
    namespace Resources {
        interface Asset {
            /**
             * Mux asset ID.
             */
            id: string;
            /**
             * Hypermedia links for the asset.
             */
            _links: Asset._Links;
            /**
             * Mux asset metadata, if available.
             */
            meta?: Asset.Meta;
            /**
             * Passthrough string from the Mux asset.
             */
            passthrough?: string;
        }
        namespace Asset {
            /**
             * Hypermedia links for the asset.
             */
            interface _Links {
                self: _Links.Self;
            }
            namespace _Links {
                interface Self {
                    /**
                     * URL to the Mux asset resource.
                     */
                    href: string;
                }
            }
            /**
             * Mux asset metadata, if available.
             */
            interface Meta {
                /**
                 * Creator identifier from Mux metadata.
                 */
                creator_id?: string;
                /**
                 * External identifier from Mux metadata.
                 */
                external_id?: string;
                /**
                 * Asset title from Mux metadata.
                 */
                title?: string;
            }
        }
    }
}
/**
 * Workflow results. Present when status is 'completed'.
 */
export interface AskQuestionsJobOutputs {
    /**
     * One answer per question, in the same order as the input questions.
     */
    answers: Array<AskQuestionsJobOutputs.Answer>;
}
export declare namespace AskQuestionsJobOutputs {
    interface Answer {
        /**
         * The answer, constrained to one of the provided answer_options. Null when the
         * question was skipped.
         */
        answer: string | null;
        /**
         * Confidence score from 0.0 to 1.0. Values above 0.9 indicate clear, unambiguous
         * evidence; 0.7-0.9 strong evidence with minor ambiguity; 0.5-0.7 moderate
         * evidence; below 0.5 weak or uncertain evidence. Always 0 when skipped.
         */
        confidence: number;
        /**
         * The original question that was asked.
         */
        question: string;
        /**
         * Explanation citing specific visual or audio evidence from the video, or why the
         * question was skipped.
         */
        reasoning: string;
        /**
         * Whether the question was skipped due to irrelevance to the video content.
         */
        skipped: boolean;
    }
}
export interface AskQuestionsJobParameters {
    /**
     * The Mux asset ID of the video to analyze.
     */
    asset_id: string;
    /**
     * One or more questions to ask about the video. Each question can specify its own
     * answer_options.
     */
    questions: Array<AskQuestionsJobParameters.Question>;
    /**
     * BCP 47 language code of the caption track to analyze (e.g. "en", "fr"). When
     * omitted, the SDK uses the default track.
     */
    language_code?: string;
}
export declare namespace AskQuestionsJobParameters {
    interface Question {
        /**
         * The question to ask about the video content.
         */
        question: string;
        /**
         * Allowed answer values for this question. Defaults to ["yes", "no"].
         */
        answer_options?: Array<string>;
    }
}
export interface AskQuestionCreateParams {
    parameters: AskQuestionsJobParameters;
    /**
     * Arbitrary string stored with the job and returned in responses. Useful for
     * correlating jobs with your own systems.
     */
    passthrough?: string;
}
export declare namespace AskQuestions {
    export { type AskQuestionsJob as AskQuestionsJob, type AskQuestionsJobOutputs as AskQuestionsJobOutputs, type AskQuestionsJobParameters as AskQuestionsJobParameters, type AskQuestionCreateParams as AskQuestionCreateParams, };
}
//# sourceMappingURL=ask-questions.d.ts.map