langsmith 0.7.10 → 0.7.12

package/dist/_openapi_client/resources/runs/runs.d.ts

@@ -3,84 +3,391 @@ import * as RulesAPI from './rules.js';
 import { Rules } from './rules.js';
 import * as SessionsAPI from '../sessions/sessions.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 Runs extends APIResource {
     rules: RulesAPI.Rules;
     /**
-     * Queues a single run for ingestion. The request body must be a JSON-encoded run
-     * object that follows the Run schema.
+     * **Alpha:** The request and response contract may change; Returns a paginated
+     * list of runs for the given projects within min/max start_time. Supports filters,
+     * cursor pagination, and `selects` to select fields to return.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const queryRunResponse of client.runs.queryV2()) {
+     *   // ...
+     * }
+     * ```
      */
-    create(body: RunCreateParams, options?: RequestOptions): APIPromise<RunCreateResponse>;
+    queryV2(params: RunQueryV2Params, options?: RequestOptions): PagePromise<QueryRunResponsesItemsCursorPostPagination, QueryRunResponse>;
     /**
-     * Get a specific run.
+     * **Alpha:** The request and response contract may change; Returns one run by ID
+     * for the given session and start_time. Use the `selects` query parameter
+     * (repeatable) to select fields to return.
+     *
+     * @example
+     * ```ts
+     * const queryRunResponse = await client.runs.retrieveV2(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   {
+     *     project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     start_time: '2019-12-27T18:11:19.117Z',
+     *   },
+     * );
+     * ```
      */
-    retrieve(runID: string, query?: RunRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<RunSchema>;
+    retrieveV2(runID: string, params: RunRetrieveV2Params, options?: RequestOptions): APIPromise<QueryRunResponse>;
+    retrieve: (runID: string, params: RunRetrieveV2Params, options?: RequestOptions) => APIPromise<QueryRunResponse>;
+    query: (params: RunQueryV2Params, options?: RequestOptions) => PagePromise<QueryRunResponsesItemsCursorPostPagination, QueryRunResponse>;
+}
+export type QueryRunResponsesItemsCursorPostPagination = ItemsCursorPostPagination<QueryRunResponse>;
+export interface QueryRunResponse {
     /**
-     * Updates a run identified by its ID. The body should contain only the fields to
-     * be changed; unknown fields are ignored.
+     * `id` is this run's UUID.
      */
-    update(runID: string, body: RunUpdateParams, options?: RequestOptions): APIPromise<RunUpdateResponse>;
+    id?: string;
     /**
-     * Ingests a batch of runs in a single JSON payload. The payload must have `post`
-     * and/or `patch` arrays containing run objects. Prefer this endpoint over
-     * single‑run ingestion when submitting hundreds of runs, but `/runs/multipart`
-     * offers better handling for very large fields and attachments.
+     * `app_path` identifies the application code location that produced this run, if
+     * recorded.
      */
-    ingestBatch(body: RunIngestBatchParams, options?: RequestOptions): APIPromise<RunIngestBatchResponse>;
+    app_path?: string;
     /**
-     * Query Runs
+     * `attachments` maps each attachment file name to a pre-signed HTTPS download URL.
      */
-    query(body: RunQueryParams, options?: RequestOptions): APIPromise<RunQueryResponse>;
+    attachments?: {
+        [key: string]: string;
+    };
     /**
-     * Get all runs by query in body payload.
+     * `completion_cost` is estimated USD cost for the completion.
      */
-    stats(body: RunStatsParams, options?: RequestOptions): APIPromise<RunStatsResponse>;
+    completion_cost?: number;
     /**
-     * Update a run.
+     * `completion_cost_details` is the per-category USD breakdown of
+     * `completion_cost`. Categories mirror `completion_token_details`. Returned only
+     * when the `COMPLETION_COST_DETAILS` field is requested.
      */
-    update2(runID: string, options?: RequestOptions): APIPromise<unknown>;
-}
-/**
- * Query params for run endpoints.
- */
-export interface BodyParamsForRunSchema {
-    id?: Array<string> | null;
-    cursor?: string | null;
+    completion_cost_details?: QueryRunResponse.CompletionCostDetails;
     /**
-     * Enum for run data source types.
+     * `completion_token_details` is the per-category breakdown of `completion_tokens`.
+     * Category names are model-specific (for example `reasoning`, `audio`). Returned
+     * only when the `COMPLETION_TOKEN_DETAILS` field is requested.
      */
-    data_source_type?: RunsFilterDataSourceTypeEnum | null;
-    end_time?: string | null;
-    error?: boolean | null;
-    execution_order?: number | null;
-    filter?: string | null;
-    is_root?: boolean | null;
-    limit?: number;
+    completion_token_details?: QueryRunResponse.CompletionTokenDetails;
     /**
-     * Enum for run start date order.
+     * `completion_tokens` is the completion-side token count.
      */
-    order?: 'asc' | 'desc';
-    parent_run?: string | null;
-    query?: string | null;
-    reference_example?: Array<string> | null;
+    completion_tokens?: number;
     /**
-     * Enum for run types.
+     * `dotted_order` is the hierarchical ordering key for trace trees.
      */
-    run_type?: RunTypeEnum | null;
-    search_filter?: string | null;
-    select?: Array<'id' | 'name' | 'run_type' | 'start_time' | 'end_time' | 'status' | 'error' | 'extra' | 'events' | 'inputs' | 'inputs_preview' | 'inputs_s3_urls' | 'inputs_or_signed_url' | 'outputs' | 'outputs_preview' | 'outputs_s3_urls' | 'outputs_or_signed_url' | 's3_urls' | 'error_or_signed_url' | 'events_or_signed_url' | 'extra_or_signed_url' | 'serialized_or_signed_url' | 'parent_run_id' | 'manifest_id' | 'manifest_s3_id' | 'manifest' | 'session_id' | 'serialized' | 'reference_example_id' | 'reference_dataset_id' | 'total_tokens' | 'prompt_tokens' | 'prompt_token_details' | 'completion_tokens' | 'completion_token_details' | 'total_cost' | 'prompt_cost' | 'prompt_cost_details' | 'completion_cost' | 'completion_cost_details' | 'price_model_id' | 'first_token_time' | 'trace_id' | 'dotted_order' | 'last_queued_at' | 'feedback_stats' | 'child_run_ids' | 'parent_run_ids' | 'tags' | 'in_dataset' | 'app_path' | 'share_token' | 'trace_tier' | 'trace_first_received_at' | 'ttl_seconds' | 'trace_upgrade' | 'thread_id' | 'trace_min_max_start_time' | 'messages' | 'inserted_at'>;
-    session?: Array<string> | null;
-    skip_pagination?: boolean | null;
-    skip_prev_cursor?: boolean;
-    start_time?: string | null;
-    trace?: string | null;
-    trace_filter?: string | null;
-    tree_filter?: string | null;
-    use_experimental_search?: boolean;
+    dotted_order?: string;
+    /**
+     * `end_time` is when the run ended (RFC3339 date-time). JSON null if the run has
+     * not finished yet.
+     */
+    end_time?: string;
+    /**
+     * `error` is the error message when `status` indicates failure.
+     */
+    error?: string;
+    /**
+     * `error_preview` is a truncated plain-text error snippet.
+     */
+    error_preview?: string;
+    /**
+     * `events` is the ordered list of run events (for example streaming tokens).
+     */
+    events?: Array<QueryRunResponse.Event>;
+    /**
+     * `extra` is additional runtime JSON attached to the run.
+     */
+    extra?: unknown;
+    /**
+     * `feedback_stats` aggregates feedback scores keyed by feedback key.
+     */
+    feedback_stats?: {
+        [key: string]: QueryRunResponse.FeedbackStats;
+    };
+    /**
+     * `first_token_time` is when the first output token was produced (RFC3339
+     * date-time), when recorded for streamed runs.
+     */
+    first_token_time?: string;
+    /**
+     * `inputs` is the run input payload (arbitrary JSON object).
+     */
+    inputs?: unknown;
+    /**
+     * `inputs_preview` is a truncated plain-text preview of inputs.
+     */
+    inputs_preview?: string;
+    /**
+     * `is_in_dataset` is true when this run is linked to a dataset example.
+     */
+    is_in_dataset?: boolean;
+    /**
+     * `is_root` is true when this run has no parent (it is the trace root).
+     */
+    is_root?: boolean;
+    /**
+     * `latency_seconds` is wall-clock duration from start to end in seconds.
+     */
+    latency_seconds?: number;
+    /**
+     * `manifest` is the serialized configuration of the traced component (for example
+     * the model parameters, prompt template, or pipeline definition), when recorded.
+     */
+    manifest?: unknown;
+    /**
+     * `metadata` is arbitrary user-defined JSON metadata.
+     */
+    metadata?: unknown;
+    /**
+     * `name` is a human-readable label for the run (for example the model name,
+     * function name, or step name chosen when the run was traced).
+     */
+    name?: string;
+    /**
+     * `outputs` is the run output payload (arbitrary JSON object).
+     */
+    outputs?: unknown;
+    /**
+     * `outputs_preview` is a truncated plain-text preview of outputs.
+     */
+    outputs_preview?: string;
+    /**
+     * `parent_run_ids` lists ancestor run UUIDs from the trace root down to the direct
+     * parent.
+     */
+    parent_run_ids?: Array<string>;
+    /**
+     * `price_model_id` identifies the pricing model UUID used for cost estimates, when
+     * recorded.
+     */
+    price_model_id?: string;
+    /**
+     * `project_id` is the tracing project UUID this run was logged to.
+     */
+    project_id?: string;
+    /**
+     * `prompt_cost` is estimated USD cost for the prompt.
+     */
+    prompt_cost?: number;
+    /**
+     * `prompt_cost_details` is the per-category USD breakdown of `prompt_cost`.
+     * Categories mirror `prompt_token_details`. Returned only when the
+     * `PROMPT_COST_DETAILS` field is requested.
+     */
+    prompt_cost_details?: QueryRunResponse.PromptCostDetails;
+    /**
+     * `prompt_token_details` is the per-category breakdown of `prompt_tokens`.
+     * Category names are model-specific (for example `cache_read`, `cache_write`).
+     * Returned only when the `PROMPT_TOKEN_DETAILS` field is requested.
+     */
+    prompt_token_details?: QueryRunResponse.PromptTokenDetails;
+    /**
+     * `prompt_tokens` is the prompt-side token count.
+     */
+    prompt_tokens?: number;
+    /**
+     * `reference_dataset_id` is the dataset UUID for the reference example, if any.
+     */
+    reference_dataset_id?: string;
+    /**
+     * `reference_example_id` is the dataset example UUID this run was compared
+     * against, if any.
+     */
+    reference_example_id?: string;
+    /**
+     * `run_type` identifies what kind of operation this run represents (for example an
+     * LLM call, a tool invocation, or a chain step). See the `RunType` enum for
+     * allowed values.
+     */
+    run_type?: 'TOOL' | 'CHAIN' | 'LLM' | 'RETRIEVER' | 'EMBEDDING' | 'PROMPT' | 'PARSER';
+    /**
+     * `share_url` is the fully-qualified URL of this run's public view, rooted at the
+     * deployment's LangSmith app origin (for example
+     * `https://smith.langchain.com/public/4f7a1b2c-8d9e-4a0b-9c1d-2e3f4a5b6c7d/r`). It
+     * is returned only when `SHARE_URL` is included in `selects`, and only when the
+     * run has been explicitly shared; the URL remains stable until the run is
+     * unshared. Anyone with this URL can view the run anonymously, so treat it as a
+     * secret and do not log it.
+     */
+    share_url?: string;
+    /**
+     * `start_time` is when the run started (RFC3339 date-time).
+     */
+    start_time?: string;
+    /**
+     * `status` is the completion status of the run.
+     */
+    status?: 'SUCCESS' | 'ERROR' | 'PENDING';
+    /**
+     * `tags` lists user-defined tags on this run.
+     */
+    tags?: Array<string>;
+    /**
+     * `thread_evaluation_time` is thread-level evaluation timing (RFC3339 date-time),
+     * when recorded.
+     */
+    thread_evaluation_time?: string;
+    /**
+     * `thread_id` is the conversation thread UUID this run belongs to, if any.
+     */
+    thread_id?: string;
+    /**
+     * `total_cost` is total estimated USD cost (prompt plus completion).
+     */
+    total_cost?: number;
+    /**
+     * `total_tokens` is prompt plus completion tokens.
+     */
+    total_tokens?: number;
+    /**
+     * `trace_id` is the root trace UUID; for a root run it matches `id`.
+     */
+    trace_id?: string;
 }
-export interface RequestBodyForRunsGenerateQuery {
-    query: string;
-    feedback_keys?: Array<'user_score' | 'user_edited' | 'user_removed' | 'user_opened_run' | 'user_selected_run' | 'results_size' | 'valid_filter'>;
+export declare namespace QueryRunResponse {
+    /**
+     * `completion_cost_details` is the per-category USD breakdown of
+     * `completion_cost`. Categories mirror `completion_token_details`. Returned only
+     * when the `COMPLETION_COST_DETAILS` field is requested.
+     */
+    interface CompletionCostDetails {
+        /**
+         * `raw` maps each category name to its estimated USD cost.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+    /**
+     * `completion_token_details` is the per-category breakdown of `completion_tokens`.
+     * Category names are model-specific (for example `reasoning`, `audio`). Returned
+     * only when the `COMPLETION_TOKEN_DETAILS` field is requested.
+     */
+    interface CompletionTokenDetails {
+        /**
+         * `raw` maps each category name to its completion-token count.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+    interface Event {
+        /**
+         * `kwargs` is the event payload — an opaque JSON object whose shape depends on
+         * `name` and on the emitting SDK. For example LangChain emits `{"token": {...}}`
+         * for `new_token` events, tool-call start/end details for tool events, and
+         * arbitrary user-defined payloads for custom events. Clients should treat `kwargs`
+         * as untyped JSON: do not assume specific keys exist for a given `name`, and
+         * tolerate additional unknown keys appearing over time.
+         */
+        kwargs?: unknown;
+        /**
+         * `name` is the event kind. Common values emitted by the LangChain/LangSmith
+         * tracer SDKs include `"start"`, `"end"`, and `"new_token"`, but applications may
+         * emit arbitrary strings for their own instrumentation.
+         */
+        name?: string;
+        /**
+         * `time` is when the event occurred (RFC3339 date-time with millisecond
+         * precision).
+         */
+        time?: string;
+    }
+    interface FeedbackStats {
+        /**
+         * `avg` is the arithmetic mean of numeric feedback scores for this key on the run,
+         * or `null` when no numeric score has been recorded (for example purely
+         * categorical feedback).
+         */
+        avg?: number;
+        /**
+         * `comments` is a sample of human-readable comments attached to feedback points
+         * for this key, in no particular order. May be empty; is not exhaustive when many
+         * comments exist.
+         */
+        comments?: Array<string>;
+        /**
+         * `contains_thread_feedback` is true when at least one feedback point for this key
+         * was submitted at the thread level (rather than at an individual run). Always
+         * false on responses that already describe a single run in isolation.
+         */
+        contains_thread_feedback?: boolean;
+        /**
+         * `errors` is the number of feedback points recorded as errors rather than
+         * successful scores (for example an automated evaluator that raised an exception).
+         * Defaults to 0 when no errors occurred.
+         */
+        errors?: number;
+        /**
+         * `max` is the largest numeric feedback score recorded for this key on the run, or
+         * `null` when no numeric score has been recorded.
+         */
+        max?: number;
+        /**
+         * `min` is the smallest numeric feedback score recorded for this key on the run,
+         * or `null` when no numeric score has been recorded.
+         */
+        min?: number;
+        /**
+         * `n` is the number of feedback points recorded for this key on the run. For
+         * numeric feedback this is the sample size behind `avg`, `min`, `max`, and
+         * `stdev`; for categorical feedback it is the sum of the `values` counts.
+         */
+        n?: number;
+        /**
+         * `sources` is a sample of feedback sources for this key. Each entry is either a
+         * plain string identifier (for example `"api"`, `"app"`, `"model"`) or a JSON
+         * object describing a synthetic source (for example
+         * `{"type": "__ls_composite_feedback"}` for a computed aggregate). Clients must
+         * tolerate both shapes.
+         */
+        sources?: Array<unknown>;
+        /**
+         * `stdev` is the sample standard deviation of numeric feedback scores for this key
+         * on the run, or `null` when it cannot be computed (for example fewer than two
+         * numeric scores, or purely categorical feedback).
+         */
+        stdev?: number;
+        /**
+         * `values` is the distribution of categorical feedback labels for this key,
+         * mapping each label to its occurrence count. Empty (`{}`) for purely numeric
+         * feedback.
+         */
+        values?: {
+            [key: string]: number;
+        };
+    }
+    /**
+     * `prompt_cost_details` is the per-category USD breakdown of `prompt_cost`.
+     * Categories mirror `prompt_token_details`. Returned only when the
+     * `PROMPT_COST_DETAILS` field is requested.
+     */
+    interface PromptCostDetails {
+        /**
+         * `raw` maps each category name to its estimated USD cost.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+    /**
+     * `prompt_token_details` is the per-category breakdown of `prompt_tokens`.
+     * Category names are model-specific (for example `cache_read`, `cache_write`).
+     * Returned only when the `PROMPT_TOKEN_DETAILS` field is requested.
+     */
+    interface PromptTokenDetails {
+        /**
+         * `raw` maps each category name to its prompt-token count.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
 }
 export interface ResponseBodyForRunsGenerateQuery {
     feedback_urls: {
@@ -236,6 +543,7 @@ export interface RunStatsQueryParams {
      */
     group_by?: SessionsAPI.RunStatsGroupBy | null;
     groups?: Array<string | null> | null;
+    include_details?: boolean;
     is_root?: boolean | null;
     parent_run?: string | null;
     query?: string | null;
@@ -245,7 +553,7 @@ export interface RunStatsQueryParams {
      */
     run_type?: RunTypeEnum | null;
     search_filter?: string | null;
-    select?: Array<'run_count' | 'latency_p50' | 'latency_p99' | 'latency_avg' | 'first_token_p50' | 'first_token_p99' | 'total_tokens' | 'prompt_tokens' | 'completion_tokens' | 'median_tokens' | 'completion_tokens_p50' | 'prompt_tokens_p50' | 'tokens_p99' | 'completion_tokens_p99' | 'prompt_tokens_p99' | 'last_run_start_time' | 'feedback_stats' | 'thread_feedback_stats' | 'run_facets' | 'error_rate' | 'streaming_rate' | 'total_cost' | 'prompt_cost' | 'completion_cost' | 'cost_p50' | 'cost_p99' | 'session_feedback_stats' | 'all_run_stats' | 'all_token_stats' | 'prompt_token_details' | 'completion_token_details' | 'prompt_cost_details' | 'completion_cost_details'> | null;
+    select?: Array<'run_count' | 'latency_p50' | 'latency_p99' | 'latency_avg' | 'first_token_p50' | 'first_token_p99' | 'total_tokens' | 'prompt_tokens' | 'completion_tokens' | 'median_tokens' | 'completion_tokens_p50' | 'prompt_tokens_p50' | 'tokens_p99' | 'completion_tokens_p99' | 'prompt_tokens_p99' | 'last_run_start_time' | 'feedback_stats' | 'thread_feedback_stats' | 'run_facets' | 'error_rate' | 'streaming_rate' | 'total_cost' | 'prompt_cost' | 'completion_cost' | 'cost_p50' | 'cost_p99' | 'session_feedback_stats' | 'all_run_stats' | 'all_token_stats' | 'group_count' | 'prompt_token_details' | 'completion_token_details' | 'prompt_cost_details' | 'completion_cost_details'> | null;
     session?: Array<string> | null;
     skip_pagination?: boolean | null;
     start_time?: string | null;
@@ -262,281 +570,231 @@ export type RunTypeEnum = 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' |
  * Enum for run data source types.
  */
 export type RunsFilterDataSourceTypeEnum = 'current' | 'historical' | 'lite' | 'root_lite' | 'runs_feedbacks_rmt_wide';
-export type RunCreateResponse = {
-    [key: string]: RunCreateResponse.item;
-};
-export declare namespace RunCreateResponse {
-    interface item {
-    }
-}
-export type RunUpdateResponse = {
-    [key: string]: RunUpdateResponse.item;
-};
-export declare namespace RunUpdateResponse {
-    interface item {
-    }
-}
-export type RunIngestBatchResponse = {
-    [key: string]: RunIngestBatchResponse.item;
-};
-export declare namespace RunIngestBatchResponse {
-    interface item {
-    }
-}
-export interface RunQueryResponse {
-    cursors: {
-        [key: string]: string | null;
-    };
-    runs: Array<RunSchema>;
-    parsed_query?: string | null;
-    search_cursors?: {
-        [key: string]: unknown;
-    } | null;
-}
-export type RunStatsResponse = RunStatsResponse.RunStats | {
-    [key: string]: RunStatsResponse.RunStats;
-};
-export declare namespace RunStatsResponse {
-    interface RunStats {
-        completion_cost?: number | null;
-        completion_cost_details?: {
-            [key: string]: unknown;
-        } | null;
-        completion_token_details?: {
-            [key: string]: unknown;
-        } | null;
-        completion_tokens?: number | null;
-        completion_tokens_p50?: number | null;
-        completion_tokens_p99?: number | null;
-        cost_p50?: number | null;
-        cost_p99?: number | null;
-        error_rate?: number | null;
-        feedback_stats?: {
-            [key: string]: unknown;
-        } | null;
-        first_token_p50?: number | null;
-        first_token_p99?: number | null;
-        last_run_start_time?: string | null;
-        latency_p50?: number | null;
-        latency_p99?: number | null;
-        median_tokens?: number | null;
-        prompt_cost?: number | null;
-        prompt_cost_details?: {
-            [key: string]: unknown;
-        } | null;
-        prompt_token_details?: {
-            [key: string]: unknown;
-        } | null;
-        prompt_tokens?: number | null;
-        prompt_tokens_p50?: number | null;
-        prompt_tokens_p99?: number | null;
-        run_count?: number | null;
-        run_facets?: Array<{
-            [key: string]: unknown;
-        }> | null;
-        streaming_rate?: number | null;
-        tokens_p99?: number | null;
-        total_cost?: number | null;
-        total_tokens?: number | null;
-    }
-    interface RunStats {
-        completion_cost?: number | null;
-        completion_cost_details?: {
-            [key: string]: unknown;
-        } | null;
-        completion_token_details?: {
-            [key: string]: unknown;
-        } | null;
-        completion_tokens?: number | null;
-        completion_tokens_p50?: number | null;
-        completion_tokens_p99?: number | null;
-        cost_p50?: number | null;
-        cost_p99?: number | null;
-        error_rate?: number | null;
-        feedback_stats?: {
-            [key: string]: unknown;
-        } | null;
-        first_token_p50?: number | null;
-        first_token_p99?: number | null;
-        last_run_start_time?: string | null;
-        latency_p50?: number | null;
-        latency_p99?: number | null;
-        median_tokens?: number | null;
-        prompt_cost?: number | null;
-        prompt_cost_details?: {
-            [key: string]: unknown;
-        } | null;
-        prompt_token_details?: {
-            [key: string]: unknown;
-        } | null;
-        prompt_tokens?: number | null;
-        prompt_tokens_p50?: number | null;
-        prompt_tokens_p99?: number | null;
-        run_count?: number | null;
-        run_facets?: Array<{
-            [key: string]: unknown;
-        }> | null;
-        streaming_rate?: number | null;
-        tokens_p99?: number | null;
-        total_cost?: number | null;
-        total_tokens?: number | null;
-    }
-}
-export type RunUpdate2Response = unknown;
-export interface RunCreateParams {
-    id?: string;
-    dotted_order?: string;
-    end_time?: string;
-    error?: string;
-    events?: Array<{
-        [key: string]: unknown;
-    }>;
-    extra?: {
-        [key: string]: unknown;
-    };
-    input_attachments?: {
-        [key: string]: unknown;
-    };
-    inputs?: {
-        [key: string]: unknown;
-    };
-    name?: string;
-    output_attachments?: {
-        [key: string]: unknown;
-    };
-    outputs?: {
-        [key: string]: unknown;
-    };
-    parent_run_id?: string;
-    reference_example_id?: string;
-    run_type?: 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser';
-    serialized?: {
-        [key: string]: unknown;
-    };
-    session_id?: string;
-    session_name?: string;
-    start_time?: string;
-    status?: string;
-    tags?: Array<string>;
-    trace_id?: string;
-}
-export interface RunRetrieveParams {
-    exclude_s3_stored_attributes?: boolean;
-    exclude_serialized?: boolean;
-    include_messages?: boolean;
-    session_id?: string | null;
-    start_time?: string | null;
-}
-export interface RunUpdateParams {
-    id?: string;
-    dotted_order?: string;
-    end_time?: string;
-    error?: string;
-    events?: Array<{
-        [key: string]: unknown;
-    }>;
-    extra?: {
-        [key: string]: unknown;
-    };
-    input_attachments?: {
-        [key: string]: unknown;
-    };
-    inputs?: {
-        [key: string]: unknown;
-    };
-    name?: string;
-    output_attachments?: {
-        [key: string]: unknown;
-    };
-    outputs?: {
-        [key: string]: unknown;
-    };
-    parent_run_id?: string;
-    reference_example_id?: string;
-    run_type?: 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser';
-    serialized?: {
-        [key: string]: unknown;
-    };
-    session_id?: string;
-    session_name?: string;
-    start_time?: string;
-    status?: string;
-    tags?: Array<string>;
+export interface RunQueryV2Params extends ItemsCursorPostPaginationParams {
+    /**
+     * Body param: `filter` narrows results to runs matching this LangSmith filter
+     * expression, evaluated against each individual run. For example: and(eq(run_type,
+     * "llm"), gt(latency, 5)) or eq(status, "error"). See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
+     */
+    filter?: string;
+    /**
+     * Body param: `has_error` filters to runs that errored (true) or completed without
+     * error (false).
+     */
+    has_error?: boolean;
+    /**
+     * Body param: `ids` optionally limits the request to these run UUIDs.
+     */
+    ids?: Array<string>;
+    /**
+     * Body param: `is_root` returns only root runs (true) or only non-root runs
+     * (false).
+     */
+    is_root?: boolean;
+    /**
+     * Body param: `max_start_time` is the upper bound for run `start_time` (RFC3339).
+     * Defaults to now.
+     */
+    max_start_time?: string;
+    /**
+     * Body param: `min_start_time` is the lower bound for run `start_time` (RFC3339).
+     * Defaults to 1 day ago.
+     */
+    min_start_time?: string;
+    /**
+     * Body param: `project_ids` lists tracing project UUIDs to query. Required unless
+     * `reference_dataset_id` is set. Mutually exclusive with `reference_dataset_id` —
+     * set exactly one of them.
+     */
+    project_ids?: Array<string>;
+    /**
+     * Body param: `reference_dataset_id` resolves session IDs server-side from the
+     * dataset. Required unless `project_ids` is set. Mutually exclusive with
+     * `project_ids` — set exactly one of them. When provided and `min_start_time` is
+     * omitted, the server derives it from the earliest session creation date.
+     */
+    reference_dataset_id?: string;
+    /**
+     * Body param: `reference_examples` optionally limits to runs linked to these
+     * dataset example UUIDs.
+     */
+    reference_examples?: Array<string>;
+    /**
+     * Body param: `run_type`, when set, restricts results to runs whose `run_type`
+     * equals this value.
+     */
+    run_type?: 'TOOL' | 'CHAIN' | 'LLM' | 'RETRIEVER' | 'EMBEDDING' | 'PROMPT' | 'PARSER';
+    /**
+     * Body param: `selects` lists which properties to include on each returned run. If
+     * omitted, only `id` is returned. Properties not listed are omitted from each run
+     * object.
+     */
+    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'>;
+    /**
+     * Body param: `trace_filter` narrows results to runs whose root trace matches this
+     * LangSmith filter expression. Use this to filter by properties of the trace's
+     * root run — for example eq(status, "success") to include only traces that
+     * completed without error. See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
+     */
+    trace_filter?: string;
+    /**
+     * Body param: `trace_id` optionally limits results to runs belonging to this trace
+     * UUID.
+     */
     trace_id?: string;
+    /**
+     * Body param: `tree_filter` narrows results to runs that belong to a trace
+     * containing at least one run matching this LangSmith filter expression anywhere
+     * in the run tree (not just the root). Use this to find runs inside traces that
+     * involved a specific tool, tag, or model — for example has(tags, "production") or
+     * eq(name, "my_tool"). See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
+     */
+    tree_filter?: string;
+    /**
+     * Header param: application/json
+     */
+    Accept?: string;
 }
-export interface RunIngestBatchParams {
-    patch?: Array<Run>;
-    post?: Array<Run>;
+export interface RunRetrieveV2Params {
+    /**
+     * Query param: `project_id` is the UUID of the tracing project that owns the run.
+     */
+    project_id: string;
+    /**
+     * Query param: `start_time` is the run's `start_time` (RFC3339 date-time), used
+     * together with `project_id` to locate the run.
+     */
+    start_time: string;
+    /**
+     * Query param: `selects` lists which properties to include on the 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 RunQueryParams {
-    id?: Array<string> | null;
-    cursor?: string | null;
+export interface RunRetrieveParams {
     /**
-     * Enum for run data source types.
+     * Query param: `project_id` is the UUID of the tracing project that owns the run.
      */
-    data_source_type?: RunsFilterDataSourceTypeEnum | null;
-    end_time?: string | null;
-    error?: boolean | null;
-    execution_order?: number | null;
-    filter?: string | null;
-    is_root?: boolean | null;
-    limit?: number;
+    project_id: string;
     /**
-     * Enum for run start date order.
+     * Query param: `start_time` is the run's `start_time` (RFC3339 date-time), used
+     * together with `project_id` to locate the run.
      */
-    order?: 'asc' | 'desc';
-    parent_run?: string | null;
-    query?: string | null;
-    reference_example?: Array<string> | null;
+    start_time: string;
     /**
-     * Enum for run types.
+     * Query param: `selects` lists which properties to include on the returned run
+     * (repeatable query parameter). Accepts any value of the `RunSelectField` enum. If
+     * omitted, only `id` is returned.
      */
-    run_type?: RunTypeEnum | null;
-    search_filter?: string | null;
-    select?: Array<'id' | 'name' | 'run_type' | 'start_time' | 'end_time' | 'status' | 'error' | 'extra' | 'events' | 'inputs' | 'inputs_preview' | 'inputs_s3_urls' | 'inputs_or_signed_url' | 'outputs' | 'outputs_preview' | 'outputs_s3_urls' | 'outputs_or_signed_url' | 's3_urls' | 'error_or_signed_url' | 'events_or_signed_url' | 'extra_or_signed_url' | 'serialized_or_signed_url' | 'parent_run_id' | 'manifest_id' | 'manifest_s3_id' | 'manifest' | 'session_id' | 'serialized' | 'reference_example_id' | 'reference_dataset_id' | 'total_tokens' | 'prompt_tokens' | 'prompt_token_details' | 'completion_tokens' | 'completion_token_details' | 'total_cost' | 'prompt_cost' | 'prompt_cost_details' | 'completion_cost' | 'completion_cost_details' | 'price_model_id' | 'first_token_time' | 'trace_id' | 'dotted_order' | 'last_queued_at' | 'feedback_stats' | 'child_run_ids' | 'parent_run_ids' | 'tags' | 'in_dataset' | 'app_path' | 'share_token' | 'trace_tier' | 'trace_first_received_at' | 'ttl_seconds' | 'trace_upgrade' | 'thread_id' | 'trace_min_max_start_time' | 'messages' | 'inserted_at'>;
-    session?: Array<string> | null;
-    skip_pagination?: boolean | null;
-    skip_prev_cursor?: boolean;
-    start_time?: string | null;
-    trace?: string | null;
-    trace_filter?: string | null;
-    tree_filter?: string | null;
-    use_experimental_search?: boolean;
+    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 RunStatsParams {
-    id?: Array<string> | null;
+export interface RunQueryParams extends ItemsCursorPostPaginationParams {
     /**
-     * Enum for run data source types.
+     * Body param: `filter` narrows results to runs matching this LangSmith filter
+     * expression, evaluated against each individual run. For example: and(eq(run_type,
+     * "llm"), gt(latency, 5)) or eq(status, "error"). See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
      */
-    data_source_type?: RunsFilterDataSourceTypeEnum | null;
-    end_time?: string | null;
-    error?: boolean | null;
-    execution_order?: number | null;
-    filter?: string | null;
+    filter?: string;
     /**
-     * Group by param for run stats.
+     * Body param: `has_error` filters to runs that errored (true) or completed without
+     * error (false).
      */
-    group_by?: SessionsAPI.RunStatsGroupBy | null;
-    groups?: Array<string | null> | null;
-    is_root?: boolean | null;
-    parent_run?: string | null;
-    query?: string | null;
-    reference_example?: Array<string> | null;
+    has_error?: boolean;
     /**
-     * Enum for run types.
+     * Body param: `ids` optionally limits the request to these run UUIDs.
      */
-    run_type?: RunTypeEnum | null;
-    search_filter?: string | null;
-    select?: Array<'run_count' | 'latency_p50' | 'latency_p99' | 'latency_avg' | 'first_token_p50' | 'first_token_p99' | 'total_tokens' | 'prompt_tokens' | 'completion_tokens' | 'median_tokens' | 'completion_tokens_p50' | 'prompt_tokens_p50' | 'tokens_p99' | 'completion_tokens_p99' | 'prompt_tokens_p99' | 'last_run_start_time' | 'feedback_stats' | 'thread_feedback_stats' | 'run_facets' | 'error_rate' | 'streaming_rate' | 'total_cost' | 'prompt_cost' | 'completion_cost' | 'cost_p50' | 'cost_p99' | 'session_feedback_stats' | 'all_run_stats' | 'all_token_stats' | 'prompt_token_details' | 'completion_token_details' | 'prompt_cost_details' | 'completion_cost_details'> | null;
-    session?: Array<string> | null;
-    skip_pagination?: boolean | null;
-    start_time?: string | null;
-    trace?: string | null;
-    trace_filter?: string | null;
-    tree_filter?: string | null;
-    use_experimental_search?: boolean;
+    ids?: Array<string>;
+    /**
+     * Body param: `is_root` returns only root runs (true) or only non-root runs
+     * (false).
+     */
+    is_root?: boolean;
+    /**
+     * Body param: `max_start_time` is the upper bound for run `start_time` (RFC3339).
+     * Defaults to now.
+     */
+    max_start_time?: string;
+    /**
+     * Body param: `min_start_time` is the lower bound for run `start_time` (RFC3339).
+     * Defaults to 1 day ago.
+     */
+    min_start_time?: string;
+    /**
+     * Body param: `project_ids` lists tracing project UUIDs to query. Required unless
+     * `reference_dataset_id` is set. Mutually exclusive with `reference_dataset_id` —
+     * set exactly one of them.
+     */
+    project_ids?: Array<string>;
+    /**
+     * Body param: `reference_dataset_id` resolves session IDs server-side from the
+     * dataset. Required unless `project_ids` is set. Mutually exclusive with
+     * `project_ids` — set exactly one of them. When provided and `min_start_time` is
+     * omitted, the server derives it from the earliest session creation date.
+     */
+    reference_dataset_id?: string;
+    /**
+     * Body param: `reference_examples` optionally limits to runs linked to these
+     * dataset example UUIDs.
+     */
+    reference_examples?: Array<string>;
+    /**
+     * Body param: `run_type`, when set, restricts results to runs whose `run_type`
+     * equals this value.
+     */
+    run_type?: 'TOOL' | 'CHAIN' | 'LLM' | 'RETRIEVER' | 'EMBEDDING' | 'PROMPT' | 'PARSER';
+    /**
+     * Body param: `selects` lists which properties to include on each returned run. If
+     * omitted, only `id` is returned. Properties not listed are omitted from each run
+     * object.
+     */
+    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'>;
+    /**
+     * Body param: `trace_filter` narrows results to runs whose root trace matches this
+     * LangSmith filter expression. Use this to filter by properties of the trace's
+     * root run — for example eq(status, "success") to include only traces that
+     * completed without error. See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
+     */
+    trace_filter?: string;
+    /**
+     * Body param: `trace_id` optionally limits results to runs belonging to this trace
+     * UUID.
+     */
+    trace_id?: string;
+    /**
+     * Body param: `tree_filter` narrows results to runs that belong to a trace
+     * containing at least one run matching this LangSmith filter expression anywhere
+     * in the run tree (not just the root). Use this to find runs inside traces that
+     * involved a specific tool, tag, or model — for example has(tags, "production") or
+     * eq(name, "my_tool"). See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
+     */
+    tree_filter?: string;
+    /**
+     * Header param: application/json
+     */
+    Accept?: string;
 }
 export declare namespace Runs {
-    export { type BodyParamsForRunSchema as BodyParamsForRunSchema, type RequestBodyForRunsGenerateQuery as RequestBodyForRunsGenerateQuery, type ResponseBodyForRunsGenerateQuery as ResponseBodyForRunsGenerateQuery, type Run as Run, type RunSchema as RunSchema, type RunStatsQueryParams as RunStatsQueryParams, type RunTypeEnum as RunTypeEnum, type RunsFilterDataSourceTypeEnum as RunsFilterDataSourceTypeEnum, type RunCreateResponse as RunCreateResponse, type RunUpdateResponse as RunUpdateResponse, type RunIngestBatchResponse as RunIngestBatchResponse, type RunQueryResponse as RunQueryResponse, type RunStatsResponse as RunStatsResponse, type RunUpdate2Response as RunUpdate2Response, type RunCreateParams as RunCreateParams, type RunRetrieveParams as RunRetrieveParams, type RunUpdateParams as RunUpdateParams, type RunIngestBatchParams as RunIngestBatchParams, type RunQueryParams as RunQueryParams, type RunStatsParams as RunStatsParams, };
+    export { type QueryRunResponse as QueryRunResponse, type ResponseBodyForRunsGenerateQuery as ResponseBodyForRunsGenerateQuery, type Run as Run, type RunSchema as RunSchema, type RunStatsQueryParams as RunStatsQueryParams, type RunTypeEnum as RunTypeEnum, type RunsFilterDataSourceTypeEnum as RunsFilterDataSourceTypeEnum, type QueryRunResponsesItemsCursorPostPagination as QueryRunResponsesItemsCursorPostPagination, type RunQueryV2Params as RunQueryV2Params, type RunRetrieveV2Params as RunRetrieveV2Params, type RunRetrieveParams as RunRetrieveParams, type RunQueryParams as RunQueryParams, };
     export { Rules as Rules };
 }