import { APIResource } from '../core/resource.js';
import * as RunsAPI from './runs.js';
import { APIPromise } from '../core/api-promise.js';
import { ItemsCursorPostPagination, type ItemsCursorPostPaginationParams, PagePromise } from '../core/pagination.js';
import { RequestOptions } from '../internal/request-options.js';
export declare class Traces extends APIResource {
    /**
     * **Alpha:** The request and response contract may change; Returns runs for a
     * trace ID within min/max start time. Optional `filter`; repeatable `selects` to
     * select fields to return.
     *
     * @example
     * ```ts
     * const response = await client.traces.listRuns(
     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
     *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
     * );
     * ```
     */
    listRuns(traceID: string, params: TraceListRunsParams, options?: RequestOptions): APIPromise<TraceListRunsResponse>;
    /**
     * Returns a paginated list of traces (root runs) for a single tracing project.
     * Each item carries the trace's root run plus optional trace-wide aggregates
     * (`total_tokens`, `total_cost`, `first_token_time`) under `trace_aggregates`, so
     * clients never have to merge by `trace_id`.
     *
     * Traces are scanned within a `start_time` window: `min_start_time` defaults to 24
     * hours before the request, `max_start_time` defaults to the request time. Set
     * either explicitly to widen or narrow the window.
     *
     * Supports filters (`trace_filter`, `tree_filter`), cursor pagination (`cursor`),
     * and field projection (`selects`).
     *
     * @example
     * ```ts
     * // Automatically fetches more pages as needed.
     * for await (const trace of client.traces.query()) {
     *   // ...
     * }
     * ```
     */
    query(body: TraceQueryParams, options?: RequestOptions): PagePromise<TracesItemsCursorPostPagination, Trace>;
}
export type TracesItemsCursorPostPagination = ItemsCursorPostPagination<Trace>;
export interface Trace {
    /**
     * `root_run` is the trace's root run. Which properties are populated is controlled
     * by `selects` in the request.
     */
    root_run?: RunsAPI.Run;
    /**
     * `trace_aggregates` carries trace-wide aggregate metrics. Omitted when no
     * aggregate field was selected, or `null` (then later filled) on the streaming
     * wire while the aggregate values are still being computed.
     */
    trace_aggregates?: TraceAggregates;
}
export interface TraceAggregates {
    /**
     * `first_token_time` is when the first output token was produced anywhere in the
     * trace (RFC3339), when recorded.
     */
    first_token_time?: string;
    /**
     * `total_cost` is total estimated USD cost across every run in the trace.
     */
    total_cost?: number;
    /**
     * `total_tokens` is prompt plus completion tokens summed across every run in the
     * trace.
     */
    total_tokens?: number;
}
export interface TraceListRunsResponse {
    /**
     * `items` lists runs in the trace for the requested time window, in `start_time`
     * order.
     */
    items?: Array<RunsAPI.Run>;
}
export interface TraceListRunsParams {
    /**
     * Query param: `project_id` is the UUID of the tracing project that owns the
     * trace.
     */
    project_id: string;
    /**
     * Query param: `filter` narrows which runs within this trace are returned, using a
     * LangSmith filter expression evaluated against each run. For example:
     * `eq(run_type, "llm")` for LLM runs only, or `eq(status, "error")` for failed
     * runs. See
     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
     * for syntax.
     */
    filter?: string;
    /**
     * Query param: `max_start_time` is the optional inclusive upper bound for run
     * `start_time` (RFC3339 date-time). Required together with `min_start_time`.
     */
    max_start_time?: string;
    /**
     * Query param: `min_start_time` is the optional inclusive lower bound for run
     * `start_time` (RFC3339 date-time). Required together with `max_start_time`.
     */
    min_start_time?: string;
    /**
     * Query param: `selects` lists which properties to include on each returned run
     * (repeatable query parameter). Accepts any value of the `RunSelectField` enum. If
     * omitted, only `id` is returned.
     */
    selects?: Array<'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'SHARE_URL' | 'FEEDBACK_STATS'>;
    /**
     * Header param: application/json
     */
    Accept?: string;
}
export interface TraceQueryParams extends ItemsCursorPostPaginationParams {
    /**
     * `max_start_time` is the exclusive upper bound for the root-run start time scan
     * (RFC3339). Defaults to the request time when omitted.
     */
    max_start_time?: string;
    /**
     * `min_start_time` is the inclusive lower bound for the root-run start time scan
     * (RFC3339). Defaults to 24 hours before the request when omitted.
     */
    min_start_time?: string;
    /**
     * `project_id` is the UUID of the tracing project that owns the traces. Required.
     */
    project_id?: string;
    /**
     * `selects` lists which properties to include on each returned trace. Properties
     * listed here are routed to the appropriate sub-object on each item:
     * `total_tokens`, `total_cost`, and `first_token_time` appear under
     * `trace_aggregates`; everything else appears under `root_run`. If omitted, only
     * `id` is returned on `root_run`.
     */
    selects?: Array<'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'SHARE_URL' | 'FEEDBACK_STATS'>;
    /**
     * `trace_filter` narrows results to traces whose root run matches this LangSmith
     * filter expression. This filter targets root runs only — `is_root = true` is
     * implied. See
     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
     * for syntax.
     */
    trace_filter?: string;
    /**
     * `trace_ids` is an optional fast-path restriction to a known set of trace UUIDs.
     * Equivalent in result to including each UUID in a `trace_filter`, but more
     * efficient at scale.
     */
    trace_ids?: Array<string>;
    /**
     * `tree_filter` narrows results to traces containing at least one run anywhere in
     * the run tree (root or descendant) that matches this LangSmith filter expression.
     */
    tree_filter?: string;
}
export declare namespace Traces {
    export { type Trace as Trace, type TraceAggregates as TraceAggregates, type TraceListRunsResponse as TraceListRunsResponse, type TracesItemsCursorPostPagination as TracesItemsCursorPostPagination, type TraceListRunsParams as TraceListRunsParams, type TraceQueryParams as TraceQueryParams, };
}