langsmith 0.7.16 → 0.8.0

package/dist/_openapi_client/client.cjs

@@ -66,7 +66,8 @@ const info_js_1 = require("./resources/info.cjs");
 const issues_js_1 = require("./resources/issues.cjs");
 const online_evaluators_js_1 = require("./resources/online-evaluators.cjs");
 const runs_js_1 = require("./resources/runs.cjs");
-const sessions_js_1 = require("./resources/sessions.cjs");
+const threads_js_1 = require("./resources/threads.cjs");
+const traces_js_1 = require("./resources/traces.cjs");
 const datasets_js_1 = require("./resources/datasets/datasets.cjs");
 const sandboxes_js_1 = require("./resources/sandboxes/sandboxes.cjs");
 const headers_js_1 = require("./internal/headers.cjs");
@@ -159,12 +160,6 @@ class Langsmith {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "sessions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new API.Sessions(this)
-        });
         Object.defineProperty(this, "datasets", {
             enumerable: true,
             configurable: true,
@@ -177,6 +172,18 @@ class Langsmith {
             writable: true,
             value: new API.Runs(this)
         });
+        Object.defineProperty(this, "threads", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new API.Threads(this)
+        });
+        Object.defineProperty(this, "traces", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new API.Traces(this)
+        });
         Object.defineProperty(this, "onlineEvaluators", {
             enumerable: true,
             configurable: true,
@@ -741,9 +748,10 @@ Object.defineProperty(Langsmith, "toFile", {
     writable: true,
     value: Uploads.toFile
 });
-Langsmith.Sessions = sessions_js_1.Sessions;
 Langsmith.Datasets = datasets_js_1.Datasets;
 Langsmith.Runs = runs_js_1.Runs;
+Langsmith.Threads = threads_js_1.Threads;
+Langsmith.Traces = traces_js_1.Traces;
 Langsmith.OnlineEvaluators = online_evaluators_js_1.OnlineEvaluators;
 Langsmith.Info = info_js_1.Info;
 Langsmith.Issues = issues_js_1.Issues;

package/dist/_openapi_client/client.d.ts

@@ -12,7 +12,8 @@ import { Info, InfoListResponse } from './resources/info.js';
 import { Issue, IssueListParams, Issues, IssuesOffsetPaginationIssues } from './resources/issues.js';
 import { BulkDeleteEvaluatorFailedItem, BulkDeleteEvaluatorsResponse, CreateOnlineCodeEvaluatorRequest, CreateOnlineEvaluatorRequest, CreateOnlineEvaluatorResponse, CreateOnlineLlmEvaluatorRequest, GetOnlineEvaluatorSpendResponse, OnlineCodeEvaluator, OnlineEvaluator, OnlineEvaluatorBulkDeleteParams, OnlineEvaluatorCreateParams, OnlineEvaluatorDeleteParams, OnlineEvaluatorListParams, OnlineEvaluatorRunRule, OnlineEvaluatorSpendDay, OnlineEvaluatorSpendGroup, OnlineEvaluatorSpendParams, OnlineEvaluatorType, OnlineEvaluatorUpdateParams, OnlineEvaluators, OnlineEvaluatorsOffsetPaginationOnlineEvaluators, OnlineLlmEvaluator, OnlineSpendLimit, UpdateOnlineCodeEvaluatorRequest, UpdateOnlineEvaluatorRequest, UpdateOnlineEvaluatorResponse, UpdateOnlineLlmEvaluatorRequest } from './resources/online-evaluators.js';
 import { ResponseBodyForRunsGenerateQuery, Run, RunIngest, RunQueryParams, RunQueryV2Params, RunRetrieveParams, RunRetrieveV2Params, RunSchema, RunStatsQueryParams, RunTypeEnum, Runs, RunsFilterDataSourceTypeEnum, RunsItemsCursorPostPagination } from './resources/runs.js';
-import { CustomChartsSection, CustomChartsSectionRequest, RunStatsGroupBy, SessionCreateParams, SessionDeleteResponse, SessionListParams, SessionRetrieveParams, SessionSortableColumns, SessionUpdateParams, Sessions, TimedeltaInput, TracerSession, TracerSessionWithoutVirtualFields, TracerSessionsOffsetPaginationTopLevelArray } from './resources/sessions.js';
+import { ThreadListItem, ThreadListItemsItemsCursorPostPagination, ThreadListTracesParams, ThreadQueryParams, ThreadStatsParams, ThreadStatsResponse, ThreadTraceListItem, ThreadTraceListItemsItemsCursorGetPagination, Threads } from './resources/threads.js';
+import { Trace, TraceAggregates, TraceListRunsParams, TraceListRunsResponse, TraceQueryParams, Traces, TracesItemsCursorPostPagination } from './resources/traces.js';
 import { DataType, Dataset, DatasetTransformation, DatasetVersion, Datasets, FeedbackCreateCoreSchema, Missing, SortByDatasetColumn } from './resources/datasets/datasets.js';
 import { SandboxListResponse, SandboxResponse, SandboxStatusResponse, Sandboxes, ServiceURLResponse, SnapshotListResponse, SnapshotResponse } from './resources/sandboxes/sandboxes.js';
 import { type Fetch } from './internal/builtin-types.js';
@@ -187,9 +188,10 @@ export declare class Langsmith {
     static PermissionDeniedError: typeof Errors.PermissionDeniedError;
     static UnprocessableEntityError: typeof Errors.UnprocessableEntityError;
     static toFile: typeof Uploads.toFile;
-    sessions: API.Sessions;
     datasets: API.Datasets;
     runs: API.Runs;
+    threads: API.Threads;
+    traces: API.Traces;
     onlineEvaluators: API.OnlineEvaluators;
     info: API.Info;
     issues: API.Issues;
@@ -215,9 +217,10 @@ export declare namespace Langsmith {
     export { type ItemsCursorPostPaginationParams as ItemsCursorPostPaginationParams, type ItemsCursorPostPaginationResponse as ItemsCursorPostPaginationResponse, };
     export import ItemsCursorGetPagination = Pagination.ItemsCursorGetPagination;
     export { type ItemsCursorGetPaginationParams as ItemsCursorGetPaginationParams, type ItemsCursorGetPaginationResponse as ItemsCursorGetPaginationResponse, };
-    export { Sessions as Sessions, 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 SessionDeleteResponse as SessionDeleteResponse, type TracerSessionsOffsetPaginationTopLevelArray as TracerSessionsOffsetPaginationTopLevelArray, type SessionCreateParams as SessionCreateParams, type SessionRetrieveParams as SessionRetrieveParams, type SessionUpdateParams as SessionUpdateParams, type SessionListParams as SessionListParams, };
     export { Datasets as Datasets, type DataType as DataType, type Dataset as Dataset, type DatasetTransformation as DatasetTransformation, type DatasetVersion as DatasetVersion, type FeedbackCreateCoreSchema as FeedbackCreateCoreSchema, type Missing as Missing, type SortByDatasetColumn as SortByDatasetColumn, };
     export { Runs as Runs, type ResponseBodyForRunsGenerateQuery as ResponseBodyForRunsGenerateQuery, type Run as Run, type RunIngest as RunIngest, type RunSchema as RunSchema, type RunStatsQueryParams as RunStatsQueryParams, type RunTypeEnum as RunTypeEnum, type RunsFilterDataSourceTypeEnum as RunsFilterDataSourceTypeEnum, type RunsItemsCursorPostPagination as RunsItemsCursorPostPagination, type RunQueryV2Params as RunQueryV2Params, type RunRetrieveV2Params as RunRetrieveV2Params, type RunRetrieveParams as RunRetrieveParams, type RunQueryParams as RunQueryParams, };
+    export { Threads as Threads, type ThreadListItem as ThreadListItem, type ThreadTraceListItem as ThreadTraceListItem, type ThreadStatsResponse as ThreadStatsResponse, type ThreadTraceListItemsItemsCursorGetPagination as ThreadTraceListItemsItemsCursorGetPagination, type ThreadListItemsItemsCursorPostPagination as ThreadListItemsItemsCursorPostPagination, type ThreadListTracesParams as ThreadListTracesParams, type ThreadQueryParams as ThreadQueryParams, type ThreadStatsParams as ThreadStatsParams, };
+    export { Traces as Traces, type Trace as Trace, type TraceAggregates as TraceAggregates, type TraceListRunsResponse as TraceListRunsResponse, type TracesItemsCursorPostPagination as TracesItemsCursorPostPagination, type TraceListRunsParams as TraceListRunsParams, type TraceQueryParams as TraceQueryParams, };
     export { OnlineEvaluators as OnlineEvaluators, type BulkDeleteEvaluatorFailedItem as BulkDeleteEvaluatorFailedItem, type BulkDeleteEvaluatorsResponse as BulkDeleteEvaluatorsResponse, type CreateOnlineCodeEvaluatorRequest as CreateOnlineCodeEvaluatorRequest, type CreateOnlineEvaluatorRequest as CreateOnlineEvaluatorRequest, type CreateOnlineEvaluatorResponse as CreateOnlineEvaluatorResponse, type CreateOnlineLlmEvaluatorRequest as CreateOnlineLlmEvaluatorRequest, type GetOnlineEvaluatorSpendResponse as GetOnlineEvaluatorSpendResponse, type OnlineCodeEvaluator as OnlineCodeEvaluator, type OnlineEvaluator as OnlineEvaluator, type OnlineEvaluatorRunRule as OnlineEvaluatorRunRule, type OnlineEvaluatorSpendDay as OnlineEvaluatorSpendDay, type OnlineEvaluatorSpendGroup as OnlineEvaluatorSpendGroup, type OnlineEvaluatorType as OnlineEvaluatorType, type OnlineLlmEvaluator as OnlineLlmEvaluator, type OnlineSpendLimit as OnlineSpendLimit, type UpdateOnlineCodeEvaluatorRequest as UpdateOnlineCodeEvaluatorRequest, type UpdateOnlineEvaluatorRequest as UpdateOnlineEvaluatorRequest, type UpdateOnlineEvaluatorResponse as UpdateOnlineEvaluatorResponse, type UpdateOnlineLlmEvaluatorRequest as UpdateOnlineLlmEvaluatorRequest, type OnlineEvaluatorsOffsetPaginationOnlineEvaluators as OnlineEvaluatorsOffsetPaginationOnlineEvaluators, type OnlineEvaluatorCreateParams as OnlineEvaluatorCreateParams, type OnlineEvaluatorUpdateParams as OnlineEvaluatorUpdateParams, type OnlineEvaluatorListParams as OnlineEvaluatorListParams, type OnlineEvaluatorDeleteParams as OnlineEvaluatorDeleteParams, type OnlineEvaluatorBulkDeleteParams as OnlineEvaluatorBulkDeleteParams, type OnlineEvaluatorSpendParams as OnlineEvaluatorSpendParams, };
     export { Info as Info, type InfoListResponse as InfoListResponse };
     export { Issues as Issues, type Issue as Issue, type IssuesOffsetPaginationIssues as IssuesOffsetPaginationIssues, type IssueListParams as IssueListParams, };

package/dist/_openapi_client/client.js

@@ -30,7 +30,8 @@ import { Info } from './resources/info.js';
 import { Issues } from './resources/issues.js';
 import { OnlineEvaluators, } from './resources/online-evaluators.js';
 import { Runs, } from './resources/runs.js';
-import { Sessions, } from './resources/sessions.js';
+import { Threads, } from './resources/threads.js';
+import { Traces, } from './resources/traces.js';
 import { Datasets, } from './resources/datasets/datasets.js';
 import { Sandboxes, } from './resources/sandboxes/sandboxes.js';
 import { buildHeaders } from './internal/headers.js';
@@ -123,12 +124,6 @@ export class Langsmith {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "sessions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new API.Sessions(this)
-        });
         Object.defineProperty(this, "datasets", {
             enumerable: true,
             configurable: true,
@@ -141,6 +136,18 @@ export class Langsmith {
             writable: true,
             value: new API.Runs(this)
         });
+        Object.defineProperty(this, "threads", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new API.Threads(this)
+        });
+        Object.defineProperty(this, "traces", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new API.Traces(this)
+        });
         Object.defineProperty(this, "onlineEvaluators", {
             enumerable: true,
             configurable: true,
@@ -704,9 +711,10 @@ Object.defineProperty(Langsmith, "toFile", {
     writable: true,
     value: Uploads.toFile
 });
-Langsmith.Sessions = Sessions;
 Langsmith.Datasets = Datasets;
 Langsmith.Runs = Runs;
+Langsmith.Threads = Threads;
+Langsmith.Traces = Traces;
 Langsmith.OnlineEvaluators = OnlineEvaluators;
 Langsmith.Info = Info;
 Langsmith.Issues = Issues;

package/dist/_openapi_client/resources/index.cjs

@@ -2,7 +2,7 @@
 // @ts-nocheck
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sessions = exports.Sandboxes = exports.Runs = exports.OnlineEvaluators = exports.Issues = exports.Info = exports.Datasets = void 0;
+exports.Traces = exports.Threads = exports.Sandboxes = exports.Runs = exports.OnlineEvaluators = exports.Issues = exports.Info = exports.Datasets = void 0;
 var datasets_js_1 = require("./datasets/datasets.cjs");
 Object.defineProperty(exports, "Datasets", { enumerable: true, get: function () { return datasets_js_1.Datasets; } });
 var info_js_1 = require("./info.cjs");
@@ -15,5 +15,7 @@ var runs_js_1 = require("./runs.cjs");
 Object.defineProperty(exports, "Runs", { enumerable: true, get: function () { return runs_js_1.Runs; } });
 var sandboxes_js_1 = require("./sandboxes/sandboxes.cjs");
 Object.defineProperty(exports, "Sandboxes", { enumerable: true, get: function () { return sandboxes_js_1.Sandboxes; } });
-var sessions_js_1 = require("./sessions.cjs");
-Object.defineProperty(exports, "Sessions", { enumerable: true, get: function () { return sessions_js_1.Sessions; } });
+var threads_js_1 = require("./threads.cjs");
+Object.defineProperty(exports, "Threads", { enumerable: true, get: function () { return threads_js_1.Threads; } });
+var traces_js_1 = require("./traces.cjs");
+Object.defineProperty(exports, "Traces", { enumerable: true, get: function () { return traces_js_1.Traces; } });

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

@@ -4,4 +4,5 @@ export { Issues, type Issue, type IssueListParams, type IssuesOffsetPaginationIs
 export { OnlineEvaluators, type BulkDeleteEvaluatorFailedItem, type BulkDeleteEvaluatorsResponse, type CreateOnlineCodeEvaluatorRequest, type CreateOnlineEvaluatorRequest, type CreateOnlineEvaluatorResponse, type CreateOnlineLlmEvaluatorRequest, type GetOnlineEvaluatorSpendResponse, type OnlineCodeEvaluator, type OnlineEvaluator, type OnlineEvaluatorRunRule, type OnlineEvaluatorSpendDay, type OnlineEvaluatorSpendGroup, type OnlineEvaluatorType, type OnlineLlmEvaluator, type OnlineSpendLimit, type UpdateOnlineCodeEvaluatorRequest, type UpdateOnlineEvaluatorRequest, type UpdateOnlineEvaluatorResponse, type UpdateOnlineLlmEvaluatorRequest, type OnlineEvaluatorCreateParams, type OnlineEvaluatorUpdateParams, type OnlineEvaluatorListParams, type OnlineEvaluatorDeleteParams, type OnlineEvaluatorBulkDeleteParams, type OnlineEvaluatorSpendParams, type OnlineEvaluatorsOffsetPaginationOnlineEvaluators, } from './online-evaluators.js';
 export { Runs, type ResponseBodyForRunsGenerateQuery, type Run, type RunIngest, type RunSchema, type RunStatsQueryParams, type RunTypeEnum, type RunsFilterDataSourceTypeEnum, type RunQueryV2Params, type RunRetrieveV2Params, type RunRetrieveParams, type RunQueryParams, type RunsItemsCursorPostPagination, } from './runs.js';
 export { Sandboxes, type SandboxListResponse, type SandboxResponse, type SandboxStatusResponse, type ServiceURLResponse, type SnapshotListResponse, type SnapshotResponse, } from './sandboxes/sandboxes.js';
-export { Sessions, type CustomChartsSection, type CustomChartsSectionRequest, type RunStatsGroupBy, type SessionSortableColumns, type TimedeltaInput, type TracerSession, type TracerSessionWithoutVirtualFields, type SessionDeleteResponse, type SessionCreateParams, type SessionRetrieveParams, type SessionUpdateParams, type SessionListParams, type TracerSessionsOffsetPaginationTopLevelArray, } from './sessions.js';
+export { Threads, type ThreadListItem, type ThreadTraceListItem, type ThreadStatsResponse, type ThreadListTracesParams, type ThreadQueryParams, type ThreadStatsParams, type ThreadTraceListItemsItemsCursorGetPagination, type ThreadListItemsItemsCursorPostPagination, } from './threads.js';
+export { Traces, type Trace, type TraceAggregates, type TraceListRunsResponse, type TraceListRunsParams, type TraceQueryParams, type TracesItemsCursorPostPagination, } from './traces.js';

package/dist/_openapi_client/resources/index.js

@@ -6,4 +6,5 @@ export { Issues } from './issues.js';
 export { OnlineEvaluators, } from './online-evaluators.js';
 export { Runs, } from './runs.js';
 export { Sandboxes, } from './sandboxes/sandboxes.js';
-export { Sessions, } from './sessions.js';
+export { Threads, } from './threads.js';
+export { Traces, } from './traces.js';

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

@@ -1,5 +1,4 @@
 import { APIResource } from '../core/resource.js';
-import * as SessionsAPI from './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';
@@ -548,7 +547,7 @@ export interface RunStatsQueryParams {
     /**
      * Group by param for run stats.
      */
-    group_by?: SessionsAPI.RunStatsGroupBy | null;
+    group_by?: RunStatsQueryParams.GroupBy | null;
     groups?: Array<string | null> | null;
     include_details?: boolean;
     is_root?: boolean | null;
@@ -569,6 +568,16 @@ export interface RunStatsQueryParams {
     tree_filter?: string | null;
     use_experimental_search?: boolean;
 }
+export declare namespace RunStatsQueryParams {
+    /**
+     * Group by param for run stats.
+     */
+    interface GroupBy {
+        attribute: 'name' | 'run_type' | 'tag' | 'metadata';
+        max_groups?: number;
+        path?: string | null;
+    }
+}
 /**
  * Enum for run types.
  */

package/dist/_openapi_client/resources/threads.cjs

@@ -0,0 +1,65 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Threads = void 0;
+const resource_js_1 = require("../core/resource.cjs");
+const pagination_js_1 = require("../core/pagination.cjs");
+const path_js_1 = require("../internal/utils/path.cjs");
+class Threads extends resource_js_1.APIResource {
+    /**
+     * **Alpha:** The request and response contract may change; Retrieve all traces
+     * belonging to a specific thread within a project.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const threadTraceListItem of client.threads.listTraces(
+     *   'thread_id',
+     *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTraces(threadID, query, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/v2/threads/${threadID}/traces`, (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
+    }
+    /**
+     * **Alpha:** The request and response contract may change; Query threads within a
+     * project (session), with cursor-based pagination. Returns threads matching the
+     * given time range and optional filter.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const threadListItem of client.threads.query()) {
+     *   // ...
+     * }
+     * ```
+     */
+    query(body, options) {
+        return this._client.getAPIList('/v2/threads/query', (pagination_js_1.ItemsCursorPostPagination), {
+            body,
+            method: 'post',
+            ...options,
+        });
+    }
+    /**
+     * **Alpha:** The request and response contract may change; Compute aggregate stats
+     * for a single thread (turn count, latency percentiles, token/cost sums, and
+     * detail breakdowns) within a project.
+     *
+     * @example
+     * ```ts
+     * const response = await client.threads.stats('thread_id', {
+     *   selects: ['TURNS'],
+     *   session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * });
+     * ```
+     */
+    stats(threadID, query, options) {
+        return this._client.get((0, path_js_1.path) `/v2/threads/${threadID}/stats`, { query, ...options });
+    }
+}
+exports.Threads = Threads;