langsmith 0.10.7 → 0.10.9

package/dist/_openapi_client/resources/sessions.js

@@ -0,0 +1,19 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../core/resource.js';
+export class Sessions extends APIResource {
+    /**
+     * **Beta:** This endpoint is in active development and may change without notice.
+     * Returns the tracing project (session) an address names. An address is an AGENT
+     * (`id` and `environment`), an EXPERIMENT (`id`), or an EVALUATOR (no `id`:
+     * evaluator traces share one project per workspace). Send `kind` and `environment`
+     * in upper case, as listed; they are matched case-insensitively, while the Agent
+     * `id` is case-sensitive. An address that does not exist, or whose project you
+     * cannot read, is a 404. Pass the returned `session_id` to any endpoint that takes
+     * a project (session) ID. This is not supported on a BYOC data plane yet, and is a
+     * 501 there.
+     */
+    resolve(query, options) {
+        return this._client.get('/api/v1/sessions/resolutions', { query, ...options });
+    }
+}

package/dist/_openapi_client/resources/threads/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Threads = exports.Share = void 0;
+var share_js_1 = require("./share.cjs");
+Object.defineProperty(exports, "Share", { enumerable: true, get: function () { return share_js_1.Share; } });
+var threads_js_1 = require("./threads.cjs");
+Object.defineProperty(exports, "Threads", { enumerable: true, get: function () { return threads_js_1.Threads; } });

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

@@ -0,0 +1,2 @@
+export { Share, type ShareCreateResponse, type ShareRetrieveResponse, type ShareCreateParams, type ShareRetrieveParams, type ShareDeleteParams, } from './share.js';
+export { Threads, type Thread, type ThreadStats, type ThreadTrace, type ThreadAggregateStatsResponse, type ThreadAggregateStatsParams, type ThreadListTracesParams, type ThreadQueryParams, type ThreadStatsParams, type ThreadTracesItemsCursorGetPagination, type ThreadsItemsCursorPostPagination, } from './threads.js';

package/dist/_openapi_client/resources/threads/index.js

@@ -0,0 +1,4 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Share, } from './share.js';
+export { Threads, } from './threads.js';

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

@@ -0,0 +1,61 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Share = 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 Share extends resource_js_1.APIResource {
+    /**
+     * Mints a public share token for a thread. Idempotent: sharing an already-shared
+     * thread returns the existing token.
+     *
+     * @example
+     * ```ts
+     * const share = await client.threads.share.create(
+     *   'thread_id',
+     *   { project_id: '018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327' },
+     * );
+     * ```
+     */
+    create(threadID, body, options) {
+        return this._client.post((0, path_js_1.path) `/api/v2/threads/${threadID}/share`, { body, ...options });
+    }
+    /**
+     * Returns the share token for a thread. The token is omitted when the thread is
+     * not shared. Gated on runs:share so the control's state matches the control's
+     * permission.
+     *
+     * @example
+     * ```ts
+     * const share = await client.threads.share.retrieve(
+     *   'thread_id',
+     *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * );
+     * ```
+     */
+    retrieve(threadID, query, options) {
+        return this._client.get((0, path_js_1.path) `/api/v2/threads/${threadID}/share`, { query, ...options });
+    }
+    /**
+     * Deletes the share token for a thread. Idempotent: returns 204 whether or not a
+     * share token existed. Deliberately does not verify the thread still exists.
+     *
+     * @example
+     * ```ts
+     * await client.threads.share.delete('thread_id', {
+     *   project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * });
+     * ```
+     */
+    delete(threadID, params, options) {
+        const { project_id } = params;
+        return this._client.delete((0, path_js_1.path) `/api/v2/threads/${threadID}/share`, {
+            query: { project_id },
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Share = Share;

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

@@ -0,0 +1,71 @@
+import { APIResource } from '../../core/resource.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Share extends APIResource {
+    /**
+     * Mints a public share token for a thread. Idempotent: sharing an already-shared
+     * thread returns the existing token.
+     *
+     * @example
+     * ```ts
+     * const share = await client.threads.share.create(
+     *   'thread_id',
+     *   { project_id: '018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327' },
+     * );
+     * ```
+     */
+    create(threadID: string, body: ShareCreateParams, options?: RequestOptions): APIPromise<ShareCreateResponse>;
+    /**
+     * Returns the share token for a thread. The token is omitted when the thread is
+     * not shared. Gated on runs:share so the control's state matches the control's
+     * permission.
+     *
+     * @example
+     * ```ts
+     * const share = await client.threads.share.retrieve(
+     *   'thread_id',
+     *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * );
+     * ```
+     */
+    retrieve(threadID: string, query: ShareRetrieveParams, options?: RequestOptions): APIPromise<ShareRetrieveResponse>;
+    /**
+     * Deletes the share token for a thread. Idempotent: returns 204 whether or not a
+     * share token existed. Deliberately does not verify the thread still exists.
+     *
+     * @example
+     * ```ts
+     * await client.threads.share.delete('thread_id', {
+     *   project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * });
+     * ```
+     */
+    delete(threadID: string, params: ShareDeleteParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface ShareCreateResponse {
+    share_token?: string;
+}
+export interface ShareRetrieveResponse {
+    share_token?: string;
+}
+export interface ShareCreateParams {
+    /**
+     * project_id is the tracing project UUID containing the thread.
+     */
+    project_id: string;
+}
+export interface ShareRetrieveParams {
+    /**
+     * Project UUID
+     */
+    project_id: string;
+}
+export interface ShareDeleteParams {
+    /**
+     * Project UUID
+     */
+    project_id: string;
+}
+export declare namespace Share {
+    export { type ShareCreateResponse as ShareCreateResponse, type ShareRetrieveResponse as ShareRetrieveResponse, type ShareCreateParams as ShareCreateParams, type ShareRetrieveParams as ShareRetrieveParams, type ShareDeleteParams as ShareDeleteParams, };
+}

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

@@ -0,0 +1,57 @@
+// @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 Share extends APIResource {
+    /**
+     * Mints a public share token for a thread. Idempotent: sharing an already-shared
+     * thread returns the existing token.
+     *
+     * @example
+     * ```ts
+     * const share = await client.threads.share.create(
+     *   'thread_id',
+     *   { project_id: '018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327' },
+     * );
+     * ```
+     */
+    create(threadID, body, options) {
+        return this._client.post(path `/api/v2/threads/${threadID}/share`, { body, ...options });
+    }
+    /**
+     * Returns the share token for a thread. The token is omitted when the thread is
+     * not shared. Gated on runs:share so the control's state matches the control's
+     * permission.
+     *
+     * @example
+     * ```ts
+     * const share = await client.threads.share.retrieve(
+     *   'thread_id',
+     *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * );
+     * ```
+     */
+    retrieve(threadID, query, options) {
+        return this._client.get(path `/api/v2/threads/${threadID}/share`, { query, ...options });
+    }
+    /**
+     * Deletes the share token for a thread. Idempotent: returns 204 whether or not a
+     * share token existed. Deliberately does not verify the thread still exists.
+     *
+     * @example
+     * ```ts
+     * await client.threads.share.delete('thread_id', {
+     *   project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * });
+     * ```
+     */
+    delete(threadID, params, options) {
+        const { project_id } = params;
+        return this._client.delete(path `/api/v2/threads/${threadID}/share`, {
+            query: { project_id },
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}

package/dist/_openapi_client/resources/threads/threads.cjs

@@ -0,0 +1,143 @@
+"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.Threads = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const ShareAPI = __importStar(require("./share.cjs"));
+const share_js_1 = require("./share.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 Threads extends resource_js_1.APIResource {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "share", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new ShareAPI.Share(this._client)
+        });
+    }
+    /**
+     * GET with body payload — no resources created. Returns aggregate statistics for
+     * threads in a tracing project. The response includes the thread counts, run
+     * counts, latency percentiles, rates, token totals, and cost totals requested in
+     * `select`.
+     *
+     * Self-hosted deployments require LangSmith `v0.17` or later.
+     *
+     * @example
+     * ```ts
+     * const response = await client.threads.aggregateStats({
+     *   project_id: '0190a1b2-c3d4-7ef0-a5b6-6ea3a82e9328',
+     *   select: [
+     *     'THREAD_COUNT',
+     *     'TRACE_COUNT',
+     *     'TOTAL_TOKENS',
+     *     'TOTAL_COST',
+     *   ],
+     * });
+     * ```
+     */
+    aggregateStats(body, options) {
+        return this._client.post('/api/v2/threads/stats', { body, ...options });
+    }
+    /**
+     * Retrieve all traces belonging to a specific thread within a project.
+     *
+     * Self-hosted deployments require LangSmith `v0.16` or later.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const threadTrace of client.threads.listTraces(
+     *   'thread_id',
+     *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTraces(threadID, query, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/api/v2/threads/${threadID}/traces`, (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
+    }
+    /**
+     * Query threads within a project (session), with cursor-based pagination. Returns
+     * threads matching the given time range and optional filters.
+     *
+     * Self-hosted deployments require LangSmith `v0.16` or later.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const thread of client.threads.query()) {
+     *   // ...
+     * }
+     * ```
+     */
+    query(params, options) {
+        const { Accept, ...body } = params;
+        return this._client.getAPIList('/api/v2/threads/query', (pagination_js_1.ItemsCursorPostPagination), {
+            body,
+            method: 'post',
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ ...(Accept != null ? { Accept: Accept } : undefined) }, options?.headers]),
+        });
+    }
+    /**
+     * Compute aggregate stats for a single thread (turn count, latency percentiles,
+     * token/cost sums, and detail breakdowns) within a project.
+     *
+     * Self-hosted deployments require LangSmith `v0.16` or later.
+     *
+     * @example
+     * ```ts
+     * const threadStats = await client.threads.stats(
+     *   'thread_id',
+     *   {
+     *     selects: ['TURNS'],
+     *     session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   },
+     * );
+     * ```
+     */
+    stats(threadID, query, options) {
+        return this._client.get((0, path_js_1.path) `/api/v2/threads/${threadID}/stats`, { query, ...options });
+    }
+}
+exports.Threads = Threads;
+Threads.Share = share_js_1.Share;