langsmith 0.10.7 → 0.10.9

package/dist/_openapi_client/resources/product-feedback.d.ts

@@ -0,0 +1,77 @@
+import { APIResource } from '../core/resource.js';
+import { APIPromise } from '../core/api-promise.js';
+import { RequestOptions } from '../internal/request-options.js';
+export declare class ProductFeedback extends APIResource {
+    /**
+     * **Alpha:** This endpoint is in active development and may change without notice.
+     *
+     * Submits concise product feedback with optional non-sensitive client details.
+     */
+    create(params: ProductFeedbackCreateParams, options?: RequestOptions): APIPromise<ProductFeedbackCreateResponse>;
+    /**
+     * **Alpha:** This endpoint is in active development and may change without notice.
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<ProductFeedbackRetrieveResponse>;
+}
+export interface ProductFeedbackCreateResponse {
+    id: string;
+    category: 'BUG' | 'FEATURE_REQUEST' | 'USABILITY' | 'DOCUMENTATION' | 'OTHER';
+    created_at: string;
+    message: string;
+    source: 'LANGSMITH_CLI';
+    client?: ProductFeedbackCreateResponse.Client;
+}
+export declare namespace ProductFeedbackCreateResponse {
+    interface Client {
+        architecture?: string;
+        os?: string;
+        version?: string;
+    }
+}
+export interface ProductFeedbackRetrieveResponse {
+    id: string;
+    category: 'BUG' | 'FEATURE_REQUEST' | 'USABILITY' | 'DOCUMENTATION' | 'OTHER';
+    created_at: string;
+    message: string;
+    source: 'LANGSMITH_CLI';
+    client?: ProductFeedbackRetrieveResponse.Client;
+}
+export declare namespace ProductFeedbackRetrieveResponse {
+    interface Client {
+        architecture?: string;
+        os?: string;
+        version?: string;
+    }
+}
+export interface ProductFeedbackCreateParams {
+    /**
+     * Body param
+     */
+    category: 'BUG' | 'FEATURE_REQUEST' | 'USABILITY' | 'DOCUMENTATION' | 'OTHER';
+    /**
+     * Body param
+     */
+    message: string;
+    /**
+     * Body param
+     */
+    source: 'LANGSMITH_CLI';
+    /**
+     * Body param
+     */
+    client?: ProductFeedbackCreateParams.Client;
+    /**
+     * Header param: Idempotency key
+     */
+    'Idempotency-Key'?: string;
+}
+export declare namespace ProductFeedbackCreateParams {
+    interface Client {
+        architecture?: string;
+        os?: string;
+        version?: string;
+    }
+}
+export declare namespace ProductFeedback {
+    export { type ProductFeedbackCreateResponse as ProductFeedbackCreateResponse, type ProductFeedbackRetrieveResponse as ProductFeedbackRetrieveResponse, type ProductFeedbackCreateParams as ProductFeedbackCreateParams, };
+}

package/dist/_openapi_client/resources/product-feedback.js

@@ -0,0 +1,29 @@
+// @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 ProductFeedback extends APIResource {
+    /**
+     * **Alpha:** This endpoint is in active development and may change without notice.
+     *
+     * Submits concise product feedback with optional non-sensitive client details.
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/api/v1/platform/product-feedbacks', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * **Alpha:** This endpoint is in active development and may change without notice.
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/api/v1/platform/product-feedbacks/${id}`, options);
+    }
+}

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

@@ -1,4 +1,5 @@
 import { APIResource } from '../../core/resource.js';
+import * as SessionsAPI from '../sessions.js';
 import * as ShareAPI from './share.js';
 import { Share, ShareCreateParams, ShareCreateResponse, ShareDeleteParams } from './share.js';
 import { APIPromise } from '../../core/api-promise.js';
@@ -164,6 +165,12 @@ export interface Run {
      * `latency_seconds` is wall-clock duration from start to end in seconds.
      */
     latency_seconds?: number;
+    /**
+     * `ls_user_id` identifies the LangSmith user whose credential traced the run. It
+     * is absent for runs traced with a service-account API key, which has no
+     * associated user.
+     */
+    ls_user_id?: string;
     /**
      * `manifest` is the serialized configuration of the traced component (for example
      * the model parameters, prompt template, or pipeline definition), when recorded.
@@ -226,6 +233,12 @@ export interface Run {
      * `prompt_tokens` is the prompt-side token count.
      */
     prompt_tokens?: number;
+    /**
+     * `query_metadata` describes this query result, including `sem_filter_score` when
+     * a semantic filter is used. Returned automatically by run queries, or null when
+     * unavailable.
+     */
+    query_metadata?: unknown | null;
     /**
      * `reference_dataset_id` is the dataset UUID for the reference example, if any.
      */
@@ -427,6 +440,13 @@ export declare namespace Run {
 }
 export interface RunIngest {
     id?: string;
+    /**
+     * Beta. Addresses the run to an Agent environment in place of session_id or
+     * session_name, as lrn:agents/{id}/environments/{environment}. The environment is
+     * case-insensitive. Only workspaces enabled for Agent addressing accept it; others
+     * get a 403.
+     */
+    address?: string;
     dotted_order?: string;
     end_time?: string;
     error?: string;
@@ -555,7 +575,7 @@ 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' | 'LAST_QUEUED_AT' | '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' | 'LS_USER_ID';
 /**
  * Query params for run stats.
  */
@@ -573,7 +593,7 @@ export interface RunStatsQueryParams {
     /**
      * Group by param for run stats.
      */
-    group_by?: RunStatsQueryParams.GroupBy | null;
+    group_by?: SessionsAPI.RunStatsGroupBy | null;
     groups?: Array<string | null> | null;
     include_details?: boolean;
     is_root?: boolean | null;
@@ -598,16 +618,6 @@ export interface RunStatsQueryParams {
     tree_filter?: string | null;
     use_experimental_search?: boolean;
 }
-export declare namespace RunStatsQueryParams {
-    /**
-     * Group by param for run stats.
-     */
-    interface GroupBy {
-        attribute: 'name' | 'run_type' | 'tag' | 'metadata';
-        max_groups?: number;
-        path?: string | null;
-    }
-}
 export type RunType = 'TOOL' | 'CHAIN' | 'LLM' | 'RETRIEVER' | 'EMBEDDING' | 'PROMPT' | 'PARSER';
 /**
  * Enum for run types.
@@ -721,7 +731,7 @@ export interface RunQueryV2Params extends ItemsCursorPostPaginationParams {
      */
     tree_filter?: string;
     /**
-     * Header param: application/json
+     * Header param: application/json or text/event-stream
      */
     Accept?: string;
 }
@@ -735,7 +745,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' | 'LAST_QUEUED_AT' | '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' | 'LS_USER_ID'>;
     /**
      * Query param: `start_time` is the run's `start_time` (RFC3339 date-time).
      * Providing it speeds up retrieval.
@@ -756,7 +766,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' | 'LAST_QUEUED_AT' | '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' | 'LS_USER_ID'>;
     /**
      * Query param: `start_time` is the run's `start_time` (RFC3339 date-time).
      * Providing it speeds up retrieval.
@@ -854,7 +864,7 @@ export interface RunQueryParams extends ItemsCursorPostPaginationParams {
      */
     tree_filter?: string;
     /**
-     * Header param: application/json
+     * Header param: application/json or text/event-stream
      */
     Accept?: string;
 }

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

@@ -58,13 +58,41 @@ 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 });
     }
+    /**
+     * Removes the sharing grant for one port, or for every port when port is omitted.
+     * A LangSmith login URL stops working immediately. A previously minted service
+     * token is not revoked and stays valid until it expires, but no new one can be
+     * issued from the removed grant.
+     */
+    deleteServiceURL(name, params = {}, options) {
+        const { port } = params ?? {};
+        return this._client.delete((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/service-urls`, {
+            query: { port },
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
     /**
      * 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.
+     * the file path, the response content type and disposition, and the sandbox flags,
+     * so a link cannot be repointed at another file or served under a weaker policy.
+     * The file is always served with a Content-Security-Policy: a sandbox directive,
+     * plus a default-src holding every fetch to the file's own download host and a set
+     * of pre-approved third-party origins. csp_sandbox_flags may loosen the sandbox
+     * with allow-downloads, allow-forms, allow-modals, allow-orientation-lock,
+     * allow-pointer-lock, allow-popups, allow-presentation, allow-same-origin,
+     * allow-scripts, or allow-top-navigation-by-user-activation. Every file is served
+     * from its own host, derived from the sandbox and the path, so allow-same-origin
+     * gives a page localStorage and IndexedDB that no other file can read, and
+     * re-minting a link for the same file keeps them. csp_sandbox set to false drops
+     * the sandbox directive altogether, and csp_sandbox_flags must then be omitted.
+     * csp_source_bundles selects the third-party origins: cdnjs, google-fonts,
+     * jsdelivr, and unpkg are all allowed when the field is omitted, 'none' holds the
+     * file to its own host, and 'any' sends no default-src at all. 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 });
@@ -73,7 +101,10 @@ class Boxes extends resource_js_1.APIResource {
      * 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.
+     * token, and its expiry. Set access=restricted|workspace to instead enable durable
+     * LangSmith login (no token; users authenticate with their normal LangSmith
+     * session), or access=off to disable it. LangSmith login and token access are
+     * mutually exclusive per service URL.
      */
     generateServiceURL(name, body, options) {
         return this._client.post((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/service-url`, { body, ...options });
@@ -84,6 +115,15 @@ class Boxes extends resource_js_1.APIResource {
     getStatus(name, options) {
         return this._client.get((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/status`, options);
     }
+    /**
+     * Returns one entry per port the sandbox is currently reachable on, so a caller
+     * can see what is shared before turning it off. Expired token grants are omitted.
+     * Cursors are opaque and only valid on this endpoint; do not parse or construct
+     * one.
+     */
+    listServiceURLs(name, query = {}, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/api/v2/sandboxes/boxes/${name}/service-urls`, (pagination_js_1.ItemsCursorGetPagination), { query, ...options });
+    }
     /**
      * Start a stopped or failed sandbox. This endpoint is not idempotent.
      */