import { APIResource } from "../../core/resource.mjs";
import * as MessagesAPI from "../agents/messages.mjs";
import { RunsArrayPage } from "../agents/messages.mjs";
import * as RunsMessagesAPI from "./messages.mjs";
import { MessageListParams, MessageStreamParams, MessageStreamResponse, Messages } from "./messages.mjs";
import * as StepsAPI from "./steps.mjs";
import { StepListParams, Steps } from "./steps.mjs";
import * as TraceAPI from "./trace.mjs";
import { Trace, TraceRetrieveParams, TraceRetrieveResponse } from "./trace.mjs";
import * as UsageAPI from "./usage.mjs";
import { Usage, UsageRetrieveResponse } from "./usage.mjs";
import { APIPromise } from "../../core/api-promise.mjs";
import { type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
import { RequestOptions } from "../../internal/request-options.mjs";
export declare class Runs extends APIResource {
    messages: RunsMessagesAPI.Messages;
    usage: UsageAPI.Usage;
    steps: StepsAPI.Steps;
    trace: TraceAPI.Trace;
    /**
     * Get the status of a run.
     */
    retrieve(runID: string, options?: RequestOptions): APIPromise<MessagesAPI.Run>;
    /**
     * List all runs.
     */
    list(query?: RunListParams | null | undefined, options?: RequestOptions): PagePromise<RunsArrayPage, MessagesAPI.Run>;
}
/**
 * Representation of offline jobs, used for tracking status of data loading tasks
 * (involving parsing and embedding files).
 */
export interface Job {
    /**
     * The human-friendly ID of the Job
     */
    id?: string;
    /**
     * The agent associated with this job/run.
     */
    agent_id?: string | null;
    /**
     * Whether the job was created in background mode.
     */
    background?: boolean | null;
    /**
     * Optional error message from attempting to POST the callback endpoint.
     */
    callback_error?: string | null;
    /**
     * Timestamp when the callback was last attempted.
     */
    callback_sent_at?: string | null;
    /**
     * HTTP status code returned by the callback endpoint.
     */
    callback_status_code?: number | null;
    /**
     * If set, POST to this URL when the job completes.
     */
    callback_url?: string | null;
    /**
     * The unix timestamp of when the job was completed.
     */
    completed_at?: string | null;
    /**
     * The unix timestamp of when the job was created.
     */
    created_at?: string;
    /**
     * The id of the user that made this object.
     */
    created_by_id?: string | null;
    /**
     * The type of the job.
     */
    job_type?: MessagesAPI.JobType;
    /**
     * The id of the user that made this object.
     */
    last_updated_by_id?: string | null;
    /**
     * The metadata of the job.
     */
    metadata?: {
        [key: string]: unknown;
    } | null;
    /**
     * The status of the job.
     */
    status?: MessagesAPI.JobStatus;
    /**
     * The reason why the job was stopped.
     */
    stop_reason?: StopReasonType | null;
    /**
     * Total run duration in nanoseconds
     */
    total_duration_ns?: number | null;
    /**
     * Time to first token for a run in nanoseconds
     */
    ttft_ns?: number | null;
    /**
     * The timestamp when the object was last updated.
     */
    updated_at?: string | null;
}
export type StopReasonType = 'end_turn' | 'error' | 'llm_api_error' | 'invalid_llm_response' | 'invalid_tool_call' | 'max_steps' | 'max_tokens_exceeded' | 'no_tool_call' | 'tool_rule' | 'cancelled' | 'insufficient_credits' | 'requires_approval' | 'context_window_overflow_in_system_prompt';
export interface RunListParams extends ArrayPageParams {
    /**
     * Filter for active runs.
     */
    active?: boolean;
    /**
     * The unique identifier of the agent associated with the run.
     */
    agent_id?: string | null;
    /**
     * @deprecated The unique identifiers of the agents associated with the run.
     * Deprecated in favor of agent_id field.
     */
    agent_ids?: Array<string> | null;
    /**
     * @deprecated Whether to sort agents oldest to newest (True) or newest to oldest
     * (False, default). Deprecated in favor of order field.
     */
    ascending?: boolean;
    /**
     * If True, filters for runs that were created in background mode.
     */
    background?: boolean | null;
    /**
     * Filter runs by conversation ID.
     */
    conversation_id?: string | null;
    /**
     * Filter runs by status. Can specify multiple statuses.
     */
    statuses?: Array<string> | null;
    /**
     * Filter runs by stop reason.
     */
    stop_reason?: StopReasonType | null;
}
export declare namespace Runs {
    export { type Job as Job, type StopReasonType as StopReasonType, type RunListParams as RunListParams };
    export { Messages as Messages, type MessageStreamResponse as MessageStreamResponse, type MessageListParams as MessageListParams, type MessageStreamParams as MessageStreamParams, };
    export { Usage as Usage, type UsageRetrieveResponse as UsageRetrieveResponse };
    export { Steps as Steps, type StepListParams as StepListParams };
    export { Trace as Trace, type TraceRetrieveResponse as TraceRetrieveResponse, type TraceRetrieveParams as TraceRetrieveParams, };
}
export { type RunsArrayPage };
//# sourceMappingURL=runs.d.mts.map