langsmith 0.10.9 → 0.10.10

package/src/resources/sessions.ts

@@ -0,0 +1,1441 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Sessions extends APIResource {
+  /**
+   * **Beta:** This endpoint is in active development and may change without notice.
+   * Returns the tracing project (session) an address names. An address is an AGENT
+   * (`id` and `environment`), an EXPERIMENT (`id`), or an EVALUATOR (no `id`:
+   * evaluator traces share one project per workspace). Send `kind` and `environment`
+   * in upper case, as listed; they are matched case-insensitively, while the Agent
+   * `id` is case-sensitive. An address that does not exist, or whose project you
+   * cannot read, is a 404. Pass the returned `session_id` to any endpoint that takes
+   * a project (session) ID. This is not supported on a BYOC data plane yet, and is a
+   * 501 there.
+   */
+  resolve(query: SessionResolveParams, options?: RequestOptions): APIPromise<SessionResolveResponse> {
+    return this._client.get('/api/v1/sessions/resolutions', { query, ...options });
+  }
+}
+
+export interface CustomChartsSection {
+  id: string;
+
+  charts: Array<
+    CustomChartsSection.SingleCustomChartResponseSerialized | CustomChartsSection.CustomTextBlock
+  >;
+
+  title: string;
+
+  description?: string | null;
+
+  index?: number | null;
+
+  layout?: CustomChartsSection.Layout | null;
+
+  session_id?: string | null;
+
+  sub_sections?: Array<CustomChartsSection.SubSection> | null;
+}
+
+export namespace CustomChartsSection {
+  export interface SingleCustomChartResponseSerialized {
+    id: string;
+
+    chart_type: 'line' | 'bar' | 'table' | 'kpi' | 'top-k' | 'pie';
+
+    data: Array<SingleCustomChartResponseSerialized.Data>;
+
+    index: number;
+
+    series: Array<SingleCustomChartResponseSerialized.Series>;
+
+    title: string;
+
+    common_filters?: SingleCustomChartResponseSerialized.CommonFilters | null;
+
+    description?: string | null;
+
+    metadata?: { [key: string]: unknown } | null;
+  }
+
+  export namespace SingleCustomChartResponseSerialized {
+    export interface Data {
+      series_id: string;
+
+      timestamp: string;
+
+      value: number | { [key: string]: unknown } | null;
+
+      group?: string | null;
+    }
+
+    export interface Series {
+      id: string;
+
+      name: string;
+
+      feedback_key?: string | null;
+
+      filter_definition?: Series.CustomChartFilterByTracingProject | Series.CustomChartFilterByDataset | null;
+
+      filters?: Series.Filters | null;
+
+      /**
+       * Include additional information about where the group_by param was set.
+       */
+      group_by?: Series.GroupBy | null;
+
+      group_by_definitions?: Array<Series.CustomChartGroupByPlain | Series.CustomChartGroupByComplex> | null;
+
+      metadata?: { [key: string]: unknown } | null;
+
+      /**
+       * Metrics you can chart. Feedback metrics are not available for
+       * organization-scoped charts.
+       */
+      metric?:
+        | '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'
+        | 'feedback'
+        | 'feedback_score_avg'
+        | 'feedback_values'
+        | 'total_cost'
+        | 'prompt_cost'
+        | 'completion_cost'
+        | 'error_rate'
+        | 'streaming_rate'
+        | 'cost_p50'
+        | 'cost_p99'
+        | null;
+
+      metric_definition?:
+        | Series.CustomChartFeedbackCountMetric
+        | Series.CustomChartMetricCount
+        | Series.CustomChartFeedbackScoreMetricScalar
+        | Series.CustomChartMetricScalar
+        | Series.CustomChartFeedbackScoreMetricPercentile
+        | Series.CustomChartMetricPercentile
+        | Series.CustomChartMetricRatioOutput
+        | null;
+
+      /**
+       * LGP Metrics you can chart.
+       */
+      project_metric?:
+        | 'memory_usage'
+        | 'cpu_usage'
+        | 'disk_usage'
+        | 'restart_count'
+        | 'replica_count'
+        | 'worker_count'
+        | 'lg_run_count'
+        | 'responses_per_second'
+        | 'error_responses_per_second'
+        | 'p95_latency'
+        | 'run_queue_wait_time'
+        | null;
+
+      workspace_id?: string | null;
+    }
+
+    export namespace Series {
+      export interface CustomChartFilterByTracingProject {
+        project_ids: Array<string>;
+
+        source_type: 'tracing_project';
+
+        run_filter?: string | null;
+
+        trace_filter?: string | null;
+
+        tree_filter?: string | null;
+      }
+
+      export interface CustomChartFilterByDataset {
+        dataset_ids: Array<string>;
+
+        source_type: 'dataset';
+      }
+
+      export interface Filters {
+        filter?: string | null;
+
+        session?: Array<string> | null;
+
+        trace_filter?: string | null;
+
+        tree_filter?: string | null;
+      }
+
+      /**
+       * Include additional information about where the group_by param was set.
+       */
+      export interface GroupBy {
+        attribute: 'name' | 'run_type' | 'tag' | 'metadata';
+
+        max_groups?: number;
+
+        path?: string | null;
+
+        set_by?: 'section' | 'series' | null;
+      }
+
+      export interface CustomChartGroupByPlain {
+        attribute: 'name' | 'run_type' | 'tag' | 'project' | 'status';
+      }
+
+      export interface CustomChartGroupByComplex {
+        attribute: 'metadata' | 'feedback_label';
+
+        path: string;
+      }
+
+      export interface CustomChartFeedbackCountMetric {
+        entity: 'feedback';
+
+        params: CustomChartFeedbackCountMetric.Params;
+
+        filter?: string | null;
+
+        type?: 'count';
+      }
+
+      export namespace CustomChartFeedbackCountMetric {
+        export interface Params {
+          feedback_key: string;
+        }
+      }
+
+      export interface CustomChartMetricCount {
+        filter?: string | null;
+
+        type?: 'count';
+      }
+
+      export interface CustomChartFeedbackScoreMetricScalar {
+        field: 'feedback_score';
+
+        params: CustomChartFeedbackScoreMetricScalar.Params;
+
+        type: 'sum' | 'max' | 'min' | 'avg';
+
+        filter?: string | null;
+      }
+
+      export namespace CustomChartFeedbackScoreMetricScalar {
+        export interface Params {
+          feedback_key: string;
+        }
+      }
+
+      export interface CustomChartMetricScalar {
+        field:
+          | 'latency_seconds'
+          | 'first_token_seconds'
+          | 'total_tokens'
+          | 'prompt_tokens'
+          | 'completion_tokens'
+          | 'prompt_token_details.cache_creation'
+          | 'prompt_token_details.cache_read'
+          | 'prompt_token_details.ephemeral_1h_input_tokens'
+          | 'prompt_token_details.ephemeral_5m_input_tokens'
+          | 'prompt_token_details.audio'
+          | 'prompt_token_details.image'
+          | 'prompt_token_details.video'
+          | 'completion_token_details.reasoning'
+          | 'completion_token_details.audio'
+          | 'completion_token_details.image'
+          | 'completion_token_details.video'
+          | 'total_cost'
+          | 'prompt_cost'
+          | 'completion_cost'
+          | 'feedback_score';
+
+        type: 'sum' | 'max' | 'min' | 'avg';
+
+        filter?: string | null;
+      }
+
+      export interface CustomChartFeedbackScoreMetricPercentile {
+        field: 'feedback_score';
+
+        params: CustomChartFeedbackScoreMetricPercentile.Params;
+
+        type: 'percentile';
+
+        filter?: string | null;
+      }
+
+      export namespace CustomChartFeedbackScoreMetricPercentile {
+        export interface Params {
+          feedback_key: string;
+
+          p: number;
+        }
+      }
+
+      export interface CustomChartMetricPercentile {
+        field:
+          | 'latency_seconds'
+          | 'first_token_seconds'
+          | 'total_tokens'
+          | 'prompt_tokens'
+          | 'completion_tokens'
+          | 'prompt_token_details.cache_creation'
+          | 'prompt_token_details.cache_read'
+          | 'prompt_token_details.ephemeral_1h_input_tokens'
+          | 'prompt_token_details.ephemeral_5m_input_tokens'
+          | 'prompt_token_details.audio'
+          | 'prompt_token_details.image'
+          | 'prompt_token_details.video'
+          | 'completion_token_details.reasoning'
+          | 'completion_token_details.audio'
+          | 'completion_token_details.image'
+          | 'completion_token_details.video'
+          | 'total_cost'
+          | 'prompt_cost'
+          | 'completion_cost'
+          | 'feedback_score';
+
+        params: CustomChartMetricPercentile.Params;
+
+        type: 'percentile';
+
+        filter?: string | null;
+      }
+
+      export namespace CustomChartMetricPercentile {
+        export interface Params {
+          p: number;
+        }
+      }
+
+      export interface CustomChartMetricRatioOutput {
+        denominator:
+          | CustomChartMetricRatioOutput.CustomChartFeedbackCountMetric
+          | CustomChartMetricRatioOutput.CustomChartMetricCount
+          | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricScalar
+          | CustomChartMetricRatioOutput.CustomChartMetricScalar
+          | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricPercentile
+          | CustomChartMetricRatioOutput.CustomChartMetricPercentile;
+
+        numerator:
+          | CustomChartMetricRatioOutput.CustomChartFeedbackCountMetric
+          | CustomChartMetricRatioOutput.CustomChartMetricCount
+          | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricScalar
+          | CustomChartMetricRatioOutput.CustomChartMetricScalar
+          | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricPercentile
+          | CustomChartMetricRatioOutput.CustomChartMetricPercentile;
+
+        type: 'ratio';
+      }
+
+      export namespace CustomChartMetricRatioOutput {
+        export interface CustomChartFeedbackCountMetric {
+          entity: 'feedback';
+
+          params: CustomChartFeedbackCountMetric.Params;
+
+          filter?: string | null;
+
+          type?: 'count';
+        }
+
+        export namespace CustomChartFeedbackCountMetric {
+          export interface Params {
+            feedback_key: string;
+          }
+        }
+
+        export interface CustomChartMetricCount {
+          filter?: string | null;
+
+          type?: 'count';
+        }
+
+        export interface CustomChartFeedbackScoreMetricScalar {
+          field: 'feedback_score';
+
+          params: CustomChartFeedbackScoreMetricScalar.Params;
+
+          type: 'sum' | 'max' | 'min' | 'avg';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartFeedbackScoreMetricScalar {
+          export interface Params {
+            feedback_key: string;
+          }
+        }
+
+        export interface CustomChartMetricScalar {
+          field:
+            | 'latency_seconds'
+            | 'first_token_seconds'
+            | 'total_tokens'
+            | 'prompt_tokens'
+            | 'completion_tokens'
+            | 'prompt_token_details.cache_creation'
+            | 'prompt_token_details.cache_read'
+            | 'prompt_token_details.ephemeral_1h_input_tokens'
+            | 'prompt_token_details.ephemeral_5m_input_tokens'
+            | 'prompt_token_details.audio'
+            | 'prompt_token_details.image'
+            | 'prompt_token_details.video'
+            | 'completion_token_details.reasoning'
+            | 'completion_token_details.audio'
+            | 'completion_token_details.image'
+            | 'completion_token_details.video'
+            | 'total_cost'
+            | 'prompt_cost'
+            | 'completion_cost'
+            | 'feedback_score';
+
+          type: 'sum' | 'max' | 'min' | 'avg';
+
+          filter?: string | null;
+        }
+
+        export interface CustomChartFeedbackScoreMetricPercentile {
+          field: 'feedback_score';
+
+          params: CustomChartFeedbackScoreMetricPercentile.Params;
+
+          type: 'percentile';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartFeedbackScoreMetricPercentile {
+          export interface Params {
+            feedback_key: string;
+
+            p: number;
+          }
+        }
+
+        export interface CustomChartMetricPercentile {
+          field:
+            | 'latency_seconds'
+            | 'first_token_seconds'
+            | 'total_tokens'
+            | 'prompt_tokens'
+            | 'completion_tokens'
+            | 'prompt_token_details.cache_creation'
+            | 'prompt_token_details.cache_read'
+            | 'prompt_token_details.ephemeral_1h_input_tokens'
+            | 'prompt_token_details.ephemeral_5m_input_tokens'
+            | 'prompt_token_details.audio'
+            | 'prompt_token_details.image'
+            | 'prompt_token_details.video'
+            | 'completion_token_details.reasoning'
+            | 'completion_token_details.audio'
+            | 'completion_token_details.image'
+            | 'completion_token_details.video'
+            | 'total_cost'
+            | 'prompt_cost'
+            | 'completion_cost'
+            | 'feedback_score';
+
+          params: CustomChartMetricPercentile.Params;
+
+          type: 'percentile';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartMetricPercentile {
+          export interface Params {
+            p: number;
+          }
+        }
+
+        export interface CustomChartFeedbackCountMetric {
+          entity: 'feedback';
+
+          params: CustomChartFeedbackCountMetric.Params;
+
+          filter?: string | null;
+
+          type?: 'count';
+        }
+
+        export namespace CustomChartFeedbackCountMetric {
+          export interface Params {
+            feedback_key: string;
+          }
+        }
+
+        export interface CustomChartMetricCount {
+          filter?: string | null;
+
+          type?: 'count';
+        }
+
+        export interface CustomChartFeedbackScoreMetricScalar {
+          field: 'feedback_score';
+
+          params: CustomChartFeedbackScoreMetricScalar.Params;
+
+          type: 'sum' | 'max' | 'min' | 'avg';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartFeedbackScoreMetricScalar {
+          export interface Params {
+            feedback_key: string;
+          }
+        }
+
+        export interface CustomChartMetricScalar {
+          field:
+            | 'latency_seconds'
+            | 'first_token_seconds'
+            | 'total_tokens'
+            | 'prompt_tokens'
+            | 'completion_tokens'
+            | 'prompt_token_details.cache_creation'
+            | 'prompt_token_details.cache_read'
+            | 'prompt_token_details.ephemeral_1h_input_tokens'
+            | 'prompt_token_details.ephemeral_5m_input_tokens'
+            | 'prompt_token_details.audio'
+            | 'prompt_token_details.image'
+            | 'prompt_token_details.video'
+            | 'completion_token_details.reasoning'
+            | 'completion_token_details.audio'
+            | 'completion_token_details.image'
+            | 'completion_token_details.video'
+            | 'total_cost'
+            | 'prompt_cost'
+            | 'completion_cost'
+            | 'feedback_score';
+
+          type: 'sum' | 'max' | 'min' | 'avg';
+
+          filter?: string | null;
+        }
+
+        export interface CustomChartFeedbackScoreMetricPercentile {
+          field: 'feedback_score';
+
+          params: CustomChartFeedbackScoreMetricPercentile.Params;
+
+          type: 'percentile';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartFeedbackScoreMetricPercentile {
+          export interface Params {
+            feedback_key: string;
+
+            p: number;
+          }
+        }
+
+        export interface CustomChartMetricPercentile {
+          field:
+            | 'latency_seconds'
+            | 'first_token_seconds'
+            | 'total_tokens'
+            | 'prompt_tokens'
+            | 'completion_tokens'
+            | 'prompt_token_details.cache_creation'
+            | 'prompt_token_details.cache_read'
+            | 'prompt_token_details.ephemeral_1h_input_tokens'
+            | 'prompt_token_details.ephemeral_5m_input_tokens'
+            | 'prompt_token_details.audio'
+            | 'prompt_token_details.image'
+            | 'prompt_token_details.video'
+            | 'completion_token_details.reasoning'
+            | 'completion_token_details.audio'
+            | 'completion_token_details.image'
+            | 'completion_token_details.video'
+            | 'total_cost'
+            | 'prompt_cost'
+            | 'completion_cost'
+            | 'feedback_score';
+
+          params: CustomChartMetricPercentile.Params;
+
+          type: 'percentile';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartMetricPercentile {
+          export interface Params {
+            p: number;
+          }
+        }
+      }
+    }
+
+    export interface CommonFilters {
+      filter?: string | null;
+
+      session?: Array<string> | null;
+
+      trace_filter?: string | null;
+
+      tree_filter?: string | null;
+    }
+  }
+
+  export interface CustomTextBlock {
+    id: string;
+
+    chart_type: 'text';
+
+    index: number;
+
+    markdown: string;
+
+    metadata?: { [key: string]: unknown } | null;
+  }
+
+  export interface Layout {
+    breakpoints: Layout.Breakpoints;
+
+    version: 1;
+  }
+
+  export namespace Layout {
+    export interface Breakpoints {
+      md: Breakpoints.Md;
+
+      sm: Breakpoints.Sm;
+    }
+
+    export namespace Breakpoints {
+      export interface Md {
+        rows: Array<Md.Row>;
+      }
+
+      export namespace Md {
+        export interface Row {
+          height_units: number;
+
+          items: Array<Row.Item>;
+        }
+
+        export namespace Row {
+          export interface Item {
+            chart_id: string;
+
+            width_units: number;
+          }
+        }
+      }
+
+      export interface Sm {
+        rows: Array<Sm.Row>;
+      }
+
+      export namespace Sm {
+        export interface Row {
+          height_units: number;
+
+          items: Array<Row.Item>;
+        }
+
+        export namespace Row {
+          export interface Item {
+            chart_id: string;
+
+            width_units: number;
+          }
+        }
+      }
+    }
+  }
+
+  export interface SubSection {
+    id: string;
+
+    charts: Array<SubSection.Chart>;
+
+    index: number;
+
+    title: string;
+
+    description?: string | null;
+  }
+
+  export namespace SubSection {
+    export interface Chart {
+      id: string;
+
+      chart_type: 'line' | 'bar' | 'table' | 'kpi' | 'top-k' | 'pie';
+
+      data: Array<Chart.Data>;
+
+      index: number;
+
+      series: Array<Chart.Series>;
+
+      title: string;
+
+      common_filters?: Chart.CommonFilters | null;
+
+      description?: string | null;
+
+      metadata?: { [key: string]: unknown } | null;
+    }
+
+    export namespace Chart {
+      export interface Data {
+        series_id: string;
+
+        timestamp: string;
+
+        value: number | { [key: string]: unknown } | null;
+
+        group?: string | null;
+      }
+
+      export interface Series {
+        id: string;
+
+        name: string;
+
+        feedback_key?: string | null;
+
+        filter_definition?:
+          | Series.CustomChartFilterByTracingProject
+          | Series.CustomChartFilterByDataset
+          | null;
+
+        filters?: Series.Filters | null;
+
+        /**
+         * Include additional information about where the group_by param was set.
+         */
+        group_by?: Series.GroupBy | null;
+
+        group_by_definitions?: Array<
+          Series.CustomChartGroupByPlain | Series.CustomChartGroupByComplex
+        > | null;
+
+        metadata?: { [key: string]: unknown } | null;
+
+        /**
+         * Metrics you can chart. Feedback metrics are not available for
+         * organization-scoped charts.
+         */
+        metric?:
+          | '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'
+          | 'feedback'
+          | 'feedback_score_avg'
+          | 'feedback_values'
+          | 'total_cost'
+          | 'prompt_cost'
+          | 'completion_cost'
+          | 'error_rate'
+          | 'streaming_rate'
+          | 'cost_p50'
+          | 'cost_p99'
+          | null;
+
+        metric_definition?:
+          | Series.CustomChartFeedbackCountMetric
+          | Series.CustomChartMetricCount
+          | Series.CustomChartFeedbackScoreMetricScalar
+          | Series.CustomChartMetricScalar
+          | Series.CustomChartFeedbackScoreMetricPercentile
+          | Series.CustomChartMetricPercentile
+          | Series.CustomChartMetricRatioOutput
+          | null;
+
+        /**
+         * LGP Metrics you can chart.
+         */
+        project_metric?:
+          | 'memory_usage'
+          | 'cpu_usage'
+          | 'disk_usage'
+          | 'restart_count'
+          | 'replica_count'
+          | 'worker_count'
+          | 'lg_run_count'
+          | 'responses_per_second'
+          | 'error_responses_per_second'
+          | 'p95_latency'
+          | 'run_queue_wait_time'
+          | null;
+
+        workspace_id?: string | null;
+      }
+
+      export namespace Series {
+        export interface CustomChartFilterByTracingProject {
+          project_ids: Array<string>;
+
+          source_type: 'tracing_project';
+
+          run_filter?: string | null;
+
+          trace_filter?: string | null;
+
+          tree_filter?: string | null;
+        }
+
+        export interface CustomChartFilterByDataset {
+          dataset_ids: Array<string>;
+
+          source_type: 'dataset';
+        }
+
+        export interface Filters {
+          filter?: string | null;
+
+          session?: Array<string> | null;
+
+          trace_filter?: string | null;
+
+          tree_filter?: string | null;
+        }
+
+        /**
+         * Include additional information about where the group_by param was set.
+         */
+        export interface GroupBy {
+          attribute: 'name' | 'run_type' | 'tag' | 'metadata';
+
+          max_groups?: number;
+
+          path?: string | null;
+
+          set_by?: 'section' | 'series' | null;
+        }
+
+        export interface CustomChartGroupByPlain {
+          attribute: 'name' | 'run_type' | 'tag' | 'project' | 'status';
+        }
+
+        export interface CustomChartGroupByComplex {
+          attribute: 'metadata' | 'feedback_label';
+
+          path: string;
+        }
+
+        export interface CustomChartFeedbackCountMetric {
+          entity: 'feedback';
+
+          params: CustomChartFeedbackCountMetric.Params;
+
+          filter?: string | null;
+
+          type?: 'count';
+        }
+
+        export namespace CustomChartFeedbackCountMetric {
+          export interface Params {
+            feedback_key: string;
+          }
+        }
+
+        export interface CustomChartMetricCount {
+          filter?: string | null;
+
+          type?: 'count';
+        }
+
+        export interface CustomChartFeedbackScoreMetricScalar {
+          field: 'feedback_score';
+
+          params: CustomChartFeedbackScoreMetricScalar.Params;
+
+          type: 'sum' | 'max' | 'min' | 'avg';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartFeedbackScoreMetricScalar {
+          export interface Params {
+            feedback_key: string;
+          }
+        }
+
+        export interface CustomChartMetricScalar {
+          field:
+            | 'latency_seconds'
+            | 'first_token_seconds'
+            | 'total_tokens'
+            | 'prompt_tokens'
+            | 'completion_tokens'
+            | 'prompt_token_details.cache_creation'
+            | 'prompt_token_details.cache_read'
+            | 'prompt_token_details.ephemeral_1h_input_tokens'
+            | 'prompt_token_details.ephemeral_5m_input_tokens'
+            | 'prompt_token_details.audio'
+            | 'prompt_token_details.image'
+            | 'prompt_token_details.video'
+            | 'completion_token_details.reasoning'
+            | 'completion_token_details.audio'
+            | 'completion_token_details.image'
+            | 'completion_token_details.video'
+            | 'total_cost'
+            | 'prompt_cost'
+            | 'completion_cost'
+            | 'feedback_score';
+
+          type: 'sum' | 'max' | 'min' | 'avg';
+
+          filter?: string | null;
+        }
+
+        export interface CustomChartFeedbackScoreMetricPercentile {
+          field: 'feedback_score';
+
+          params: CustomChartFeedbackScoreMetricPercentile.Params;
+
+          type: 'percentile';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartFeedbackScoreMetricPercentile {
+          export interface Params {
+            feedback_key: string;
+
+            p: number;
+          }
+        }
+
+        export interface CustomChartMetricPercentile {
+          field:
+            | 'latency_seconds'
+            | 'first_token_seconds'
+            | 'total_tokens'
+            | 'prompt_tokens'
+            | 'completion_tokens'
+            | 'prompt_token_details.cache_creation'
+            | 'prompt_token_details.cache_read'
+            | 'prompt_token_details.ephemeral_1h_input_tokens'
+            | 'prompt_token_details.ephemeral_5m_input_tokens'
+            | 'prompt_token_details.audio'
+            | 'prompt_token_details.image'
+            | 'prompt_token_details.video'
+            | 'completion_token_details.reasoning'
+            | 'completion_token_details.audio'
+            | 'completion_token_details.image'
+            | 'completion_token_details.video'
+            | 'total_cost'
+            | 'prompt_cost'
+            | 'completion_cost'
+            | 'feedback_score';
+
+          params: CustomChartMetricPercentile.Params;
+
+          type: 'percentile';
+
+          filter?: string | null;
+        }
+
+        export namespace CustomChartMetricPercentile {
+          export interface Params {
+            p: number;
+          }
+        }
+
+        export interface CustomChartMetricRatioOutput {
+          denominator:
+            | CustomChartMetricRatioOutput.CustomChartFeedbackCountMetric
+            | CustomChartMetricRatioOutput.CustomChartMetricCount
+            | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricScalar
+            | CustomChartMetricRatioOutput.CustomChartMetricScalar
+            | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricPercentile
+            | CustomChartMetricRatioOutput.CustomChartMetricPercentile;
+
+          numerator:
+            | CustomChartMetricRatioOutput.CustomChartFeedbackCountMetric
+            | CustomChartMetricRatioOutput.CustomChartMetricCount
+            | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricScalar
+            | CustomChartMetricRatioOutput.CustomChartMetricScalar
+            | CustomChartMetricRatioOutput.CustomChartFeedbackScoreMetricPercentile
+            | CustomChartMetricRatioOutput.CustomChartMetricPercentile;
+
+          type: 'ratio';
+        }
+
+        export namespace CustomChartMetricRatioOutput {
+          export interface CustomChartFeedbackCountMetric {
+            entity: 'feedback';
+
+            params: CustomChartFeedbackCountMetric.Params;
+
+            filter?: string | null;
+
+            type?: 'count';
+          }
+
+          export namespace CustomChartFeedbackCountMetric {
+            export interface Params {
+              feedback_key: string;
+            }
+          }
+
+          export interface CustomChartMetricCount {
+            filter?: string | null;
+
+            type?: 'count';
+          }
+
+          export interface CustomChartFeedbackScoreMetricScalar {
+            field: 'feedback_score';
+
+            params: CustomChartFeedbackScoreMetricScalar.Params;
+
+            type: 'sum' | 'max' | 'min' | 'avg';
+
+            filter?: string | null;
+          }
+
+          export namespace CustomChartFeedbackScoreMetricScalar {
+            export interface Params {
+              feedback_key: string;
+            }
+          }
+
+          export interface CustomChartMetricScalar {
+            field:
+              | 'latency_seconds'
+              | 'first_token_seconds'
+              | 'total_tokens'
+              | 'prompt_tokens'
+              | 'completion_tokens'
+              | 'prompt_token_details.cache_creation'
+              | 'prompt_token_details.cache_read'
+              | 'prompt_token_details.ephemeral_1h_input_tokens'
+              | 'prompt_token_details.ephemeral_5m_input_tokens'
+              | 'prompt_token_details.audio'
+              | 'prompt_token_details.image'
+              | 'prompt_token_details.video'
+              | 'completion_token_details.reasoning'
+              | 'completion_token_details.audio'
+              | 'completion_token_details.image'
+              | 'completion_token_details.video'
+              | 'total_cost'
+              | 'prompt_cost'
+              | 'completion_cost'
+              | 'feedback_score';
+
+            type: 'sum' | 'max' | 'min' | 'avg';
+
+            filter?: string | null;
+          }
+
+          export interface CustomChartFeedbackScoreMetricPercentile {
+            field: 'feedback_score';
+
+            params: CustomChartFeedbackScoreMetricPercentile.Params;
+
+            type: 'percentile';
+
+            filter?: string | null;
+          }
+
+          export namespace CustomChartFeedbackScoreMetricPercentile {
+            export interface Params {
+              feedback_key: string;
+
+              p: number;
+            }
+          }
+
+          export interface CustomChartMetricPercentile {
+            field:
+              | 'latency_seconds'
+              | 'first_token_seconds'
+              | 'total_tokens'
+              | 'prompt_tokens'
+              | 'completion_tokens'
+              | 'prompt_token_details.cache_creation'
+              | 'prompt_token_details.cache_read'
+              | 'prompt_token_details.ephemeral_1h_input_tokens'
+              | 'prompt_token_details.ephemeral_5m_input_tokens'
+              | 'prompt_token_details.audio'
+              | 'prompt_token_details.image'
+              | 'prompt_token_details.video'
+              | 'completion_token_details.reasoning'
+              | 'completion_token_details.audio'
+              | 'completion_token_details.image'
+              | 'completion_token_details.video'
+              | 'total_cost'
+              | 'prompt_cost'
+              | 'completion_cost'
+              | 'feedback_score';
+
+            params: CustomChartMetricPercentile.Params;
+
+            type: 'percentile';
+
+            filter?: string | null;
+          }
+
+          export namespace CustomChartMetricPercentile {
+            export interface Params {
+              p: number;
+            }
+          }
+
+          export interface CustomChartFeedbackCountMetric {
+            entity: 'feedback';
+
+            params: CustomChartFeedbackCountMetric.Params;
+
+            filter?: string | null;
+
+            type?: 'count';
+          }
+
+          export namespace CustomChartFeedbackCountMetric {
+            export interface Params {
+              feedback_key: string;
+            }
+          }
+
+          export interface CustomChartMetricCount {
+            filter?: string | null;
+
+            type?: 'count';
+          }
+
+          export interface CustomChartFeedbackScoreMetricScalar {
+            field: 'feedback_score';
+
+            params: CustomChartFeedbackScoreMetricScalar.Params;
+
+            type: 'sum' | 'max' | 'min' | 'avg';
+
+            filter?: string | null;
+          }
+
+          export namespace CustomChartFeedbackScoreMetricScalar {
+            export interface Params {
+              feedback_key: string;
+            }
+          }
+
+          export interface CustomChartMetricScalar {
+            field:
+              | 'latency_seconds'
+              | 'first_token_seconds'
+              | 'total_tokens'
+              | 'prompt_tokens'
+              | 'completion_tokens'
+              | 'prompt_token_details.cache_creation'
+              | 'prompt_token_details.cache_read'
+              | 'prompt_token_details.ephemeral_1h_input_tokens'
+              | 'prompt_token_details.ephemeral_5m_input_tokens'
+              | 'prompt_token_details.audio'
+              | 'prompt_token_details.image'
+              | 'prompt_token_details.video'
+              | 'completion_token_details.reasoning'
+              | 'completion_token_details.audio'
+              | 'completion_token_details.image'
+              | 'completion_token_details.video'
+              | 'total_cost'
+              | 'prompt_cost'
+              | 'completion_cost'
+              | 'feedback_score';
+
+            type: 'sum' | 'max' | 'min' | 'avg';
+
+            filter?: string | null;
+          }
+
+          export interface CustomChartFeedbackScoreMetricPercentile {
+            field: 'feedback_score';
+
+            params: CustomChartFeedbackScoreMetricPercentile.Params;
+
+            type: 'percentile';
+
+            filter?: string | null;
+          }
+
+          export namespace CustomChartFeedbackScoreMetricPercentile {
+            export interface Params {
+              feedback_key: string;
+
+              p: number;
+            }
+          }
+
+          export interface CustomChartMetricPercentile {
+            field:
+              | 'latency_seconds'
+              | 'first_token_seconds'
+              | 'total_tokens'
+              | 'prompt_tokens'
+              | 'completion_tokens'
+              | 'prompt_token_details.cache_creation'
+              | 'prompt_token_details.cache_read'
+              | 'prompt_token_details.ephemeral_1h_input_tokens'
+              | 'prompt_token_details.ephemeral_5m_input_tokens'
+              | 'prompt_token_details.audio'
+              | 'prompt_token_details.image'
+              | 'prompt_token_details.video'
+              | 'completion_token_details.reasoning'
+              | 'completion_token_details.audio'
+              | 'completion_token_details.image'
+              | 'completion_token_details.video'
+              | 'total_cost'
+              | 'prompt_cost'
+              | 'completion_cost'
+              | 'feedback_score';
+
+            params: CustomChartMetricPercentile.Params;
+
+            type: 'percentile';
+
+            filter?: string | null;
+          }
+
+          export namespace CustomChartMetricPercentile {
+            export interface Params {
+              p: number;
+            }
+          }
+        }
+      }
+
+      export interface CommonFilters {
+        filter?: string | null;
+
+        session?: Array<string> | null;
+
+        trace_filter?: string | null;
+
+        tree_filter?: string | null;
+      }
+    }
+  }
+}
+
+export interface CustomChartsSectionRequest {
+  end_time?: string | null;
+
+  /**
+   * Group by param for run stats.
+   */
+  group_by?: RunStatsGroupBy | null;
+
+  omit_data?: boolean;
+
+  start_time?: string | null;
+
+  /**
+   * Timedelta input.
+   */
+  stride?: TimedeltaInput;
+
+  timezone?: string;
+}
+
+/**
+ * Group by param for run stats.
+ */
+export interface RunStatsGroupBy {
+  attribute: 'name' | 'run_type' | 'tag' | 'metadata';
+
+  max_groups?: number;
+
+  path?: string | null;
+}
+
+export type SessionSortableColumns =
+  | 'name'
+  | 'start_time'
+  | 'last_run_start_time'
+  | 'latency_p50'
+  | 'latency_p99'
+  | 'error_rate'
+  | 'feedback';
+
+/**
+ * Timedelta input.
+ */
+export interface TimedeltaInput {
+  days?: number;
+
+  hours?: number;
+
+  minutes?: number;
+}
+
+/**
+ * TracerSession schema.
+ */
+export interface TracerSession {
+  id: string;
+
+  tenant_id: string;
+
+  completion_cost?: string | null;
+
+  completion_tokens?: number | null;
+
+  default_dataset_id?: string | null;
+
+  description?: string | null;
+
+  end_time?: string | null;
+
+  error_rate?: number | null;
+
+  experiment_progress?: TracerSession.ExperimentProgress | null;
+
+  extra?: { [key: string]: unknown } | null;
+
+  feedback_stats?: { [key: string]: unknown } | null;
+
+  first_token_p50?: number | null;
+
+  first_token_p99?: number | null;
+
+  last_run_start_time?: string | null;
+
+  last_run_start_time_live?: string | null;
+
+  latency_p50?: number | null;
+
+  latency_p99?: number | null;
+
+  name?: string;
+
+  prompt_cost?: string | null;
+
+  prompt_tokens?: number | null;
+
+  reference_dataset_id?: string | null;
+
+  run_count?: number | null;
+
+  run_facets?: Array<{ [key: string]: unknown }> | null;
+
+  session_feedback_stats?: { [key: string]: unknown } | null;
+
+  start_time?: string;
+
+  streaming_rate?: number | null;
+
+  test_run_number?: number | null;
+
+  total_cost?: string | null;
+
+  total_tokens?: number | null;
+
+  trace_tier?: 'longlived' | 'shortlived' | null;
+}
+
+export namespace TracerSession {
+  export interface ExperimentProgress {
+    evaluator_progress: { [key: string]: number };
+
+    expected_run_count: number;
+
+    run_progress: number;
+  }
+}
+
+/**
+ * TracerSession schema.
+ */
+export interface TracerSessionWithoutVirtualFields {
+  id: string;
+
+  tenant_id: string;
+
+  default_dataset_id?: string | null;
+
+  description?: string | null;
+
+  end_time?: string | null;
+
+  extra?: { [key: string]: unknown } | null;
+
+  last_run_start_time_live?: string | null;
+
+  name?: string;
+
+  reference_dataset_id?: string | null;
+
+  start_time?: string;
+
+  trace_tier?: 'longlived' | 'shortlived' | null;
+}
+
+export interface SessionResolveResponse {
+  /**
+   * `session_id` is the tracing project (session) the address names.
+   */
+  session_id: string;
+}
+
+export interface SessionResolveParams {
+  /**
+   * The kind of address.
+   */
+  kind: 'AGENT' | 'EXPERIMENT' | 'EVALUATOR';
+
+  /**
+   * The Agent's user-assigned id for AGENT, or the experiment's id for EXPERIMENT.
+   * Not set for EVALUATOR.
+   */
+  id?: string;
+
+  /**
+   * The Agent environment. Only set for AGENT.
+   */
+  environment?: 'LOCAL' | 'DEVELOPMENT' | 'STAGING' | 'PRODUCTION';
+}
+
+export declare namespace Sessions {
+  export {
+    type CustomChartsSection as CustomChartsSection,
+    type CustomChartsSectionRequest as CustomChartsSectionRequest,
+    type RunStatsGroupBy as RunStatsGroupBy,
+    type SessionSortableColumns as SessionSortableColumns,
+    type TimedeltaInput as TimedeltaInput,
+    type TracerSession as TracerSession,
+    type TracerSessionWithoutVirtualFields as TracerSessionWithoutVirtualFields,
+    type SessionResolveResponse as SessionResolveResponse,
+    type SessionResolveParams as SessionResolveParams,
+  };
+}