langsmith 0.7.7 → 0.7.9

package/dist/_openapi_client/resources/sessions/insights.d.ts

@@ -0,0 +1,246 @@
+import { APIResource } from '../../core/resource.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { OffsetPaginationInsightsClusteringJobs, type OffsetPaginationInsightsClusteringJobsParams, PagePromise } from '../../core/pagination.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Insights extends APIResource {
+    /**
+     * Create an insights job.
+     */
+    create(sessionID: string, body: InsightCreateParams, options?: RequestOptions): APIPromise<InsightCreateResponse>;
+    /**
+     * Update a session cluster job.
+     */
+    update(jobID: string, params: InsightUpdateParams, options?: RequestOptions): APIPromise<InsightUpdateResponse>;
+    /**
+     * Get all clusters for a session.
+     */
+    list(sessionID: string, query?: InsightListParams | null | undefined, options?: RequestOptions): PagePromise<InsightListResponsesOffsetPaginationInsightsClusteringJobs, InsightListResponse>;
+    /**
+     * Delete a session cluster job.
+     */
+    delete(jobID: string, params: InsightDeleteParams, options?: RequestOptions): APIPromise<InsightDeleteResponse>;
+    /**
+     * Get a specific cluster job for a session.
+     */
+    retrieveJob(jobID: string, params: InsightRetrieveJobParams, options?: RequestOptions): APIPromise<InsightRetrieveJobResponse>;
+    /**
+     * Get all runs for a cluster job, optionally filtered by cluster.
+     */
+    retrieveRuns(jobID: string, params: InsightRetrieveRunsParams, options?: RequestOptions): APIPromise<InsightRetrieveRunsResponse>;
+}
+export type InsightListResponsesOffsetPaginationInsightsClusteringJobs = OffsetPaginationInsightsClusteringJobs<InsightListResponse>;
+/**
+ * Request to create a run clustering job.
+ */
+export interface CreateRunClusteringJobRequest {
+    attribute_schemas?: {
+        [key: string]: unknown;
+    } | null;
+    cluster_model?: string | null;
+    config_id?: string | null;
+    end_time?: string | null;
+    filter?: string | null;
+    hierarchy?: Array<number> | null;
+    is_scheduled?: boolean;
+    last_n_hours?: number | null;
+    model?: 'openai' | 'anthropic';
+    name?: string | null;
+    partitions?: {
+        [key: string]: string;
+    } | null;
+    sample?: number | null;
+    start_time?: string | null;
+    summary_model?: string | null;
+    summary_prompt?: string | null;
+    user_context?: {
+        [key: string]: string;
+    } | null;
+    validate_model_secrets?: boolean;
+}
+/**
+ * Response to creating a run clustering job.
+ */
+export interface InsightCreateResponse {
+    id: string;
+    name: string;
+    status: string;
+    error?: string | null;
+}
+/**
+ * Response to update a session cluster job.
+ */
+export interface InsightUpdateResponse {
+    name: string;
+    status: string;
+}
+/**
+ * Session cluster job
+ */
+export interface InsightListResponse {
+    id: string;
+    created_at: string;
+    name: string;
+    status: string;
+    config_id?: string | null;
+    end_time?: string | null;
+    error?: string | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    shape?: {
+        [key: string]: number;
+    } | null;
+    start_time?: string | null;
+}
+/**
+ * Response to delete a session cluster job.
+ */
+export interface InsightDeleteResponse {
+    id: string;
+    message: string;
+}
+/**
+ * Response to get a specific cluster job for a session.
+ */
+export interface InsightRetrieveJobResponse {
+    id: string;
+    clusters: Array<InsightRetrieveJobResponse.Cluster>;
+    created_at: string;
+    name: string;
+    status: string;
+    config_id?: string | null;
+    end_time?: string | null;
+    error?: string | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * High level summary of an insights job that pulls out patterns and specific
+     * traces.
+     */
+    report?: InsightRetrieveJobResponse.Report | null;
+    shape?: {
+        [key: string]: number;
+    } | null;
+    start_time?: string | null;
+}
+export declare namespace InsightRetrieveJobResponse {
+    /**
+     * A single cluster of runs.
+     */
+    interface Cluster {
+        id: string;
+        description: string;
+        level: number;
+        name: string;
+        num_runs: number;
+        stats: {
+            [key: string]: unknown;
+        } | null;
+        parent_id?: string | null;
+        parent_name?: string | null;
+    }
+    /**
+     * High level summary of an insights job that pulls out patterns and specific
+     * traces.
+     */
+    interface Report {
+        created_at?: string | null;
+        highlighted_traces?: Array<Report.HighlightedTrace>;
+        key_points?: Array<string>;
+        title?: string | null;
+    }
+    namespace Report {
+        /**
+         * A trace highlighted in an insights report summary. Up to 10 per insights job.
+         */
+        interface HighlightedTrace {
+            highlight_reason: string;
+            rank: number;
+            run_id: string;
+            cluster_id?: string | null;
+            cluster_name?: string | null;
+            summary?: string | null;
+        }
+    }
+}
+export interface InsightRetrieveRunsResponse {
+    offset: number | null;
+    runs: Array<{
+        [key: string]: unknown;
+    }>;
+}
+export interface InsightCreateParams {
+    attribute_schemas?: {
+        [key: string]: unknown;
+    } | null;
+    cluster_model?: string | null;
+    config_id?: string | null;
+    end_time?: string | null;
+    filter?: string | null;
+    hierarchy?: Array<number> | null;
+    is_scheduled?: boolean;
+    last_n_hours?: number | null;
+    model?: 'openai' | 'anthropic';
+    name?: string | null;
+    partitions?: {
+        [key: string]: string;
+    } | null;
+    sample?: number | null;
+    start_time?: string | null;
+    summary_model?: string | null;
+    summary_prompt?: string | null;
+    user_context?: {
+        [key: string]: string;
+    } | null;
+    validate_model_secrets?: boolean;
+}
+export interface InsightUpdateParams {
+    /**
+     * Path param
+     */
+    session_id: string;
+    /**
+     * Body param
+     */
+    name: string;
+}
+export interface InsightListParams extends OffsetPaginationInsightsClusteringJobsParams {
+    config_id?: string | null;
+    legacy?: boolean | null;
+}
+export interface InsightDeleteParams {
+    session_id: string;
+}
+export interface InsightRetrieveJobParams {
+    session_id: string;
+}
+export interface InsightRetrieveRunsParams {
+    /**
+     * Path param
+     */
+    session_id: string;
+    /**
+     * Query param
+     */
+    attribute_sort_key?: string | null;
+    /**
+     * Query param
+     */
+    attribute_sort_order?: 'asc' | 'desc' | null;
+    /**
+     * Query param
+     */
+    cluster_id?: string | null;
+    /**
+     * Query param
+     */
+    limit?: number;
+    /**
+     * Query param
+     */
+    offset?: number;
+}
+export declare namespace Insights {
+    export { type CreateRunClusteringJobRequest as CreateRunClusteringJobRequest, type InsightCreateResponse as InsightCreateResponse, type InsightUpdateResponse as InsightUpdateResponse, type InsightListResponse as InsightListResponse, type InsightDeleteResponse as InsightDeleteResponse, type InsightRetrieveJobResponse as InsightRetrieveJobResponse, type InsightRetrieveRunsResponse as InsightRetrieveRunsResponse, type InsightListResponsesOffsetPaginationInsightsClusteringJobs as InsightListResponsesOffsetPaginationInsightsClusteringJobs, type InsightCreateParams as InsightCreateParams, type InsightUpdateParams as InsightUpdateParams, type InsightListParams as InsightListParams, type InsightDeleteParams as InsightDeleteParams, type InsightRetrieveJobParams as InsightRetrieveJobParams, type InsightRetrieveRunsParams as InsightRetrieveRunsParams, };
+}

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

@@ -0,0 +1,50 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { OffsetPaginationInsightsClusteringJobs, } from '../../core/pagination.js';
+import { path } from '../../internal/utils/path.js';
+export class Insights extends APIResource {
+    /**
+     * Create an insights job.
+     */
+    create(sessionID, body, options) {
+        return this._client.post(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(path `/api/v1/sessions/${session_id}/insights/${jobID}`, { body, ...options });
+    }
+    /**
+     * Get all clusters for a session.
+     */
+    list(sessionID, query = {}, options) {
+        return this._client.getAPIList(path `/api/v1/sessions/${sessionID}/insights`, (OffsetPaginationInsightsClusteringJobs), { query, ...options });
+    }
+    /**
+     * Delete a session cluster job.
+     */
+    delete(jobID, params, options) {
+        const { session_id } = params;
+        return this._client.delete(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(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(path `/api/v1/sessions/${session_id}/insights/${jobID}/runs`, {
+            query,
+            ...options,
+        });
+    }
+}

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

@@ -0,0 +1,109 @@
+"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.Sessions = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const InsightsAPI = __importStar(require("./insights.cjs"));
+const insights_js_1 = require("./insights.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 Sessions extends resource_js_1.APIResource {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "insights", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new InsightsAPI.Insights(this._client)
+        });
+    }
+    /**
+     * Create a new session.
+     */
+    create(params, options) {
+        const { upsert, ...body } = params;
+        return this._client.post('/api/v1/sessions', { query: { upsert }, body, ...options });
+    }
+    /**
+     * Get a specific session.
+     */
+    retrieve(sessionID, params = {}, options) {
+        const { accept, ...query } = params ?? {};
+        return this._client.get((0, path_js_1.path) `/api/v1/sessions/${sessionID}`, {
+            query,
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ ...(accept != null ? { accept: accept } : undefined) }, options?.headers]),
+        });
+    }
+    /**
+     * Update a session.
+     */
+    update(sessionID, body, options) {
+        return this._client.patch((0, path_js_1.path) `/api/v1/sessions/${sessionID}`, { body, ...options });
+    }
+    /**
+     * Get all sessions.
+     */
+    list(params = {}, options) {
+        const { accept, ...query } = params ?? {};
+        return this._client.getAPIList('/api/v1/sessions', (pagination_js_1.OffsetPaginationTopLevelArray), {
+            query,
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ ...(accept != null ? { accept: accept } : undefined) }, options?.headers]),
+        });
+    }
+    /**
+     * Delete a specific session.
+     */
+    delete(sessionID, options) {
+        return this._client.delete((0, path_js_1.path) `/api/v1/sessions/${sessionID}`, options);
+    }
+    /**
+     * Get a prebuilt dashboard for a tracing project.
+     */
+    dashboard(sessionID, params, options) {
+        const { accept, ...body } = params;
+        return this._client.post((0, path_js_1.path) `/api/v1/sessions/${sessionID}/dashboard`, {
+            body,
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ ...(accept != null ? { accept: accept } : undefined) }, options?.headers]),
+        });
+    }
+}
+exports.Sessions = Sessions;
+Sessions.Insights = insights_js_1.Insights;