langsmith 0.9.0 → 0.10.0

package/dist/_openapi_client/client.cjs

@@ -229,7 +229,7 @@ class Langsmith {
             baseURL: baseURL || `https://api.smith.langchain.com/`,
         };
         this.baseURL = options.baseURL;
-        this.timeout = options.timeout ?? _a.DEFAULT_TIMEOUT /* 1.5 minutes */;
+        this.timeout = options.timeout ?? _a.DEFAULT_TIMEOUT; /* 1.5 minutes */
         this.logger = options.logger ?? console;
         const defaultLogLevel = 'warn';
         // Set default logLevel early so that we can log a warning in parseLogLevel.

package/dist/_openapi_client/client.d.ts

@@ -17,7 +17,7 @@ import { AnnotationQueueAnnotationQueuesParams, AnnotationQueueCreateRunStatusPa
 import { DataType, Dataset, DatasetTransformation, DatasetVersion, Datasets, FeedbackCreateCoreSchema, Missing, SortByDatasetColumn } from './resources/datasets/datasets.js';
 import { Public } from './resources/public/public.js';
 import { ResponseBodyForRunsGenerateQuery, Run, RunGetURLParams, RunGetURLResponse, RunIngest, RunQueryParams, RunQueryV2Params, RunRetrieveParams, RunRetrieveV2Params, RunSchema, RunSelectField, RunStatsQueryParams, RunType, RunTypeEnum, Runs, RunsFilterDataSourceTypeEnum, RunsItemsCursorPostPagination } from './resources/runs/runs.js';
-import { SandboxListResponse, SandboxResponse, SandboxStatusResponse, Sandboxes, ServiceURLResponse, SnapshotListResponse, SnapshotResponse } from './resources/sandboxes/sandboxes.js';
+import { DownloadURLResponse, SandboxListResponse, SandboxResponse, SandboxStatusResponse, Sandboxes, ServiceURLResponse, SnapshotListResponse, SnapshotResponse } from './resources/sandboxes/sandboxes.js';
 import { type Fetch } from './internal/builtin-types.js';
 import { HeadersLike, NullableHeaders } from './internal/headers.js';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options.js';
@@ -230,5 +230,5 @@ export declare namespace Langsmith {
     export { AnnotationQueues as AnnotationQueues, type AnnotationQueueRubricItemSchema as AnnotationQueueRubricItemSchema, type AnnotationQueueSchema as AnnotationQueueSchema, type AnnotationQueueSizeSchema as AnnotationQueueSizeSchema, type RunSchemaWithAnnotationQueueInfo as RunSchemaWithAnnotationQueueInfo, type AnnotationQueueRetrieveResponse as AnnotationQueueRetrieveResponse, type AnnotationQueueUpdateResponse as AnnotationQueueUpdateResponse, type AnnotationQueueDeleteResponse as AnnotationQueueDeleteResponse, type AnnotationQueueCreateRunStatusResponse as AnnotationQueueCreateRunStatusResponse, type AnnotationQueueExportResponse as AnnotationQueueExportResponse, type AnnotationQueuePopulateResponse as AnnotationQueuePopulateResponse, type AnnotationQueueRetrieveAnnotationQueuesResponse as AnnotationQueueRetrieveAnnotationQueuesResponse, type AnnotationQueueRetrieveQueuesResponse as AnnotationQueueRetrieveQueuesResponse, type AnnotationQueueRetrieveAnnotationQueuesResponsesOffsetPaginationTopLevelArray as AnnotationQueueRetrieveAnnotationQueuesResponsesOffsetPaginationTopLevelArray, type AnnotationQueueUpdateParams as AnnotationQueueUpdateParams, type AnnotationQueueAnnotationQueuesParams as AnnotationQueueAnnotationQueuesParams, type AnnotationQueueCreateRunStatusParams as AnnotationQueueCreateRunStatusParams, type AnnotationQueueExportParams as AnnotationQueueExportParams, type AnnotationQueuePopulateParams as AnnotationQueuePopulateParams, type AnnotationQueueRetrieveAnnotationQueuesParams as AnnotationQueueRetrieveAnnotationQueuesParams, type AnnotationQueueRetrieveRunParams as AnnotationQueueRetrieveRunParams, type AnnotationQueueRetrieveSizeParams as AnnotationQueueRetrieveSizeParams, type AnnotationQueueRetrieveTotalArchivedParams as AnnotationQueueRetrieveTotalArchivedParams, };
     export { Info as Info, type InfoListResponse as InfoListResponse };
     export { Issues as Issues, type Issue as Issue, type IssuesOffsetPaginationIssues as IssuesOffsetPaginationIssues, type IssueListParams as IssueListParams, };
-    export { Sandboxes as Sandboxes, type SandboxListResponse as SandboxListResponse, type SandboxResponse as SandboxResponse, type SandboxStatusResponse as SandboxStatusResponse, type ServiceURLResponse as ServiceURLResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotResponse as SnapshotResponse, };
+    export { Sandboxes as Sandboxes, type DownloadURLResponse as DownloadURLResponse, type SandboxListResponse as SandboxListResponse, type SandboxResponse as SandboxResponse, type SandboxStatusResponse as SandboxStatusResponse, type ServiceURLResponse as ServiceURLResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotResponse as SnapshotResponse, };
 }

package/dist/_openapi_client/client.js

@@ -193,7 +193,7 @@ export class Langsmith {
             baseURL: baseURL || `https://api.smith.langchain.com/`,
         };
         this.baseURL = options.baseURL;
-        this.timeout = options.timeout ?? _a.DEFAULT_TIMEOUT /* 1.5 minutes */;
+        this.timeout = options.timeout ?? _a.DEFAULT_TIMEOUT; /* 1.5 minutes */
         this.logger = options.logger ?? console;
         const defaultLogLevel = 'warn';
         // Set default logLevel early so that we can log a warning in parseLogLevel.

package/dist/_openapi_client/internal/detect-platform.cjs

@@ -38,7 +38,7 @@ const getPlatformProperties = () => {
             'X-Stainless-OS': normalizePlatform(Deno.build.os),
             'X-Stainless-Arch': normalizeArch(Deno.build.arch),
             'X-Stainless-Runtime': 'deno',
-            'X-Stainless-Runtime-Version': typeof Deno.version === 'string' ? Deno.version : Deno.version?.deno ?? 'unknown',
+            'X-Stainless-Runtime-Version': typeof Deno.version === 'string' ? Deno.version : (Deno.version?.deno ?? 'unknown'),
         };
     }
     if (typeof EdgeRuntime !== 'undefined') {

package/dist/_openapi_client/internal/detect-platform.js

@@ -34,7 +34,7 @@ const getPlatformProperties = () => {
             'X-Stainless-OS': normalizePlatform(Deno.build.os),
             'X-Stainless-Arch': normalizeArch(Deno.build.arch),
             'X-Stainless-Runtime': 'deno',
-            'X-Stainless-Runtime-Version': typeof Deno.version === 'string' ? Deno.version : Deno.version?.deno ?? 'unknown',
+            'X-Stainless-Runtime-Version': typeof Deno.version === 'string' ? Deno.version : (Deno.version?.deno ?? 'unknown'),
         };
     }
     if (typeof EdgeRuntime !== 'undefined') {

package/dist/_openapi_client/resources/annotation-queues/annotation-queues.d.ts

@@ -80,6 +80,7 @@ export interface AnnotationQueueRubricItemSchema {
     description?: string | null;
     is_assertion?: boolean | null;
     is_required?: boolean | null;
+    regex_validator?: string | DatasetsAPI.Missing | null;
     score_descriptions?: {
         [key: string]: string;
     } | null;

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

@@ -5,6 +5,6 @@ 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 { Public } from './public/public.js';
 export { Runs, type ResponseBodyForRunsGenerateQuery, type Run, type RunIngest, type RunSchema, type RunSelectField, type RunStatsQueryParams, type RunType, type RunTypeEnum, type RunsFilterDataSourceTypeEnum, type RunGetURLResponse, type RunGetURLParams, type RunQueryV2Params, type RunRetrieveV2Params, type RunRetrieveParams, type RunQueryParams, type RunsItemsCursorPostPagination, } from './runs/runs.js';
-export { Sandboxes, type SandboxListResponse, type SandboxResponse, type SandboxStatusResponse, type ServiceURLResponse, type SnapshotListResponse, type SnapshotResponse, } from './sandboxes/sandboxes.js';
+export { Sandboxes, type DownloadURLResponse, type SandboxListResponse, type SandboxResponse, type SandboxStatusResponse, type ServiceURLResponse, type SnapshotListResponse, type SnapshotResponse, type SandboxResponsesItemsCursorGetPagination, type SnapshotResponsesItemsCursorGetPagination, } from './sandboxes/sandboxes.js';
 export { Threads, type Thread, type ThreadStats, type ThreadTrace, type ThreadListTracesParams, type ThreadQueryParams, type ThreadStatsParams, type ThreadTracesItemsCursorGetPagination, type ThreadsItemsCursorPostPagination, } 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/issues.cjs

@@ -19,7 +19,7 @@ class Issues extends resource_js_1.APIResource {
      * **Beta:** This endpoint is in active development and may change without notice.
      *
      * Returns issues for the authenticated tenant, optionally filtered by session,
-     * status, severity, tag, or last modified time.
+     * status, severity, tag, linked trace, or last modified time.
      */
     list(query = {}, options) {
         return this._client.getAPIList('/api/v1/platform/issues', (pagination_js_1.OffsetPaginationIssues), {

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

@@ -13,7 +13,7 @@ export declare class Issues extends APIResource {
      * **Beta:** This endpoint is in active development and may change without notice.
      *
      * Returns issues for the authenticated tenant, optionally filtered by session,
-     * status, severity, tag, or last modified time.
+     * status, severity, tag, linked trace, or last modified time.
      */
     list(query?: IssueListParams | null | undefined, options?: RequestOptions): PagePromise<IssuesOffsetPaginationIssues, Issue>;
 }
@@ -36,6 +36,7 @@ export interface Issue {
     fix_prompt?: string;
     fix_verification?: unknown;
     last_seen_at?: string;
+    linear_sync?: Issue.LinearSync;
     name?: string;
     proposed_context_fixes?: Array<unknown>;
     proposed_examples?: Array<unknown>;
@@ -55,6 +56,18 @@ export interface Issue {
     updated_at?: string;
     watching_since?: string;
 }
+export declare namespace Issue {
+    interface LinearSync {
+        identifier?: string;
+        issue_id?: string;
+        last_attempted_at?: string;
+        last_error?: string;
+        last_synced_at?: string;
+        linear_issue_id?: string;
+        state?: 'pending' | 'synced' | 'failed' | 'auth_required' | 'paused';
+        url?: string;
+    }
+}
 export interface IssueListParams extends OffsetPaginationIssuesParams {
     /**
      * Filter by session ID (UUID)
@@ -80,6 +93,10 @@ export interface IssueListParams extends OffsetPaginationIssuesParams {
      * Filter by tag (exact match)
      */
     tag?: string;
+    /**
+     * Return only issues with a linked run in this trace
+     */
+    trace_id?: string;
     /**
      * Return only issues updated at or after this RFC3339 timestamp
      */

package/dist/_openapi_client/resources/issues.js

@@ -16,7 +16,7 @@ export class Issues extends APIResource {
      * **Beta:** This endpoint is in active development and may change without notice.
      *
      * Returns issues for the authenticated tenant, optionally filtered by session,
-     * status, severity, tag, or last modified time.
+     * status, severity, tag, linked trace, or last modified time.
      */
     list(query = {}, options) {
         return this._client.getAPIList('/api/v1/platform/issues', (OffsetPaginationIssues), {

package/dist/_openapi_client/resources/online-evaluators.d.ts

@@ -93,8 +93,8 @@ export interface OnlineEvaluator {
     created_by?: string;
     feedback_keys?: Array<string>;
     /**
-     * IsManaged marks a LangChain-managed evaluator (currently the managed Perceived
-     * Error judge). NULL in the DB is read as false via COALESCE.
+     * IsManaged marks a LangChain Tuned Evaluator (currently the tuned Perceived Error
+     * judge). NULL in the DB is read as false via COALESCE.
      */
     is_managed?: boolean;
     /**

package/dist/_openapi_client/resources/sandboxes/boxes.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Boxes = void 0;
 const resource_js_1 = require("../../core/resource.cjs");
+const pagination_js_1 = require("../../core/pagination.cjs");
 const headers_js_1 = require("../../internal/headers.cjs");
 const path_js_1 = require("../../internal/utils/path.cjs");
 class Boxes extends resource_js_1.APIResource {
@@ -23,17 +24,22 @@ class Boxes extends resource_js_1.APIResource {
         return this._client.get((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}`, options);
     }
     /**
-     * Update a sandbox's display name. The name must be unique within the tenant.
+     * Update a sandbox's display name, retention, resources, tags, or proxy
+     * configuration. The name must be unique within the tenant. Proxy configuration
+     * sent to a sandbox that is not running is stored and applied when it next starts.
      */
     update(name, body, options) {
         return this._client.patch((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}`, { body, ...options });
     }
     /**
      * List sandboxes for the authenticated tenant, with optional filtering, sorting,
-     * and pagination.
+     * and pagination. Page with page_size and cursor: replay the response's
+     * next_cursor until it comes back null, which is the only signal that no pages
+     * remain. Cursors are opaque and only valid on this endpoint; do not parse or
+     * construct one.
      */
     list(query = {}, options) {
-        return this._client.get('/api/v2/sandboxes/boxes', { query, ...options });
+        return this._client.getAPIList('/api/v2/sandboxes/boxes', (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
     }
     /**
      * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
@@ -52,6 +58,17 @@ class Boxes extends resource_js_1.APIResource {
     createSnapshot(name, body, options) {
         return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
     }
+    /**
+     * Generate a tokenized link that downloads a single file from a sandbox with no
+     * further authentication. This mints a token rather than creating an addressable
+     * resource, so it returns 200 with no Location header. The token pins the sandbox,
+     * the file path, and the response content type and disposition, so a link cannot
+     * be repointed at another file. Links never expire unless expires_in_seconds is
+     * set. The link is served from the sandbox service domain, not the API host.
+     */
+    generateDownloadURL(name, body, options) {
+        return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/download-url`, { body, ...options });
+    }
     /**
      * Create a short-lived JWT for accessing an HTTP service running on a specific
      * port inside a sandbox. Returns a browser_url (sets auth cookie via redirect), a

package/dist/_openapi_client/resources/sandboxes/boxes.d.ts

@@ -1,6 +1,8 @@
 import { APIResource } from '../../core/resource.js';
 import * as SandboxesAPI from './sandboxes.js';
+import { SandboxResponsesItemsCursorGetPagination } from './sandboxes.js';
 import { APIPromise } from '../../core/api-promise.js';
+import { type ItemsCursorGetPaginationParams, PagePromise } from '../../core/pagination.js';
 import { RequestOptions } from '../../internal/request-options.js';
 export declare class Boxes extends APIResource {
     /**
@@ -15,14 +17,19 @@ export declare class Boxes extends APIResource {
      */
     retrieve(name: string, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
     /**
-     * Update a sandbox's display name. The name must be unique within the tenant.
+     * Update a sandbox's display name, retention, resources, tags, or proxy
+     * configuration. The name must be unique within the tenant. Proxy configuration
+     * sent to a sandbox that is not running is stored and applied when it next starts.
      */
     update(name: string, body: BoxUpdateParams, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxResponse>;
     /**
      * List sandboxes for the authenticated tenant, with optional filtering, sorting,
-     * and pagination.
+     * and pagination. Page with page_size and cursor: replay the response's
+     * next_cursor until it comes back null, which is the only signal that no pages
+     * remain. Cursors are opaque and only valid on this endpoint; do not parse or
+     * construct one.
      */
-    list(query?: BoxListParams | null | undefined, options?: RequestOptions): APIPromise<SandboxesAPI.SandboxListResponse>;
+    list(query?: BoxListParams | null | undefined, options?: RequestOptions): PagePromise<SandboxResponsesItemsCursorGetPagination, SandboxesAPI.SandboxResponse>;
     /**
      * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
      * DB record.
@@ -33,6 +40,15 @@ export declare class Boxes extends APIResource {
      * existing checkpoint.
      */
     createSnapshot(name: string, body: BoxCreateSnapshotParams, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotResponse>;
+    /**
+     * Generate a tokenized link that downloads a single file from a sandbox with no
+     * further authentication. This mints a token rather than creating an addressable
+     * resource, so it returns 200 with no Location header. The token pins the sandbox,
+     * the file path, and the response content type and disposition, so a link cannot
+     * be repointed at another file. Links never expire unless expires_in_seconds is
+     * set. The link is served from the sandbox service domain, not the API host.
+     */
+    generateDownloadURL(name: string, body: BoxGenerateDownloadURLParams, options?: RequestOptions): APIPromise<SandboxesAPI.DownloadURLResponse>;
     /**
      * Create a short-lived JWT for accessing an HTTP service running on a specific
      * port inside a sandbox. Returns a browser_url (sets auth cookie via redirect), a
@@ -555,7 +571,7 @@ export declare namespace BoxUpdateParams {
         }
     }
 }
-export interface BoxListParams {
+export interface BoxListParams extends ItemsCursorGetPaginationParams {
     /**
      * Filter by creator identity. Only 'me' is supported.
      */
@@ -566,7 +582,7 @@ export interface BoxListParams {
      */
     label?: Array<string>;
     /**
-     * Maximum number of results
+     * Deprecated: use page_size. Maximum number of results
      */
     limit?: number;
     /**
@@ -574,17 +590,22 @@ export interface BoxListParams {
      */
     name_contains?: string;
     /**
-     * Pagination offset
+     * Deprecated: use cursor. Pagination offset
      */
     offset?: number;
     /**
-     * Sort column (name, status, created_at)
+     * Sort column (name, status, created_at, stopped_at, idle_ttl_seconds,
+     * delete_after_stop_seconds)
      */
     sort_by?: string;
     /**
-     * Sort direction (asc, desc)
+     * Deprecated: use sort_order. Sort direction (asc, desc)
      */
     sort_direction?: string;
+    /**
+     * Sort direction (asc, desc)
+     */
+    sort_order?: string;
     /**
      * Filter by status (provisioning, ready, failed, stopped, deleting)
      */
@@ -622,10 +643,20 @@ export interface BoxCreateSnapshotParams {
      */
     tag?: string;
 }
+export interface BoxGenerateDownloadURLParams {
+    path: string;
+    content_disposition?: string;
+    content_type?: string;
+    /**
+     * ExpiresInSeconds is optional; a link with no expiry never expires.
+     */
+    expires_in_seconds?: number;
+}
 export interface BoxGenerateServiceURLParams {
     expires_in_seconds?: number;
     port?: number;
 }
 export declare namespace Boxes {
-    export { type BoxCreateParams as BoxCreateParams, type BoxUpdateParams as BoxUpdateParams, type BoxListParams as BoxListParams, type BoxCreateSnapshotParams as BoxCreateSnapshotParams, type BoxGenerateServiceURLParams as BoxGenerateServiceURLParams, };
+    export { type BoxCreateParams as BoxCreateParams, type BoxUpdateParams as BoxUpdateParams, type BoxListParams as BoxListParams, type BoxCreateSnapshotParams as BoxCreateSnapshotParams, type BoxGenerateDownloadURLParams as BoxGenerateDownloadURLParams, type BoxGenerateServiceURLParams as BoxGenerateServiceURLParams, };
 }
+export { type SandboxResponsesItemsCursorGetPagination };

package/dist/_openapi_client/resources/sandboxes/boxes.js

@@ -1,6 +1,7 @@
 // @ts-nocheck
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from '../../core/resource.js';
+import { ItemsCursorGetPagination, } from '../../core/pagination.js';
 import { buildHeaders } from '../../internal/headers.js';
 import { path } from '../../internal/utils/path.js';
 export class Boxes extends APIResource {
@@ -20,17 +21,22 @@ export class Boxes extends APIResource {
         return this._client.get(path `/api/v2/sandboxes/boxes/${name}`, options);
     }
     /**
-     * Update a sandbox's display name. The name must be unique within the tenant.
+     * Update a sandbox's display name, retention, resources, tags, or proxy
+     * configuration. The name must be unique within the tenant. Proxy configuration
+     * sent to a sandbox that is not running is stored and applied when it next starts.
      */
     update(name, body, options) {
         return this._client.patch(path `/api/v2/sandboxes/boxes/${name}`, { body, ...options });
     }
     /**
      * List sandboxes for the authenticated tenant, with optional filtering, sorting,
-     * and pagination.
+     * and pagination. Page with page_size and cursor: replay the response's
+     * next_cursor until it comes back null, which is the only signal that no pages
+     * remain. Cursors are opaque and only valid on this endpoint; do not parse or
+     * construct one.
      */
     list(query = {}, options) {
-        return this._client.get('/api/v2/sandboxes/boxes', { query, ...options });
+        return this._client.getAPIList('/api/v2/sandboxes/boxes', (ItemsCursorGetPagination), { query, ...options });
     }
     /**
      * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
@@ -49,6 +55,17 @@ export class Boxes extends APIResource {
     createSnapshot(name, body, options) {
         return this._client.post(path `/api/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
     }
+    /**
+     * Generate a tokenized link that downloads a single file from a sandbox with no
+     * further authentication. This mints a token rather than creating an addressable
+     * resource, so it returns 200 with no Location header. The token pins the sandbox,
+     * the file path, and the response content type and disposition, so a link cannot
+     * be repointed at another file. Links never expire unless expires_in_seconds is
+     * set. The link is served from the sandbox service domain, not the API host.
+     */
+    generateDownloadURL(name, body, options) {
+        return this._client.post(path `/api/v2/sandboxes/boxes/${name}/download-url`, { body, ...options });
+    }
     /**
      * Create a short-lived JWT for accessing an HTTP service running on a specific
      * port inside a sandbox. Returns a browser_url (sets auth cookie via redirect), a

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

@@ -1,17 +1,44 @@
 import { APIResource } from '../../core/resource.js';
 import * as BoxesAPI from './boxes.js';
-import { BoxCreateParams, BoxCreateSnapshotParams, BoxGenerateServiceURLParams, BoxListParams, BoxUpdateParams, Boxes } from './boxes.js';
+import { BoxCreateParams, BoxCreateSnapshotParams, BoxGenerateDownloadURLParams, BoxGenerateServiceURLParams, BoxListParams, BoxUpdateParams, Boxes } from './boxes.js';
 import * as RegistriesAPI from './registries.js';
 import { Registries, RegistryCreateParams, RegistryListParams, RegistryListResponse, RegistryResponse, RegistryUpdateParams } from './registries.js';
 import * as SnapshotsAPI from './snapshots.js';
 import { SnapshotCreateParams, SnapshotListParams, SnapshotRetrieveByNameResponse, Snapshots } from './snapshots.js';
+import { ItemsCursorGetPagination } from '../../core/pagination.js';
 export declare class Sandboxes extends APIResource {
     boxes: BoxesAPI.Boxes;
     registries: RegistriesAPI.Registries;
     snapshots: SnapshotsAPI.Snapshots;
 }
+export type SandboxResponsesItemsCursorGetPagination = ItemsCursorGetPagination<SandboxResponse>;
+export type SnapshotResponsesItemsCursorGetPagination = ItemsCursorGetPagination<SnapshotResponse>;
+export interface DownloadURLResponse {
+    token: string;
+    download_url: string;
+    /**
+     * ExpiresAt is null for a link that never expires.
+     */
+    expires_at?: string | null;
+}
 export interface SandboxListResponse {
+    /**
+     * This page of sandboxes.
+     */
+    items?: Array<SandboxResponse>;
+    /**
+     * Cursor for the next page, or null on the last page. A non-null value is the only
+     * signal that more pages exist. Treat it as opaque.
+     */
+    next_cursor?: string;
+    /**
+     * Deprecated: use next_cursor. Offset to request for the next page, or 0 when no
+     * pages remain.
+     */
     offset?: number;
+    /**
+     * Deprecated: use items. Duplicates items.
+     */
     sandboxes?: Array<SandboxResponse>;
 }
 export interface SandboxResponse {
@@ -386,7 +413,23 @@ export interface ServiceURLResponse {
     service_url?: string;
 }
 export interface SnapshotListResponse {
+    /**
+     * This page of snapshots.
+     */
+    items?: Array<SnapshotResponse>;
+    /**
+     * Cursor for the next page, or null on the last page. A non-null value is the only
+     * signal that more pages exist. Treat it as opaque.
+     */
+    next_cursor?: string;
+    /**
+     * Deprecated: use next_cursor. Offset to request for the next page, or 0 when no
+     * pages remain.
+     */
     offset?: number;
+    /**
+     * Deprecated: use items. Duplicates items.
+     */
     snapshots?: Array<SnapshotResponse>;
 }
 export interface SnapshotResponse {
@@ -419,8 +462,8 @@ export interface SnapshotResponse {
     updated_at?: string;
 }
 export declare namespace Sandboxes {
-    export { type SandboxListResponse as SandboxListResponse, type SandboxResponse as SandboxResponse, type SandboxStatusResponse as SandboxStatusResponse, type ServiceURLResponse as ServiceURLResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotResponse as SnapshotResponse, };
-    export { Boxes as Boxes, type BoxCreateParams as BoxCreateParams, type BoxUpdateParams as BoxUpdateParams, type BoxListParams as BoxListParams, type BoxCreateSnapshotParams as BoxCreateSnapshotParams, type BoxGenerateServiceURLParams as BoxGenerateServiceURLParams, };
+    export { type DownloadURLResponse as DownloadURLResponse, type SandboxListResponse as SandboxListResponse, type SandboxResponse as SandboxResponse, type SandboxStatusResponse as SandboxStatusResponse, type ServiceURLResponse as ServiceURLResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotResponse as SnapshotResponse, };
+    export { Boxes as Boxes, type BoxCreateParams as BoxCreateParams, type BoxUpdateParams as BoxUpdateParams, type BoxListParams as BoxListParams, type BoxCreateSnapshotParams as BoxCreateSnapshotParams, type BoxGenerateDownloadURLParams as BoxGenerateDownloadURLParams, type BoxGenerateServiceURLParams as BoxGenerateServiceURLParams, };
     export { Registries as Registries, type RegistryListResponse as RegistryListResponse, type RegistryResponse as RegistryResponse, type RegistryCreateParams as RegistryCreateParams, type RegistryUpdateParams as RegistryUpdateParams, type RegistryListParams as RegistryListParams, };
     export { Snapshots as Snapshots, type SnapshotRetrieveByNameResponse as SnapshotRetrieveByNameResponse, type SnapshotCreateParams as SnapshotCreateParams, type SnapshotListParams as SnapshotListParams, };
 }

package/dist/_openapi_client/resources/sandboxes/snapshots.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Snapshots = void 0;
 const resource_js_1 = require("../../core/resource.cjs");
+const pagination_js_1 = require("../../core/pagination.cjs");
 const headers_js_1 = require("../../internal/headers.cjs");
 const path_js_1 = require("../../internal/utils/path.cjs");
 class Snapshots extends resource_js_1.APIResource {
@@ -23,10 +24,13 @@ class Snapshots extends resource_js_1.APIResource {
     }
     /**
      * List sandbox snapshots for the authenticated tenant, with optional filtering,
-     * sorting, and pagination.
+     * sorting, and pagination. Page with page_size and cursor: replay the response's
+     * next_cursor until it comes back null, which is the only signal that no pages
+     * remain. Cursors are opaque and only valid on this endpoint; do not parse or
+     * construct one.
      */
     list(query = {}, options) {
-        return this._client.get('/api/v2/sandboxes/snapshots', { query, ...options });
+        return this._client.getAPIList('/api/v2/sandboxes/snapshots', (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
     }
     /**
      * Delete a snapshot by ID or by a Docker-style name[:tag] reference. The

package/dist/_openapi_client/resources/sandboxes/snapshots.d.ts

@@ -1,6 +1,8 @@
 import { APIResource } from '../../core/resource.js';
 import * as SandboxesAPI from './sandboxes.js';
+import { SnapshotResponsesItemsCursorGetPagination } from './sandboxes.js';
 import { APIPromise } from '../../core/api-promise.js';
+import { type ItemsCursorGetPaginationParams, PagePromise } from '../../core/pagination.js';
 import { RequestOptions } from '../../internal/request-options.js';
 export declare class Snapshots extends APIResource {
     /**
@@ -15,9 +17,12 @@ export declare class Snapshots extends APIResource {
     retrieve(snapshotID: string, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotResponse>;
     /**
      * List sandbox snapshots for the authenticated tenant, with optional filtering,
-     * sorting, and pagination.
+     * sorting, and pagination. Page with page_size and cursor: replay the response's
+     * next_cursor until it comes back null, which is the only signal that no pages
+     * remain. Cursors are opaque and only valid on this endpoint; do not parse or
+     * construct one.
      */
-    list(query?: SnapshotListParams | null | undefined, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotListResponse>;
+    list(query?: SnapshotListParams | null | undefined, options?: RequestOptions): PagePromise<SnapshotResponsesItemsCursorGetPagination, SandboxesAPI.SnapshotResponse>;
     /**
      * Delete a snapshot by ID or by a Docker-style name[:tag] reference. The
      * underlying storage is reclaimed asynchronously.
@@ -56,7 +61,7 @@ export interface SnapshotCreateParams {
      */
     tag?: string;
 }
-export interface SnapshotListParams {
+export interface SnapshotListParams extends ItemsCursorGetPaginationParams {
     /**
      * Filter by creator identity. Only 'me' is supported.
      */
@@ -67,7 +72,7 @@ export interface SnapshotListParams {
      */
     label?: Array<string>;
     /**
-     * Maximum number of results
+     * Deprecated: use page_size. Maximum number of results
      */
     limit?: number;
     /**
@@ -75,7 +80,7 @@ export interface SnapshotListParams {
      */
     name_contains?: string;
     /**
-     * Pagination offset
+     * Deprecated: use cursor. Pagination offset
      */
     offset?: number;
     /**
@@ -83,9 +88,13 @@ export interface SnapshotListParams {
      */
     sort_by?: string;
     /**
-     * Sort direction (asc, desc)
+     * Deprecated: use sort_order. Sort direction (asc, desc)
      */
     sort_direction?: string;
+    /**
+     * Sort direction (asc, desc)
+     */
+    sort_order?: string;
     /**
      * Filter by status (building, ready, failed, deleting)
      */
@@ -94,3 +103,4 @@ export interface SnapshotListParams {
 export declare namespace Snapshots {
     export { type SnapshotRetrieveByNameResponse as SnapshotRetrieveByNameResponse, type SnapshotCreateParams as SnapshotCreateParams, type SnapshotListParams as SnapshotListParams, };
 }
+export { type SnapshotResponsesItemsCursorGetPagination };

package/dist/_openapi_client/resources/sandboxes/snapshots.js

@@ -1,6 +1,7 @@
 // @ts-nocheck
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from '../../core/resource.js';
+import { ItemsCursorGetPagination, } from '../../core/pagination.js';
 import { buildHeaders } from '../../internal/headers.js';
 import { path } from '../../internal/utils/path.js';
 export class Snapshots extends APIResource {
@@ -20,10 +21,13 @@ export class Snapshots extends APIResource {
     }
     /**
      * List sandbox snapshots for the authenticated tenant, with optional filtering,
-     * sorting, and pagination.
+     * sorting, and pagination. Page with page_size and cursor: replay the response's
+     * next_cursor until it comes back null, which is the only signal that no pages
+     * remain. Cursors are opaque and only valid on this endpoint; do not parse or
+     * construct one.
      */
     list(query = {}, options) {
-        return this._client.get('/api/v2/sandboxes/snapshots', { query, ...options });
+        return this._client.getAPIList('/api/v2/sandboxes/snapshots', (ItemsCursorGetPagination), { query, ...options });
     }
     /**
      * Delete a snapshot by ID or by a Docker-style name[:tag] reference. The