langsmith 0.7.7 → 0.7.9

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

@@ -0,0 +1,82 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { path } from '../../internal/utils/path.js';
+export class Boxes extends APIResource {
+    /**
+     * Create a new sandbox from a snapshot. Provide at most one of `snapshot_id` or
+     * `snapshot_name`; if neither is provided, the server uses the default static
+     * blueprint.
+     */
+    create(body, options) {
+        return this._client.post('/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);
+    }
+    /**
+     * 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 });
+    }
+    /**
+     * List sandboxes for the authenticated tenant, with optional filtering, sorting,
+     * and pagination.
+     */
+    list(query = {}, options) {
+        return this._client.get('/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}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Create a snapshot by capturing the current state of a sandbox or promoting an
+     * existing checkpoint.
+     */
+    createSnapshot(name, body, options) {
+        return this._client.post(path `/v2/sandboxes/boxes/${name}/snapshot`, { 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
+     * service_url (for use with the X-Langsmith-Sandbox-Service-Token header), the raw
+     * token, and its expiry.
+     */
+    generateServiceURL(name, body, options) {
+        return this._client.post(path `/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);
+    }
+    /**
+     * 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);
+    }
+    /**
+     * 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`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}

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

@@ -0,0 +1,63 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sandboxes = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const BoxesAPI = __importStar(require("./boxes.cjs"));
+const boxes_js_1 = require("./boxes.cjs");
+const SnapshotsAPI = __importStar(require("./snapshots.cjs"));
+const snapshots_js_1 = require("./snapshots.cjs");
+class Sandboxes extends resource_js_1.APIResource {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "boxes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new BoxesAPI.Boxes(this._client)
+        });
+        Object.defineProperty(this, "snapshots", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new SnapshotsAPI.Snapshots(this._client)
+        });
+    }
+}
+exports.Sandboxes = Sandboxes;
+Sandboxes.Boxes = boxes_js_1.Boxes;
+Sandboxes.Snapshots = snapshots_js_1.Snapshots;

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

@@ -0,0 +1,13 @@
+import { APIResource } from '../../core/resource.js';
+import * as BoxesAPI from './boxes.js';
+import { BoxCreateParams, BoxCreateResponse, BoxCreateSnapshotParams, BoxCreateSnapshotResponse, BoxGenerateServiceURLParams, BoxGenerateServiceURLResponse, BoxGetStatusResponse, BoxListParams, BoxListResponse, BoxRetrieveResponse, BoxStartResponse, BoxUpdateParams, BoxUpdateResponse, Boxes } from './boxes.js';
+import * as SnapshotsAPI from './snapshots.js';
+import { SnapshotCreateParams, SnapshotCreateResponse, SnapshotListParams, SnapshotListResponse, SnapshotRetrieveResponse, Snapshots } from './snapshots.js';
+export declare class Sandboxes extends APIResource {
+    boxes: BoxesAPI.Boxes;
+    snapshots: SnapshotsAPI.Snapshots;
+}
+export declare namespace Sandboxes {
+    export { Boxes as Boxes, type BoxCreateResponse as BoxCreateResponse, type BoxRetrieveResponse as BoxRetrieveResponse, type BoxUpdateResponse as BoxUpdateResponse, type BoxListResponse as BoxListResponse, type BoxCreateSnapshotResponse as BoxCreateSnapshotResponse, type BoxGenerateServiceURLResponse as BoxGenerateServiceURLResponse, type BoxGetStatusResponse as BoxGetStatusResponse, type BoxStartResponse as BoxStartResponse, type BoxCreateParams as BoxCreateParams, type BoxUpdateParams as BoxUpdateParams, type BoxListParams as BoxListParams, type BoxCreateSnapshotParams as BoxCreateSnapshotParams, type BoxGenerateServiceURLParams as BoxGenerateServiceURLParams, };
+    export { Snapshots as Snapshots, type SnapshotCreateResponse as SnapshotCreateResponse, type SnapshotRetrieveResponse as SnapshotRetrieveResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotCreateParams as SnapshotCreateParams, type SnapshotListParams as SnapshotListParams, };
+}

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

@@ -0,0 +1,26 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import * as BoxesAPI from './boxes.js';
+import { Boxes, } from './boxes.js';
+import * as SnapshotsAPI from './snapshots.js';
+import { Snapshots, } from './snapshots.js';
+export class Sandboxes extends APIResource {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "boxes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new BoxesAPI.Boxes(this._client)
+        });
+        Object.defineProperty(this, "snapshots", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new SnapshotsAPI.Snapshots(this._client)
+        });
+    }
+}
+Sandboxes.Boxes = Boxes;
+Sandboxes.Snapshots = Snapshots;

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

@@ -0,0 +1,39 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Snapshots = void 0;
+const resource_js_1 = require("../../core/resource.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 {
+    /**
+     * Create a snapshot from a Docker image (async build).
+     */
+    create(body, options) {
+        return this._client.post('/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);
+    }
+    /**
+     * 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 });
+    }
+    /**
+     * 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}`, {
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Snapshots = Snapshots;

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

@@ -0,0 +1,130 @@
+import { APIResource } from '../../core/resource.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Snapshots extends APIResource {
+    /**
+     * Create a snapshot from a Docker image (async build).
+     */
+    create(body: SnapshotCreateParams, options?: RequestOptions): APIPromise<SnapshotCreateResponse>;
+    /**
+     * Get a sandbox snapshot by ID.
+     */
+    retrieve(snapshotID: string, options?: RequestOptions): APIPromise<SnapshotRetrieveResponse>;
+    /**
+     * List sandbox snapshots for the authenticated tenant, with optional filtering,
+     * sorting, and pagination.
+     */
+    list(query?: SnapshotListParams | null | undefined, options?: RequestOptions): APIPromise<SnapshotListResponse>;
+    /**
+     * Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
+     */
+    delete(snapshotID: string, options?: RequestOptions): APIPromise<void>;
+}
+export interface SnapshotCreateResponse {
+    id?: string;
+    created_at?: string;
+    created_by?: string;
+    docker_image?: string;
+    fs_capacity_bytes?: number;
+    fs_used_bytes?: number;
+    image_digest?: 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
+     * warm-restore from memory; nil means rootfs only.
+     */
+    memory_snapshot_size_bytes?: number;
+    name?: string;
+    registry_id?: string;
+    source_sandbox_id?: string;
+    status?: string;
+    status_message?: string;
+    updated_at?: string;
+}
+export interface SnapshotRetrieveResponse {
+    id?: string;
+    created_at?: string;
+    created_by?: string;
+    docker_image?: string;
+    fs_capacity_bytes?: number;
+    fs_used_bytes?: number;
+    image_digest?: 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
+     * warm-restore from memory; nil means rootfs only.
+     */
+    memory_snapshot_size_bytes?: number;
+    name?: string;
+    registry_id?: string;
+    source_sandbox_id?: string;
+    status?: string;
+    status_message?: string;
+    updated_at?: string;
+}
+export interface SnapshotListResponse {
+    offset?: number;
+    snapshots?: Array<SnapshotListResponse.Snapshot>;
+}
+export declare namespace SnapshotListResponse {
+    interface Snapshot {
+        id?: string;
+        created_at?: string;
+        created_by?: string;
+        docker_image?: string;
+        fs_capacity_bytes?: number;
+        fs_used_bytes?: number;
+        image_digest?: 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
+         * warm-restore from memory; nil means rootfs only.
+         */
+        memory_snapshot_size_bytes?: number;
+        name?: string;
+        registry_id?: string;
+        source_sandbox_id?: string;
+        status?: string;
+        status_message?: string;
+        updated_at?: string;
+    }
+}
+export interface SnapshotCreateParams {
+    docker_image: string;
+    fs_capacity_bytes: number;
+    name: string;
+    registry_id?: string;
+}
+export interface SnapshotListParams {
+    /**
+     * Filter by creator identity. Only 'me' is supported.
+     */
+    created_by?: string;
+    /**
+     * Maximum number of results
+     */
+    limit?: number;
+    /**
+     * Filter by name substring
+     */
+    name_contains?: string;
+    /**
+     * Pagination offset
+     */
+    offset?: number;
+    /**
+     * Sort column (name, status, created_at)
+     */
+    sort_by?: string;
+    /**
+     * Sort direction (asc, desc)
+     */
+    sort_direction?: string;
+    /**
+     * Filter by status (building, ready, failed, deleting)
+     */
+    status?: string;
+}
+export declare namespace Snapshots {
+    export { type SnapshotCreateResponse as SnapshotCreateResponse, type SnapshotRetrieveResponse as SnapshotRetrieveResponse, type SnapshotListResponse as SnapshotListResponse, type SnapshotCreateParams as SnapshotCreateParams, type SnapshotListParams as SnapshotListParams, };
+}

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

@@ -0,0 +1,35 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { path } from '../../internal/utils/path.js';
+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 });
+    }
+    /**
+     * Get a sandbox snapshot by ID.
+     */
+    retrieve(snapshotID, options) {
+        return this._client.get(path `/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 });
+    }
+    /**
+     * Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
+     */
+    delete(snapshotID, options) {
+        return this._client.delete(path `/v2/sandboxes/snapshots/${snapshotID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}

package/dist/_openapi_client/resources/sessions/insights.cjs

@@ -0,0 +1,54 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Insights = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const pagination_js_1 = require("../../core/pagination.cjs");
+const path_js_1 = require("../../internal/utils/path.cjs");
+class Insights extends resource_js_1.APIResource {
+    /**
+     * Create an insights job.
+     */
+    create(sessionID, body, options) {
+        return this._client.post((0, path_js_1.path) `/api/v1/sessions/${sessionID}/insights`, { body, ...options });
+    }
+    /**
+     * Update a session cluster job.
+     */
+    update(jobID, params, options) {
+        const { session_id, ...body } = params;
+        return this._client.patch((0, path_js_1.path) `/api/v1/sessions/${session_id}/insights/${jobID}`, { body, ...options });
+    }
+    /**
+     * Get all clusters for a session.
+     */
+    list(sessionID, query = {}, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/api/v1/sessions/${sessionID}/insights`, (pagination_js_1.OffsetPaginationInsightsClusteringJobs), { query, ...options });
+    }
+    /**
+     * Delete a session cluster job.
+     */
+    delete(jobID, params, options) {
+        const { session_id } = params;
+        return this._client.delete((0, path_js_1.path) `/api/v1/sessions/${session_id}/insights/${jobID}`, options);
+    }
+    /**
+     * Get a specific cluster job for a session.
+     */
+    retrieveJob(jobID, params, options) {
+        const { session_id } = params;
+        return this._client.get((0, path_js_1.path) `/api/v1/sessions/${session_id}/insights/${jobID}`, options);
+    }
+    /**
+     * Get all runs for a cluster job, optionally filtered by cluster.
+     */
+    retrieveRuns(jobID, params, options) {
+        const { session_id, ...query } = params;
+        return this._client.get((0, path_js_1.path) `/api/v1/sessions/${session_id}/insights/${jobID}/runs`, {
+            query,
+            ...options,
+        });
+    }
+}
+exports.Insights = Insights;