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";
/**
 * Generate chapters for a video.
 */
export declare class GenerateChapters extends APIResource {
    /**
     * Creates a new job that uses AI to generate chapters for a Mux Video asset.
     *
     * @example
     * ```ts
     * const generateChaptersJob =
     *   await client.robotsPreview.jobs.generateChapters.create({
     *     parameters: { asset_id: 'mux_asset_123abc' },
     *   });
     * ```
     */
    create(body: GenerateChapterCreateParams, options?: RequestOptions): APIPromise<GenerateChaptersJob>;
    /**
     * Retrieves the current status and results of a 'generate-chapters' job.
     *
     * @example
     * ```ts
     * const generateChaptersJob =
     *   await client.robotsPreview.jobs.generateChapters.retrieve(
     *     'rjob_lK9w2kI5J1',
     *   );
     * ```
     */
    retrieve(jobID: string, options?: RequestOptions): APIPromise<GenerateChaptersJob>;
}
export interface GenerateChaptersJob {
    /**
     * Unique job identifier.
     */
    id: string;
    /**
     * Unix timestamp (seconds) when the job was created.
     */
    created_at: number;
    parameters: GenerateChaptersJobParameters;
    /**
     * 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: 'generate-chapters';
    /**
     * Error details. Present when status is 'errored'.
     */
    errors?: Array<JobsAPI.JobError>;
    /**
     * Workflow results. Present when status is 'completed'.
     */
    outputs?: GenerateChaptersJobOutputs;
    /**
     * Arbitrary string supplied at creation, returned as-is.
     */
    passthrough?: string;
    /**
     * Related Mux resources linked to this job.
     */
    resources?: GenerateChaptersJob.Resources;
}
export declare namespace GenerateChaptersJob {
    /**
     * 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 GenerateChaptersJobOutputs {
    /**
     * Generated chapters, ordered by start time.
     */
    chapters: Array<GenerateChaptersJobOutputs.Chapter>;
}
export declare namespace GenerateChaptersJobOutputs {
    interface Chapter {
        /**
         * Chapter start time in seconds. The first chapter always starts at 0.
         */
        start_time: number;
        /**
         * Concise chapter title.
         */
        title: string;
    }
}
export interface GenerateChaptersJobParameters {
    /**
     * The Mux asset ID of the video to generate chapters for.
     */
    asset_id: string;
    /**
     * BCP 47 language code of the caption track to analyze (e.g. "en", "fr"). When
     * omitted, the SDK prefers English if available.
     */
    language_code?: string;
    /**
     * BCP 47 language code for the output chapter titles. Auto-detected from the
     * transcript if omitted.
     */
    output_language_code?: string;
    /**
     * Override specific sections of the chapter generation prompt.
     */
    prompt_overrides?: GenerateChaptersJobParameters.PromptOverrides;
}
export declare namespace GenerateChaptersJobParameters {
    /**
     * Override specific sections of the chapter generation prompt.
     */
    interface PromptOverrides {
        /**
         * Override the chapter density and timing constraints.
         */
        chapter_guidelines?: string;
        /**
         * Override the JSON output format instructions.
         */
        output_format?: string;
        /**
         * Override the core task instruction for chapter generation.
         */
        task?: string;
        /**
         * Override the chapter title style requirements.
         */
        title_guidelines?: string;
    }
}
export interface GenerateChapterCreateParams {
    parameters: GenerateChaptersJobParameters;
    /**
     * Arbitrary string stored with the job and returned in responses. Useful for
     * correlating jobs with your own systems.
     */
    passthrough?: string;
}
export declare namespace GenerateChapters {
    export { type GenerateChaptersJob as GenerateChaptersJob, type GenerateChaptersJobOutputs as GenerateChaptersJobOutputs, type GenerateChaptersJobParameters as GenerateChaptersJobParameters, type GenerateChapterCreateParams as GenerateChapterCreateParams, };
}
//# sourceMappingURL=generate-chapters.d.ts.map