langsmith 0.8.7 → 0.8.8

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

@@ -150,6 +150,11 @@ export interface Run {
      * `is_root` is true when this run has no parent (it is the trace root).
      */
     is_root?: boolean;
+    /**
+     * `last_queued_at` is the most recent time this run was added to an annotation
+     * queue.
+     */
+    last_queued_at?: string;
     /**
      * `latency_seconds` is wall-clock duration from start to end in seconds.
      */
@@ -545,11 +550,12 @@ export interface RunSchema {
     trace_upgrade?: boolean;
     ttl_seconds?: number | null;
 }
-export type RunSelectField = 'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'SHARE_URL' | 'FEEDBACK_STATS';
+export type RunSelectField = 'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'LAST_QUEUED_AT' | 'SHARE_URL' | 'FEEDBACK_STATS';
 /**
  * Query params for run stats.
  */
 export interface RunStatsQueryParams {
+    session: Array<string>;
     id?: Array<string> | null;
     /**
      * Enum for run data source types.
@@ -576,7 +582,6 @@ export interface RunStatsQueryParams {
     run_type?: RunTypeEnum | null;
     search_filter?: string | null;
     select?: Array<'run_count' | 'latency_p50' | 'latency_p99' | 'latency_avg' | 'first_token_p50' | 'first_token_p99' | 'total_tokens' | 'prompt_tokens' | 'completion_tokens' | 'median_tokens' | 'completion_tokens_p50' | 'prompt_tokens_p50' | 'tokens_p99' | 'completion_tokens_p99' | 'prompt_tokens_p99' | 'last_run_start_time' | 'feedback_stats' | 'thread_feedback_stats' | 'run_facets' | 'error_rate' | 'streaming_rate' | 'total_cost' | 'prompt_cost' | 'completion_cost' | 'cost_p50' | 'cost_p99' | 'session_feedback_stats' | 'all_run_stats' | 'all_token_stats' | 'group_count' | 'prompt_token_details' | 'completion_token_details' | 'prompt_cost_details' | 'completion_cost_details'> | null;
-    session?: Array<string> | null;
     skip_pagination?: boolean | null;
     start_time?: string | null;
     /**
@@ -725,7 +730,7 @@ export interface RunRetrieveV2Params {
      * (repeatable query parameter). Accepts any value of the `RunSelectField` enum. If
      * omitted, only `id` is returned.
      */
-    selects?: Array<'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'SHARE_URL' | 'FEEDBACK_STATS'>;
+    selects?: Array<'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'LAST_QUEUED_AT' | 'SHARE_URL' | 'FEEDBACK_STATS'>;
     /**
      * Query param: `start_time` is the run's `start_time` (RFC3339 date-time).
      * Providing it speeds up retrieval.
@@ -746,7 +751,7 @@ export interface RunRetrieveParams {
      * (repeatable query parameter). Accepts any value of the `RunSelectField` enum. If
      * omitted, only `id` is returned.
      */
-    selects?: Array<'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'SHARE_URL' | 'FEEDBACK_STATS'>;
+    selects?: Array<'ID' | 'NAME' | 'RUN_TYPE' | 'STATUS' | 'START_TIME' | 'END_TIME' | 'LATENCY_SECONDS' | 'FIRST_TOKEN_TIME' | 'ERROR' | 'ERROR_PREVIEW' | 'EXTRA' | 'METADATA' | 'EVENTS' | 'INPUTS' | 'INPUTS_PREVIEW' | 'OUTPUTS' | 'OUTPUTS_PREVIEW' | 'MANIFEST' | 'PARENT_RUN_IDS' | 'PROJECT_ID' | 'TRACE_ID' | 'THREAD_ID' | 'DOTTED_ORDER' | 'IS_ROOT' | 'REFERENCE_EXAMPLE_ID' | 'REFERENCE_DATASET_ID' | 'TOTAL_TOKENS' | 'PROMPT_TOKENS' | 'COMPLETION_TOKENS' | 'TOTAL_COST' | 'PROMPT_COST' | 'COMPLETION_COST' | 'PROMPT_TOKEN_DETAILS' | 'COMPLETION_TOKEN_DETAILS' | 'PROMPT_COST_DETAILS' | 'COMPLETION_COST_DETAILS' | 'PRICE_MODEL_ID' | 'TAGS' | 'APP_PATH' | 'ATTACHMENTS' | 'THREAD_EVALUATION_TIME' | 'IS_IN_DATASET' | 'LAST_QUEUED_AT' | 'SHARE_URL' | 'FEEDBACK_STATS'>;
     /**
      * Query param: `start_time` is the run's `start_time` (RFC3339 date-time).
      * Providing it speeds up retrieval.

package/dist/_openapi_client/resources/runs/runs.js

@@ -42,7 +42,7 @@ export class Runs extends APIResource {
      * ```
      */
     getURL(runID, query, options) {
-        return this._client.get(path `/v2/runs/${runID}/url`, { query, ...options });
+        return this._client.get(path `/api/v2/runs/${runID}/url`, { query, ...options });
     }
     /**
      * **Alpha:** The request and response contract may change; Returns a paginated
@@ -59,7 +59,7 @@ export class Runs extends APIResource {
      */
     queryV2(params, options) {
         const { Accept, ...body } = params;
-        return this._client.getAPIList('/v2/runs/query', (ItemsCursorPostPagination), {
+        return this._client.getAPIList('/api/v2/runs/query', (ItemsCursorPostPagination), {
             body,
             method: 'post',
             ...options,
@@ -81,7 +81,7 @@ export class Runs extends APIResource {
      */
     retrieveV2(runID, params, options) {
         const { Accept, ...query } = params;
-        return this._client.get(path `/v2/runs/${runID}`, {
+        return this._client.get(path `/api/v2/runs/${runID}`, {
             query,
             ...options,
             headers: buildHeaders([{ ...(Accept != null ? { Accept: Accept } : undefined) }, options?.headers]),

package/dist/_openapi_client/resources/runs/share.cjs

@@ -18,7 +18,7 @@ class Share extends resource_js_1.APIResource {
      * ```
      */
     create(runID, body, options) {
-        return this._client.post((0, path_js_1.path) `/v2/runs/${runID}/share`, { body, ...options });
+        return this._client.post((0, path_js_1.path) `/api/v2/runs/${runID}/share`, { body, ...options });
     }
     /**
      * Deletes the share token for the trace identified by trace_id and session_id.
@@ -32,7 +32,7 @@ class Share extends resource_js_1.APIResource {
      * ```
      */
     delete(traceID, body, options) {
-        return this._client.delete((0, path_js_1.path) `/v2/runs/${traceID}/share`, {
+        return this._client.delete((0, path_js_1.path) `/api/v2/runs/${traceID}/share`, {
             body,
             ...options,
             headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),

package/dist/_openapi_client/resources/runs/share.js

@@ -15,7 +15,7 @@ export class Share extends APIResource {
      * ```
      */
     create(runID, body, options) {
-        return this._client.post(path `/v2/runs/${runID}/share`, { body, ...options });
+        return this._client.post(path `/api/v2/runs/${runID}/share`, { body, ...options });
     }
     /**
      * Deletes the share token for the trace identified by trace_id and session_id.
@@ -29,7 +29,7 @@ export class Share extends APIResource {
      * ```
      */
     delete(traceID, body, options) {
-        return this._client.delete(path `/v2/runs/${traceID}/share`, {
+        return this._client.delete(path `/api/v2/runs/${traceID}/share`, {
             body,
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),

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

@@ -12,33 +12,33 @@ class Boxes extends resource_js_1.APIResource {
      * `snapshot_name`; if neither is provided, the server uses the default snapshot.
      */
     create(body, options) {
-        return this._client.post('/v2/sandboxes/boxes', { body, ...options });
+        return this._client.post('/api/v2/sandboxes/boxes', { body, ...options });
     }
     /**
      * Retrieve a sandbox by name. Stale provisioning sandboxes are auto-failed.
      */
     retrieve(name, options) {
-        return this._client.get((0, path_js_1.path) `/v2/sandboxes/boxes/${name}`, options);
+        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(name, body, options) {
-        return this._client.patch((0, path_js_1.path) `/v2/sandboxes/boxes/${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.
      */
     list(query = {}, options) {
-        return this._client.get('/v2/sandboxes/boxes', { query, ...options });
+        return this._client.get('/api/v2/sandboxes/boxes', { query, ...options });
     }
     /**
      * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
      * DB record.
      */
     delete(name, options) {
-        return this._client.delete((0, path_js_1.path) `/v2/sandboxes/boxes/${name}`, {
+        return this._client.delete((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}`, {
             ...options,
             headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });
@@ -48,7 +48,7 @@ class Boxes extends resource_js_1.APIResource {
      * existing checkpoint.
      */
     createSnapshot(name, body, options) {
-        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
+        return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
     }
     /**
      * Create a short-lived JWT for accessing an HTTP service running on a specific
@@ -57,26 +57,26 @@ class Boxes extends resource_js_1.APIResource {
      * token, and its expiry.
      */
     generateServiceURL(name, body, options) {
-        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/service-url`, { body, ...options });
+        return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/service-url`, { body, ...options });
     }
     /**
      * Retrieve the lightweight status of a sandbox for polling.
      */
     getStatus(name, options) {
-        return this._client.get((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/status`, options);
+        return this._client.get((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/status`, options);
     }
     /**
      * Start a stopped or failed sandbox. This endpoint is not idempotent.
      */
     start(name, options) {
-        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/start`, options);
+        return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/start`, options);
     }
     /**
      * Stop a ready sandbox. This endpoint is not idempotent; the filesystem is
      * preserved for later restart.
      */
     stop(name, options) {
-        return this._client.post((0, path_js_1.path) `/v2/sandboxes/boxes/${name}/stop`, {
+        return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/stop`, {
             ...options,
             headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });

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

@@ -65,6 +65,13 @@ export interface BoxCreateParams {
     };
     fs_capacity_bytes?: number;
     idle_ttl_seconds?: number;
+    /**
+     * Labels are free-form key/value metadata persisted with the sandbox and returned
+     * on reads. Labels from the source snapshot are inherited unless overridden here.
+     */
+    labels?: {
+        [key: string]: string;
+    };
     mem_bytes?: number;
     mount_config?: BoxCreateParams.MountConfig;
     name?: string;
@@ -369,6 +376,17 @@ export declare namespace BoxCreateParams {
             name: string;
             aws?: Rule.Aws;
             enabled?: boolean;
+            /**
+             * EnvVars are plaintext env vars set for every command in the sandbox while this
+             * rule is enabled. Use them for tools that refuse to run unless a credential env
+             * var is present (e.g. gh needs GH_TOKEN) even though this rule injects the real
+             * credential on the wire — set a dummy value here so the command starts. Explicit
+             * per-sandbox env_vars win over these, and provider-managed (AWS/GCP) vars win
+             * over both.
+             */
+            env_vars?: {
+                [key: string]: string;
+            };
             gcp?: Rule.Gcp;
             headers?: Array<Rule.Header>;
             /**
@@ -458,6 +476,17 @@ export declare namespace BoxUpdateParams {
             name: string;
             aws?: Rule.Aws;
             enabled?: boolean;
+            /**
+             * EnvVars are plaintext env vars set for every command in the sandbox while this
+             * rule is enabled. Use them for tools that refuse to run unless a credential env
+             * var is present (e.g. gh needs GH_TOKEN) even though this rule injects the real
+             * credential on the wire — set a dummy value here so the command starts. Explicit
+             * per-sandbox env_vars win over these, and provider-managed (AWS/GCP) vars win
+             * over both.
+             */
+            env_vars?: {
+                [key: string]: string;
+            };
             gcp?: Rule.Gcp;
             headers?: Array<Rule.Header>;
             /**
@@ -510,6 +539,11 @@ export interface BoxListParams {
      * Filter by creator identity. Only 'me' is supported.
      */
     created_by?: string;
+    /**
+     * Filter by label. Repeatable; all must match. Use 'key' to match on key presence
+     * or 'key=value' for equality.
+     */
+    label?: Array<string>;
     /**
      * Maximum number of results
      */
@@ -556,6 +590,12 @@ export interface BoxCreateSnapshotParams {
      * snapshots small unless memory restore is explicitly desired.
      */
     include_memory?: boolean;
+    /**
+     * Labels seed the captured snapshot's labels.
+     */
+    labels?: {
+        [key: string]: string;
+    };
 }
 export interface BoxGenerateServiceURLParams {
     expires_in_seconds?: number;

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

@@ -9,33 +9,33 @@ export class Boxes extends APIResource {
      * `snapshot_name`; if neither is provided, the server uses the default snapshot.
      */
     create(body, options) {
-        return this._client.post('/v2/sandboxes/boxes', { body, ...options });
+        return this._client.post('/api/v2/sandboxes/boxes', { body, ...options });
     }
     /**
      * Retrieve a sandbox by name. Stale provisioning sandboxes are auto-failed.
      */
     retrieve(name, options) {
-        return this._client.get(path `/v2/sandboxes/boxes/${name}`, options);
+        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(name, body, options) {
-        return this._client.patch(path `/v2/sandboxes/boxes/${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.
      */
     list(query = {}, options) {
-        return this._client.get('/v2/sandboxes/boxes', { query, ...options });
+        return this._client.get('/api/v2/sandboxes/boxes', { query, ...options });
     }
     /**
      * Delete a sandbox by name or UUID. Tears down the sandbox runtime and removes the
      * DB record.
      */
     delete(name, options) {
-        return this._client.delete(path `/v2/sandboxes/boxes/${name}`, {
+        return this._client.delete(path `/api/v2/sandboxes/boxes/${name}`, {
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });
@@ -45,7 +45,7 @@ export class Boxes extends APIResource {
      * existing checkpoint.
      */
     createSnapshot(name, body, options) {
-        return this._client.post(path `/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
+        return this._client.post(path `/api/v2/sandboxes/boxes/${name}/snapshot`, { body, ...options });
     }
     /**
      * Create a short-lived JWT for accessing an HTTP service running on a specific
@@ -54,26 +54,26 @@ export class Boxes extends APIResource {
      * token, and its expiry.
      */
     generateServiceURL(name, body, options) {
-        return this._client.post(path `/v2/sandboxes/boxes/${name}/service-url`, { body, ...options });
+        return this._client.post(path `/api/v2/sandboxes/boxes/${name}/service-url`, { body, ...options });
     }
     /**
      * Retrieve the lightweight status of a sandbox for polling.
      */
     getStatus(name, options) {
-        return this._client.get(path `/v2/sandboxes/boxes/${name}/status`, options);
+        return this._client.get(path `/api/v2/sandboxes/boxes/${name}/status`, options);
     }
     /**
      * Start a stopped or failed sandbox. This endpoint is not idempotent.
      */
     start(name, options) {
-        return this._client.post(path `/v2/sandboxes/boxes/${name}/start`, options);
+        return this._client.post(path `/api/v2/sandboxes/boxes/${name}/start`, options);
     }
     /**
      * Stop a ready sandbox. This endpoint is not idempotent; the filesystem is
      * preserved for later restart.
      */
     stop(name, options) {
-        return this._client.post(path `/v2/sandboxes/boxes/${name}/stop`, {
+        return this._client.post(path `/api/v2/sandboxes/boxes/${name}/stop`, {
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });

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

@@ -11,31 +11,31 @@ class Registries extends resource_js_1.APIResource {
      * Create a sandbox registry for pulling private images.
      */
     create(body, options) {
-        return this._client.post('/v2/sandboxes/registries', { body, ...options });
+        return this._client.post('/api/v2/sandboxes/registries', { body, ...options });
     }
     /**
      * Get a sandbox registry by name.
      */
     retrieve(name, options) {
-        return this._client.get((0, path_js_1.path) `/v2/sandboxes/registries/${name}`, options);
+        return this._client.get((0, path_js_1.path) `/api/v2/sandboxes/registries/${name}`, options);
     }
     /**
      * Update a sandbox registry's name and/or credentials.
      */
     update(name, body, options) {
-        return this._client.patch((0, path_js_1.path) `/v2/sandboxes/registries/${name}`, { body, ...options });
+        return this._client.patch((0, path_js_1.path) `/api/v2/sandboxes/registries/${name}`, { body, ...options });
     }
     /**
      * List sandbox registries for pulling private images.
      */
     list(query = {}, options) {
-        return this._client.get('/v2/sandboxes/registries', { query, ...options });
+        return this._client.get('/api/v2/sandboxes/registries', { query, ...options });
     }
     /**
      * Delete a sandbox registry by name.
      */
     delete(name, options) {
-        return this._client.delete((0, path_js_1.path) `/v2/sandboxes/registries/${name}`, {
+        return this._client.delete((0, path_js_1.path) `/api/v2/sandboxes/registries/${name}`, {
             ...options,
             headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });

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

@@ -8,31 +8,31 @@ export class Registries extends APIResource {
      * Create a sandbox registry for pulling private images.
      */
     create(body, options) {
-        return this._client.post('/v2/sandboxes/registries', { body, ...options });
+        return this._client.post('/api/v2/sandboxes/registries', { body, ...options });
     }
     /**
      * Get a sandbox registry by name.
      */
     retrieve(name, options) {
-        return this._client.get(path `/v2/sandboxes/registries/${name}`, options);
+        return this._client.get(path `/api/v2/sandboxes/registries/${name}`, options);
     }
     /**
      * Update a sandbox registry's name and/or credentials.
      */
     update(name, body, options) {
-        return this._client.patch(path `/v2/sandboxes/registries/${name}`, { body, ...options });
+        return this._client.patch(path `/api/v2/sandboxes/registries/${name}`, { body, ...options });
     }
     /**
      * List sandbox registries for pulling private images.
      */
     list(query = {}, options) {
-        return this._client.get('/v2/sandboxes/registries', { query, ...options });
+        return this._client.get('/api/v2/sandboxes/registries', { query, ...options });
     }
     /**
      * Delete a sandbox registry by name.
      */
     delete(name, options) {
-        return this._client.delete(path `/v2/sandboxes/registries/${name}`, {
+        return this._client.delete(path `/api/v2/sandboxes/registries/${name}`, {
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });

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

@@ -23,6 +23,9 @@ export interface SandboxResponse {
     delete_after_stop_seconds?: number;
     fs_capacity_bytes?: number;
     idle_ttl_seconds?: number;
+    labels?: {
+        [key: string]: string;
+    };
     mem_bytes?: number;
     mount_config?: SandboxResponse.MountConfig;
     name?: string;
@@ -314,6 +317,17 @@ export declare namespace SandboxResponse {
             name: string;
             aws?: Rule.Aws;
             enabled?: boolean;
+            /**
+             * EnvVars are plaintext env vars set for every command in the sandbox while this
+             * rule is enabled. Use them for tools that refuse to run unless a credential env
+             * var is present (e.g. gh needs GH_TOKEN) even though this rule injects the real
+             * credential on the wire — set a dummy value here so the command starts. Explicit
+             * per-sandbox env_vars win over these, and provider-managed (AWS/GCP) vars win
+             * over both.
+             */
+            env_vars?: {
+                [key: string]: string;
+            };
             gcp?: Rule.Gcp;
             headers?: Array<Rule.Header>;
             /**
@@ -383,6 +397,9 @@ export interface SnapshotResponse {
     fs_capacity_bytes?: number;
     fs_used_bytes?: number;
     image_digest?: string;
+    labels?: {
+        [key: string]: string;
+    };
     /**
      * MemorySnapshotSizeBytes is non-nil iff the snapshot was captured with VM memory
      * state. A non-nil value is the canonical signal that this snapshot can

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

@@ -11,26 +11,26 @@ class Snapshots extends resource_js_1.APIResource {
      * Create a snapshot from a Docker image (async build).
      */
     create(body, options) {
-        return this._client.post('/v2/sandboxes/snapshots', { body, ...options });
+        return this._client.post('/api/v2/sandboxes/snapshots', { body, ...options });
     }
     /**
      * Get a sandbox snapshot by ID.
      */
     retrieve(snapshotID, options) {
-        return this._client.get((0, path_js_1.path) `/v2/sandboxes/snapshots/${snapshotID}`, options);
+        return this._client.get((0, path_js_1.path) `/api/v2/sandboxes/snapshots/${snapshotID}`, options);
     }
     /**
      * List sandbox snapshots for the authenticated tenant, with optional filtering,
      * sorting, and pagination.
      */
     list(query = {}, options) {
-        return this._client.get('/v2/sandboxes/snapshots', { query, ...options });
+        return this._client.get('/api/v2/sandboxes/snapshots', { query, ...options });
     }
     /**
      * Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
      */
     delete(snapshotID, options) {
-        return this._client.delete((0, path_js_1.path) `/v2/sandboxes/snapshots/${snapshotID}`, {
+        return this._client.delete((0, path_js_1.path) `/api/v2/sandboxes/snapshots/${snapshotID}`, {
             ...options,
             headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });

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

@@ -25,6 +25,13 @@ export interface SnapshotCreateParams {
     docker_image: string;
     fs_capacity_bytes: number;
     name: string;
+    /**
+     * Labels seed the snapshot's labels, overriding any label of the same key derived
+     * from the Docker image.
+     */
+    labels?: {
+        [key: string]: string;
+    };
     registry_id?: string;
 }
 export interface SnapshotListParams {
@@ -32,6 +39,11 @@ export interface SnapshotListParams {
      * Filter by creator identity. Only 'me' is supported.
      */
     created_by?: string;
+    /**
+     * Filter by label. Repeatable; all must match. Use 'key' to match on key presence
+     * or 'key=value' for equality.
+     */
+    label?: Array<string>;
     /**
      * Maximum number of results
      */

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

@@ -8,26 +8,26 @@ export class Snapshots extends APIResource {
      * Create a snapshot from a Docker image (async build).
      */
     create(body, options) {
-        return this._client.post('/v2/sandboxes/snapshots', { body, ...options });
+        return this._client.post('/api/v2/sandboxes/snapshots', { body, ...options });
     }
     /**
      * Get a sandbox snapshot by ID.
      */
     retrieve(snapshotID, options) {
-        return this._client.get(path `/v2/sandboxes/snapshots/${snapshotID}`, options);
+        return this._client.get(path `/api/v2/sandboxes/snapshots/${snapshotID}`, options);
     }
     /**
      * List sandbox snapshots for the authenticated tenant, with optional filtering,
      * sorting, and pagination.
      */
     list(query = {}, options) {
-        return this._client.get('/v2/sandboxes/snapshots', { query, ...options });
+        return this._client.get('/api/v2/sandboxes/snapshots', { query, ...options });
     }
     /**
      * Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
      */
     delete(snapshotID, options) {
-        return this._client.delete(path `/v2/sandboxes/snapshots/${snapshotID}`, {
+        return this._client.delete(path `/api/v2/sandboxes/snapshots/${snapshotID}`, {
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });

package/dist/_openapi_client/resources/threads.cjs

@@ -23,7 +23,7 @@ class Threads extends resource_js_1.APIResource {
      * ```
      */
     listTraces(threadID, query, options) {
-        return this._client.getAPIList((0, path_js_1.path) `/v2/threads/${threadID}/traces`, (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
+        return this._client.getAPIList((0, path_js_1.path) `/api/v2/threads/${threadID}/traces`, (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
     }
     /**
      * **Alpha:** The request and response contract may change; Query threads within a
@@ -39,7 +39,7 @@ class Threads extends resource_js_1.APIResource {
      * ```
      */
     query(body, options) {
-        return this._client.getAPIList('/v2/threads/query', (pagination_js_1.ItemsCursorPostPagination), {
+        return this._client.getAPIList('/api/v2/threads/query', (pagination_js_1.ItemsCursorPostPagination), {
             body,
             method: 'post',
             ...options,
@@ -62,7 +62,7 @@ class Threads extends resource_js_1.APIResource {
      * ```
      */
     stats(threadID, query, options) {
-        return this._client.get((0, path_js_1.path) `/v2/threads/${threadID}/stats`, { query, ...options });
+        return this._client.get((0, path_js_1.path) `/api/v2/threads/${threadID}/stats`, { query, ...options });
     }
 }
 exports.Threads = Threads;

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

@@ -554,7 +554,8 @@ export interface ThreadTrace {
      */
     total_tokens?: number;
     /**
-     * `trace_id` is the UUID of this trace (the root run). Always present.
+     * `trace_id` is the UUID of this trace (the root run). Returned when `TRACE_ID` is
+     * in `selects`, or when `selects` is omitted entirely (sole fallback field).
      */
     trace_id?: string;
 }

package/dist/_openapi_client/resources/threads.js

@@ -20,7 +20,7 @@ export class Threads extends APIResource {
      * ```
      */
     listTraces(threadID, query, options) {
-        return this._client.getAPIList(path `/v2/threads/${threadID}/traces`, (ItemsCursorGetPagination), { query, ...options });
+        return this._client.getAPIList(path `/api/v2/threads/${threadID}/traces`, (ItemsCursorGetPagination), { query, ...options });
     }
     /**
      * **Alpha:** The request and response contract may change; Query threads within a
@@ -36,7 +36,7 @@ export class Threads extends APIResource {
      * ```
      */
     query(body, options) {
-        return this._client.getAPIList('/v2/threads/query', (ItemsCursorPostPagination), {
+        return this._client.getAPIList('/api/v2/threads/query', (ItemsCursorPostPagination), {
             body,
             method: 'post',
             ...options,
@@ -59,6 +59,6 @@ export class Threads extends APIResource {
      * ```
      */
     stats(threadID, query, options) {
-        return this._client.get(path `/v2/threads/${threadID}/stats`, { query, ...options });
+        return this._client.get(path `/api/v2/threads/${threadID}/stats`, { query, ...options });
     }
 }

package/dist/_openapi_client/resources/traces.cjs

@@ -23,7 +23,7 @@ class Traces extends resource_js_1.APIResource {
      */
     listRuns(traceID, params, options) {
         const { Accept, ...query } = params;
-        return this._client.get((0, path_js_1.path) `/v2/traces/${traceID}/runs`, {
+        return this._client.get((0, path_js_1.path) `/api/v2/traces/${traceID}/runs`, {
             query,
             ...options,
             headers: (0, headers_js_1.buildHeaders)([{ ...(Accept != null ? { Accept: Accept } : undefined) }, options?.headers]),
@@ -51,7 +51,7 @@ class Traces extends resource_js_1.APIResource {
      * ```
      */
     query(body, options) {
-        return this._client.getAPIList('/v2/traces/query', (pagination_js_1.ItemsCursorPostPagination), {
+        return this._client.getAPIList('/api/v2/traces/query', (pagination_js_1.ItemsCursorPostPagination), {
             body,
             method: 'post',
             ...options,