langsmith 0.8.0 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12,7 +12,7 @@ import { Info, InfoListResponse } from './resources/info.js';
12
12
  import { Issue, IssueListParams, Issues, IssuesOffsetPaginationIssues } from './resources/issues.js';
13
13
  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';
14
14
  import { ResponseBodyForRunsGenerateQuery, Run, RunIngest, RunQueryParams, RunQueryV2Params, RunRetrieveParams, RunRetrieveV2Params, RunSchema, RunStatsQueryParams, RunTypeEnum, Runs, RunsFilterDataSourceTypeEnum, RunsItemsCursorPostPagination } from './resources/runs.js';
15
- import { ThreadListItem, ThreadListItemsItemsCursorPostPagination, ThreadListTracesParams, ThreadQueryParams, ThreadStatsParams, ThreadStatsResponse, ThreadTraceListItem, ThreadTraceListItemsItemsCursorGetPagination, Threads } from './resources/threads.js';
15
+ import { Thread, ThreadListTracesParams, ThreadQueryParams, ThreadStats, ThreadStatsParams, ThreadTrace, ThreadTracesItemsCursorGetPagination, Threads, ThreadsItemsCursorPostPagination } from './resources/threads.js';
16
16
  import { Trace, TraceAggregates, TraceListRunsParams, TraceListRunsResponse, TraceQueryParams, Traces, TracesItemsCursorPostPagination } from './resources/traces.js';
17
17
  import { DataType, Dataset, DatasetTransformation, DatasetVersion, Datasets, FeedbackCreateCoreSchema, Missing, SortByDatasetColumn } from './resources/datasets/datasets.js';
18
18
  import { SandboxListResponse, SandboxResponse, SandboxStatusResponse, Sandboxes, ServiceURLResponse, SnapshotListResponse, SnapshotResponse } from './resources/sandboxes/sandboxes.js';
@@ -219,7 +219,7 @@ export declare namespace Langsmith {
219
219
  export { type ItemsCursorGetPaginationParams as ItemsCursorGetPaginationParams, type ItemsCursorGetPaginationResponse as ItemsCursorGetPaginationResponse, };
220
220
  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, };
221
221
  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, };
222
- 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, };
222
+ export { Threads as Threads, type Thread as Thread, type ThreadStats as ThreadStats, type ThreadTrace as ThreadTrace, type ThreadTracesItemsCursorGetPagination as ThreadTracesItemsCursorGetPagination, type ThreadsItemsCursorPostPagination as ThreadsItemsCursorPostPagination, type ThreadListTracesParams as ThreadListTracesParams, type ThreadQueryParams as ThreadQueryParams, type ThreadStatsParams as ThreadStatsParams, };
223
223
  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, };
224
224
  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, };
225
225
  export { Info as Info, type InfoListResponse as InfoListResponse };
@@ -4,5 +4,5 @@ export { Issues, type Issue, type IssueListParams, type IssuesOffsetPaginationIs
4
4
  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';
5
5
  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';
6
6
  export { Sandboxes, type SandboxListResponse, type SandboxResponse, type SandboxStatusResponse, type ServiceURLResponse, type SnapshotListResponse, type SnapshotResponse, } from './sandboxes/sandboxes.js';
7
- export { Threads, type ThreadListItem, type ThreadTraceListItem, type ThreadStatsResponse, type ThreadListTracesParams, type ThreadQueryParams, type ThreadStatsParams, type ThreadTraceListItemsItemsCursorGetPagination, type ThreadListItemsItemsCursorPostPagination, } from './threads.js';
7
+ export { Threads, type Thread, type ThreadStats, type ThreadTrace, type ThreadListTracesParams, type ThreadQueryParams, type ThreadStatsParams, type ThreadTracesItemsCursorGetPagination, type ThreadsItemsCursorPostPagination, } from './threads.js';
8
8
  export { Traces, type Trace, type TraceAggregates, type TraceListRunsResponse, type TraceListRunsParams, type TraceQueryParams, type TracesItemsCursorPostPagination, } from './traces.js';
@@ -88,6 +88,11 @@ export interface OnlineEvaluator {
88
88
  created_at?: string;
89
89
  created_by?: string;
90
90
  feedback_keys?: Array<string>;
91
+ /**
92
+ * IsManaged marks a LangChain-managed evaluator (currently the managed Perceived
93
+ * Error judge). NULL in the DB is read as false via COALESCE.
94
+ */
95
+ is_managed?: boolean;
91
96
  /**
92
97
  * Embedded child evaluator (populated based on type)
93
98
  */
@@ -563,6 +563,10 @@ export interface RunStatsQueryParams {
563
563
  session?: Array<string> | null;
564
564
  skip_pagination?: boolean | null;
565
565
  start_time?: string | null;
566
+ /**
567
+ * Filter runs by trace ID. When set, limit and cursor-based pagination are not
568
+ * applied — all runs in the trace are returned in a single response.
569
+ */
566
570
  trace?: string | null;
567
571
  trace_filter?: string | null;
568
572
  tree_filter?: string | null;
@@ -9,8 +9,7 @@ const path_js_1 = require("../../internal/utils/path.cjs");
9
9
  class Boxes extends resource_js_1.APIResource {
10
10
  /**
11
11
  * Create a new sandbox from a snapshot. Provide at most one of `snapshot_id` or
12
- * `snapshot_name`; if neither is provided, the server uses the default static
13
- * blueprint.
12
+ * `snapshot_name`; if neither is provided, the server uses the default snapshot.
14
13
  */
15
14
  create(body, options) {
16
15
  return this._client.post('/v2/sandboxes/boxes', { body, ...options });
@@ -5,8 +5,7 @@ import { RequestOptions } from '../../internal/request-options.js';
5
5
  export declare class Boxes extends APIResource {
6
6
  /**
7
7
  * Create a new sandbox from a snapshot. Provide at most one of `snapshot_id` or
8
- * `snapshot_name`; if neither is provided, the server uses the default static
9
- * blueprint.
8
+ * `snapshot_name`; if neither is provided, the server uses the default snapshot.
10
9
  */
11
10
  create(body: BoxCreateParams, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
12
11
  /**
@@ -88,7 +87,7 @@ export interface BoxCreateParams {
88
87
  export declare namespace BoxCreateParams {
89
88
  interface MountConfig {
90
89
  auth?: MountConfig.Auth;
91
- mounts?: Array<MountConfig.SandboxapiS3BucketMountSpec | MountConfig.SandboxapiGcsBucketMountSpec | MountConfig.SandboxapiGitRepoMountSpec>;
90
+ mounts?: Array<MountConfig.SandboxapiS3BucketMountSpec | MountConfig.SandboxapiGcsBucketMountSpec | MountConfig.SandboxapiGitRepoMountSpec | MountConfig.SandboxapiContextHubRepoMountSpec>;
92
91
  }
93
92
  namespace MountConfig {
94
93
  interface Auth {
@@ -127,8 +126,9 @@ export declare namespace BoxCreateParams {
127
126
  id: string;
128
127
  mount_path: string;
129
128
  s3: SandboxapiS3BucketMountSpec.S3;
130
- type: 's3' | 'gcs' | 'git';
129
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
131
130
  cache?: SandboxapiS3BucketMountSpec.Cache;
131
+ contexthub?: SandboxapiS3BucketMountSpec.Contexthub;
132
132
  gcs?: SandboxapiS3BucketMountSpec.Gcs;
133
133
  git?: SandboxapiS3BucketMountSpec.Git;
134
134
  read_only?: boolean;
@@ -145,6 +145,19 @@ export declare namespace BoxCreateParams {
145
145
  max_size_bytes?: number;
146
146
  writeback_seconds?: number;
147
147
  }
148
+ interface Contexthub {
149
+ /**
150
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
151
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
152
+ * into the mount path.
153
+ */
154
+ repo: string;
155
+ /**
156
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
157
+ * for the sandbox's lifetime.
158
+ */
159
+ initial_pull_only?: boolean;
160
+ }
148
161
  interface Gcs {
149
162
  bucket: string;
150
163
  prefix?: string;
@@ -165,8 +178,9 @@ export declare namespace BoxCreateParams {
165
178
  id: string;
166
179
  gcs: SandboxapiGcsBucketMountSpec.Gcs;
167
180
  mount_path: string;
168
- type: 's3' | 'gcs' | 'git';
181
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
169
182
  cache?: SandboxapiGcsBucketMountSpec.Cache;
183
+ contexthub?: SandboxapiGcsBucketMountSpec.Contexthub;
170
184
  git?: SandboxapiGcsBucketMountSpec.Git;
171
185
  read_only?: boolean;
172
186
  s3?: SandboxapiGcsBucketMountSpec.S3;
@@ -180,6 +194,19 @@ export declare namespace BoxCreateParams {
180
194
  max_size_bytes?: number;
181
195
  writeback_seconds?: number;
182
196
  }
197
+ interface Contexthub {
198
+ /**
199
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
200
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
201
+ * into the mount path.
202
+ */
203
+ repo: string;
204
+ /**
205
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
206
+ * for the sandbox's lifetime.
207
+ */
208
+ initial_pull_only?: boolean;
209
+ }
183
210
  interface Git {
184
211
  remote_url: string;
185
212
  ref?: Git.Ref;
@@ -203,8 +230,9 @@ export declare namespace BoxCreateParams {
203
230
  id: string;
204
231
  git: SandboxapiGitRepoMountSpec.Git;
205
232
  mount_path: string;
206
- type: 's3' | 'gcs' | 'git';
233
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
207
234
  cache?: SandboxapiGitRepoMountSpec.Cache;
235
+ contexthub?: SandboxapiGitRepoMountSpec.Contexthub;
208
236
  gcs?: SandboxapiGitRepoMountSpec.Gcs;
209
237
  read_only?: boolean;
210
238
  s3?: SandboxapiGitRepoMountSpec.S3;
@@ -225,6 +253,19 @@ export declare namespace BoxCreateParams {
225
253
  max_size_bytes?: number;
226
254
  writeback_seconds?: number;
227
255
  }
256
+ interface Contexthub {
257
+ /**
258
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
259
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
260
+ * into the mount path.
261
+ */
262
+ repo: string;
263
+ /**
264
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
265
+ * for the sandbox's lifetime.
266
+ */
267
+ initial_pull_only?: boolean;
268
+ }
228
269
  interface Gcs {
229
270
  bucket: string;
230
271
  prefix?: string;
@@ -237,6 +278,58 @@ export declare namespace BoxCreateParams {
237
278
  prefix?: string;
238
279
  }
239
280
  }
281
+ interface SandboxapiContextHubRepoMountSpec {
282
+ id: string;
283
+ contexthub: SandboxapiContextHubRepoMountSpec.Contexthub;
284
+ mount_path: string;
285
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
286
+ cache?: SandboxapiContextHubRepoMountSpec.Cache;
287
+ gcs?: SandboxapiContextHubRepoMountSpec.Gcs;
288
+ git?: SandboxapiContextHubRepoMountSpec.Git;
289
+ read_only?: boolean;
290
+ s3?: SandboxapiContextHubRepoMountSpec.S3;
291
+ }
292
+ namespace SandboxapiContextHubRepoMountSpec {
293
+ interface Contexthub {
294
+ /**
295
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
296
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
297
+ * into the mount path.
298
+ */
299
+ repo: string;
300
+ /**
301
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
302
+ * for the sandbox's lifetime.
303
+ */
304
+ initial_pull_only?: boolean;
305
+ }
306
+ interface Cache {
307
+ max_size_bytes?: number;
308
+ writeback_seconds?: number;
309
+ }
310
+ interface Gcs {
311
+ bucket: string;
312
+ prefix?: string;
313
+ }
314
+ interface Git {
315
+ remote_url: string;
316
+ ref?: Git.Ref;
317
+ refresh_interval_seconds?: number;
318
+ }
319
+ namespace Git {
320
+ interface Ref {
321
+ name: string;
322
+ type: 'branch' | 'tag';
323
+ }
324
+ }
325
+ interface S3 {
326
+ bucket: string;
327
+ region: string;
328
+ endpoint_url?: string;
329
+ path_style?: boolean;
330
+ prefix?: string;
331
+ }
332
+ }
240
333
  }
241
334
  interface ProxyConfig {
242
335
  access_control?: ProxyConfig.AccessControl;
@@ -6,8 +6,7 @@ import { path } from '../../internal/utils/path.js';
6
6
  export class Boxes extends APIResource {
7
7
  /**
8
8
  * Create a new sandbox from a snapshot. Provide at most one of `snapshot_id` or
9
- * `snapshot_name`; if neither is provided, the server uses the default static
10
- * blueprint.
9
+ * `snapshot_name`; if neither is provided, the server uses the default snapshot.
11
10
  */
12
11
  create(body, options) {
13
12
  return this._client.post('/v2/sandboxes/boxes', { body, ...options });
@@ -39,7 +39,7 @@ export interface SandboxResponse {
39
39
  export declare namespace SandboxResponse {
40
40
  interface MountConfig {
41
41
  auth?: MountConfig.Auth;
42
- mounts?: Array<MountConfig.SandboxapiS3BucketMountSpec | MountConfig.SandboxapiGcsBucketMountSpec | MountConfig.SandboxapiGitRepoMountSpec>;
42
+ mounts?: Array<MountConfig.SandboxapiS3BucketMountSpec | MountConfig.SandboxapiGcsBucketMountSpec | MountConfig.SandboxapiGitRepoMountSpec | MountConfig.SandboxapiContextHubRepoMountSpec>;
43
43
  }
44
44
  namespace MountConfig {
45
45
  interface Auth {
@@ -78,8 +78,9 @@ export declare namespace SandboxResponse {
78
78
  id: string;
79
79
  mount_path: string;
80
80
  s3: SandboxapiS3BucketMountSpec.S3;
81
- type: 's3' | 'gcs' | 'git';
81
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
82
82
  cache?: SandboxapiS3BucketMountSpec.Cache;
83
+ contexthub?: SandboxapiS3BucketMountSpec.Contexthub;
83
84
  gcs?: SandboxapiS3BucketMountSpec.Gcs;
84
85
  git?: SandboxapiS3BucketMountSpec.Git;
85
86
  read_only?: boolean;
@@ -96,6 +97,19 @@ export declare namespace SandboxResponse {
96
97
  max_size_bytes?: number;
97
98
  writeback_seconds?: number;
98
99
  }
100
+ interface Contexthub {
101
+ /**
102
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
103
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
104
+ * into the mount path.
105
+ */
106
+ repo: string;
107
+ /**
108
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
109
+ * for the sandbox's lifetime.
110
+ */
111
+ initial_pull_only?: boolean;
112
+ }
99
113
  interface Gcs {
100
114
  bucket: string;
101
115
  prefix?: string;
@@ -116,8 +130,9 @@ export declare namespace SandboxResponse {
116
130
  id: string;
117
131
  gcs: SandboxapiGcsBucketMountSpec.Gcs;
118
132
  mount_path: string;
119
- type: 's3' | 'gcs' | 'git';
133
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
120
134
  cache?: SandboxapiGcsBucketMountSpec.Cache;
135
+ contexthub?: SandboxapiGcsBucketMountSpec.Contexthub;
121
136
  git?: SandboxapiGcsBucketMountSpec.Git;
122
137
  read_only?: boolean;
123
138
  s3?: SandboxapiGcsBucketMountSpec.S3;
@@ -131,6 +146,19 @@ export declare namespace SandboxResponse {
131
146
  max_size_bytes?: number;
132
147
  writeback_seconds?: number;
133
148
  }
149
+ interface Contexthub {
150
+ /**
151
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
152
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
153
+ * into the mount path.
154
+ */
155
+ repo: string;
156
+ /**
157
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
158
+ * for the sandbox's lifetime.
159
+ */
160
+ initial_pull_only?: boolean;
161
+ }
134
162
  interface Git {
135
163
  remote_url: string;
136
164
  ref?: Git.Ref;
@@ -154,8 +182,9 @@ export declare namespace SandboxResponse {
154
182
  id: string;
155
183
  git: SandboxapiGitRepoMountSpec.Git;
156
184
  mount_path: string;
157
- type: 's3' | 'gcs' | 'git';
185
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
158
186
  cache?: SandboxapiGitRepoMountSpec.Cache;
187
+ contexthub?: SandboxapiGitRepoMountSpec.Contexthub;
159
188
  gcs?: SandboxapiGitRepoMountSpec.Gcs;
160
189
  read_only?: boolean;
161
190
  s3?: SandboxapiGitRepoMountSpec.S3;
@@ -176,6 +205,19 @@ export declare namespace SandboxResponse {
176
205
  max_size_bytes?: number;
177
206
  writeback_seconds?: number;
178
207
  }
208
+ interface Contexthub {
209
+ /**
210
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
211
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
212
+ * into the mount path.
213
+ */
214
+ repo: string;
215
+ /**
216
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
217
+ * for the sandbox's lifetime.
218
+ */
219
+ initial_pull_only?: boolean;
220
+ }
179
221
  interface Gcs {
180
222
  bucket: string;
181
223
  prefix?: string;
@@ -188,6 +230,58 @@ export declare namespace SandboxResponse {
188
230
  prefix?: string;
189
231
  }
190
232
  }
233
+ interface SandboxapiContextHubRepoMountSpec {
234
+ id: string;
235
+ contexthub: SandboxapiContextHubRepoMountSpec.Contexthub;
236
+ mount_path: string;
237
+ type: 's3' | 'gcs' | 'git' | 'contexthub';
238
+ cache?: SandboxapiContextHubRepoMountSpec.Cache;
239
+ gcs?: SandboxapiContextHubRepoMountSpec.Gcs;
240
+ git?: SandboxapiContextHubRepoMountSpec.Git;
241
+ read_only?: boolean;
242
+ s3?: SandboxapiContextHubRepoMountSpec.S3;
243
+ }
244
+ namespace SandboxapiContextHubRepoMountSpec {
245
+ interface Contexthub {
246
+ /**
247
+ * Repo is the Context Hub repository to sync, as "owner/repo" (e.g. "-/my-agent",
248
+ * where "-" is the current workspace). The repo's latest commit tree is mirrored
249
+ * into the mount path.
250
+ */
251
+ repo: string;
252
+ /**
253
+ * InitialPullOnly syncs the repo once at startup instead of polling for updates
254
+ * for the sandbox's lifetime.
255
+ */
256
+ initial_pull_only?: boolean;
257
+ }
258
+ interface Cache {
259
+ max_size_bytes?: number;
260
+ writeback_seconds?: number;
261
+ }
262
+ interface Gcs {
263
+ bucket: string;
264
+ prefix?: string;
265
+ }
266
+ interface Git {
267
+ remote_url: string;
268
+ ref?: Git.Ref;
269
+ refresh_interval_seconds?: number;
270
+ }
271
+ namespace Git {
272
+ interface Ref {
273
+ name: string;
274
+ type: 'branch' | 'tag';
275
+ }
276
+ }
277
+ interface S3 {
278
+ bucket: string;
279
+ region: string;
280
+ endpoint_url?: string;
281
+ path_style?: boolean;
282
+ prefix?: string;
283
+ }
284
+ }
191
285
  }
192
286
  interface ProxyConfig {
193
287
  access_control?: ProxyConfig.AccessControl;
@@ -14,7 +14,7 @@ class Threads extends resource_js_1.APIResource {
14
14
  * @example
15
15
  * ```ts
16
16
  * // Automatically fetches more pages as needed.
17
- * for await (const threadTraceListItem of client.threads.listTraces(
17
+ * for await (const threadTrace of client.threads.listTraces(
18
18
  * 'thread_id',
19
19
  * { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
20
20
  * )) {
@@ -33,7 +33,7 @@ class Threads extends resource_js_1.APIResource {
33
33
  * @example
34
34
  * ```ts
35
35
  * // Automatically fetches more pages as needed.
36
- * for await (const threadListItem of client.threads.query()) {
36
+ * for await (const thread of client.threads.query()) {
37
37
  * // ...
38
38
  * }
39
39
  * ```
@@ -52,10 +52,13 @@ class Threads extends resource_js_1.APIResource {
52
52
  *
53
53
  * @example
54
54
  * ```ts
55
- * const response = await client.threads.stats('thread_id', {
56
- * selects: ['TURNS'],
57
- * session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
58
- * });
55
+ * const threadStats = await client.threads.stats(
56
+ * 'thread_id',
57
+ * {
58
+ * selects: ['TURNS'],
59
+ * session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
60
+ * },
61
+ * );
59
62
  * ```
60
63
  */
61
64
  stats(threadID, query, options) {