@nocobase/plugin-ai 1.9.33 → 1.9.34

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/client.d.ts

@@ -1,5 +1,6 @@
+import type { OTELContext } from "./experimental/otel/types.js";
 import { AsyncCallerParams } from "./utils/async_caller.js";
-import { ComparativeExperiment, DataType, Dataset, DatasetDiffInfo, DatasetShareSchema, Example, ExampleCreate, ExampleUpdate, ExampleUpdateWithoutId, Feedback, FeedbackConfig, FeedbackIngestToken, KVMap, LangChainBaseMessage, LangSmithSettings, LikePromptResponse, Prompt, PromptCommit, PromptSortField, Run, RunCreate, RunUpdate, ScoreType, ExampleSearch, TimeDelta, TracerSession, TracerSessionResult, ValueType, AnnotationQueue, RunWithAnnotationQueueInfo, Attachments, UploadExamplesResponse, UpdateExamplesResponse, DatasetVersion } from "./schemas.js";
+import { ComparativeExperiment, DataType, Dataset, DatasetDiffInfo, DatasetShareSchema, Example, ExampleCreate, ExampleUpdate, ExampleUpdateWithoutId, Feedback, FeedbackConfig, FeedbackIngestToken, KVMap, LangChainBaseMessage, LangSmithSettings, LikePromptResponse, Prompt, PromptCommit, PromptSortField, Run, RunCreate, RunUpdate, ScoreType, ExampleSearch, TimeDelta, TracerSession, TracerSessionResult, ValueType, AnnotationQueue, RunWithAnnotationQueueInfo, Attachments, UploadExamplesResponse, UpdateExamplesResponse, DatasetVersion, AnnotationQueueWithDetails } from "./schemas.js";
 import { EvaluationResult, EvaluationResults, RunEvaluator } from "./evaluation/evaluator.js";
 export interface ClientConfig {
     apiUrl?: string;
@@ -7,11 +8,14 @@ export interface ClientConfig {
     callerOptions?: AsyncCallerParams;
     timeout_ms?: number;
     webUrl?: string;
-    anonymizer?: (values: KVMap) => KVMap;
-    hideInputs?: boolean | ((inputs: KVMap) => KVMap);
-    hideOutputs?: boolean | ((outputs: KVMap) => KVMap);
+    anonymizer?: (values: KVMap) => KVMap | Promise<KVMap>;
+    hideInputs?: boolean | ((inputs: KVMap) => KVMap | Promise<KVMap>);
+    hideOutputs?: boolean | ((outputs: KVMap) => KVMap | Promise<KVMap>);
     autoBatchTracing?: boolean;
+    /** Maximum size of a batch of runs in bytes. */
     batchSizeBytesLimit?: number;
+    /** Maximum number of operations to batch in a single request. */
+    batchSizeLimit?: number;
     blockOnRootRunFinalization?: boolean;
     traceBatchConcurrency?: number;
     fetchOptions?: RequestInit;
@@ -20,6 +24,19 @@ export interface ClientConfig {
      * Useful if encountering network rate limits at trace high volumes.
      */
     manualFlushMode?: boolean;
+    tracingSamplingRate?: number;
+    /**
+     * Enable debug mode for the client. If set, all sent HTTP requests will be logged.
+     */
+    debug?: boolean;
+    /**
+     * The workspace ID. Required for org-scoped API keys.
+     */
+    workspaceId?: string;
+    /**
+     * Custom fetch implementation. Useful for testing.
+     */
+    fetchImplementation?: typeof fetch;
 }
 /**
  * Represents the parameters for listing runs (spans) from the Langsmith server.
@@ -49,6 +66,10 @@ interface ListRunsParams {
      * The ID of the parent run to filter by.
      */
     parentRunId?: string;
+    /**
+     * The order by run start date
+     */
+    order?: "asc" | "desc";
     /**
      * The ID of the reference example to filter by.
      */
@@ -110,9 +131,62 @@ interface ListRunsParams {
     treeFilter?: string;
     /**
      * The values to include in the response.
+     *
+     * Note: The 'child_run_ids' value is deprecated and will be removed in a future version.
+     * This field is no longer populated by the API.
      */
     select?: string[];
 }
+interface GroupRunsParams {
+    /**
+     * The ID or IDs of the project(s) to filter by.
+     */
+    projectId?: string;
+    /**
+     * The ID or IDs of the project(s) to filter by.
+     */
+    projectName?: string;
+    /**
+     * @example "conversation"
+     */
+    groupBy: string;
+    /**
+     * The filter string to apply.
+     *
+     * Run Filtering:
+     * Listing runs with query params is useful for simple queries, but doesn't support many common needs, such as filtering by metadata, tags, or other fields.
+     * LangSmith supports a filter query language to permit more complex filtering operations when fetching runs. This guide will provide a high level overview of the grammar as well as a few examples of when it can be useful.
+     * If you'd prefer a more visual guide, you can get a taste of the language by viewing the table of runs on any of your projects' pages. We provide some recommended filters to get you started that you can copy and use the SDK.
+     *
+     * Grammar:
+     * The filtering grammar is based on common comparators on fields in the run object. Supported comparators include:
+     * - gte (greater than or equal to)
+     * - gt (greater than)
+     * - lte (less than or equal to)
+     * - lt (less than)
+     * - eq (equal to)
+     * - neq (not equal to)
+     * - has (check if run contains a tag or metadata json blob)
+     * - search (search for a substring in a string field)
+     */
+    filter?: string;
+    /**
+     * The start time to filter by.
+     */
+    startTime?: Date;
+    /**
+     * The end time to filter by.
+     */
+    endTime?: Date;
+    /**
+     * The maximum number of runs to retrieve.
+     */
+    limit?: number;
+    /**
+     * The maximum number of runs to retrieve.
+     */
+    offset?: number;
+}
 interface UploadCSVParams {
     csvFile: Blob;
     fileName: string;
@@ -127,8 +201,8 @@ interface CreateRunParams {
     inputs: KVMap;
     run_type: string;
     id?: string;
-    start_time?: number;
-    end_time?: number;
+    start_time?: number | string;
+    end_time?: number | string;
     extra?: KVMap;
     error?: string;
     serialized?: object;
@@ -181,32 +255,60 @@ export type CreateProjectParams = {
 type AutoBatchQueueItem = {
     action: "create" | "update";
     item: RunCreate | RunUpdate;
+    otelContext?: OTELContext;
+    apiKey?: string;
+    apiUrl?: string;
 };
-export declare function mergeRuntimeEnvIntoRunCreate(run: RunCreate): RunCreate;
+type Thread = {
+    filter: string;
+    count: number;
+    total_tokens: number;
+    total_cost: number | null;
+    min_start_time: string;
+    max_start_time: string;
+    latency_p50: number;
+    latency_p99: number;
+    feedback_stats: any | null;
+    group_key: string;
+    first_inputs: string;
+    last_outputs: string;
+    last_error: string | null;
+};
+export declare function mergeRuntimeEnvIntoRun<T extends RunCreate | RunUpdate>(run: T, cachedEnvVars?: Record<string, string>): T;
 export declare class AutoBatchQueue {
     items: {
         action: "create" | "update";
         payload: RunCreate | RunUpdate;
+        otelContext?: OTELContext;
         itemPromiseResolve: () => void;
         itemPromise: Promise<void>;
         size: number;
+        apiKey?: string;
+        apiUrl?: string;
     }[];
     sizeBytes: number;
     peek(): {
         action: "create" | "update";
         payload: RunCreate | RunUpdate;
+        otelContext?: OTELContext;
         itemPromiseResolve: () => void;
         itemPromise: Promise<void>;
         size: number;
+        apiKey?: string;
+        apiUrl?: string;
     };
     push(item: AutoBatchQueueItem): Promise<void>;
-    pop(upToSizeBytes: number): [AutoBatchQueueItem[], () => void];
+    pop({ upToSizeBytes, upToSize, }: {
+        upToSizeBytes: number;
+        upToSize: number;
+    }): [AutoBatchQueueItem[], () => void];
 }
-export declare const DEFAULT_BATCH_SIZE_LIMIT_BYTES = 20971520;
+export declare const DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES: number;
 export declare class Client implements LangSmithTracingClientInterface {
     private apiKey?;
     private apiUrl;
     private webUrl?;
+    private workspaceId?;
     private caller;
     private batchIngestCaller;
     private timeout_ms;
@@ -220,6 +322,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     private autoBatchTimeout;
     private autoBatchAggregationDelayMs;
     private batchSizeBytesLimit?;
+    private batchSizeLimit?;
     private fetchOptions;
     private settings;
     private blockOnRootRunFinalization;
@@ -227,6 +330,12 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _serverInfo;
     private _getServerInfoPromise?;
     private manualFlushMode;
+    private langSmithToOTELTranslator?;
+    private fetchImplementation?;
+    private cachedLSEnvVarsForMetadata?;
+    private get _fetch();
+    private multipartStreamingDisabled;
+    debug: boolean;
     constructor(config?: ClientConfig);
     static getDefaultClientConfig(): {
         apiUrl: string;
@@ -237,6 +346,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     };
     getHostUrl(): string;
     private get headers();
+    private _getPlatformEndpointPath;
     private processInputs;
     private processOutputs;
     private prepareRunCreateOrUpdateInputs;
@@ -244,11 +354,17 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _get;
     private _getPaginated;
     private _getCursorPaginatedList;
+    private _shouldSample;
     private _filterForSampling;
     private _getBatchSizeLimitBytes;
-    private _getMultiPartSupport;
+    /**
+     * Get the maximum number of operations to batch in a single request.
+     */
+    private _getBatchSizeLimit;
+    private _getDatasetExamplesMultiPartSupport;
     private drainAutoBatchQueue;
     private _processBatch;
+    private _sendBatchToOTELTranslator;
     private processRunOperation;
     protected _getServerInfo(): Promise<any>;
     protected _ensureServerInfo(): Promise<Record<string, any>>;
@@ -257,7 +373,12 @@ export declare class Client implements LangSmithTracingClientInterface {
      * Flushes current queued traces.
      */
     flush(): Promise<void>;
-    createRun(run: CreateRunParams): Promise<void>;
+    private _cloneCurrentOTELContext;
+    createRun(run: CreateRunParams, options?: {
+        apiKey?: string;
+        apiUrl?: string;
+        workspaceId?: string;
+    }): Promise<void>;
     /**
      * Batch ingest/upsert multiple runs in the Langsmith system.
      * @param runs
@@ -265,6 +386,9 @@ export declare class Client implements LangSmithTracingClientInterface {
     batchIngestRuns({ runCreates, runUpdates, }: {
         runCreates?: RunCreate[];
         runUpdates?: RunUpdate[];
+    }, options?: {
+        apiKey?: string;
+        apiUrl?: string;
     }): Promise<void>;
     private _postBatchIngestRuns;
     /**
@@ -274,9 +398,19 @@ export declare class Client implements LangSmithTracingClientInterface {
     multipartIngestRuns({ runCreates, runUpdates, }: {
         runCreates?: RunCreate[];
         runUpdates?: RunUpdate[];
+    }, options?: {
+        apiKey?: string;
+        apiUrl?: string;
+        useGzip?: boolean;
     }): Promise<void>;
+    private _createNodeFetchBody;
+    private _createMultipartStream;
     private _sendMultipartRequest;
-    updateRun(runId: string, run: RunUpdate): Promise<void>;
+    updateRun(runId: string, run: RunUpdate, options?: {
+        apiKey?: string;
+        apiUrl?: string;
+        workspaceId?: string;
+    }): Promise<void>;
     readRun(runId: string, { loadChildRuns }?: {
         loadChildRuns: boolean;
     }): Promise<Run>;
@@ -369,6 +503,7 @@ export declare class Client implements LangSmithTracingClientInterface {
      * });
      */
     listRuns(props: ListRunsParams): AsyncIterable<Run>;
+    listGroupRuns(props: GroupRunsParams): AsyncIterable<Thread>;
     getRunStats({ id, trace, parentRun, runType, projectNames, projectIds, referenceExampleIds, startTime, endTime, error, query, filter, traceFilter, treeFilter, isRoot, dataSourceType, }: {
         id?: string[];
         trace?: string;
@@ -436,15 +571,17 @@ export declare class Client implements LangSmithTracingClientInterface {
         datasetName?: string;
     }): Promise<string>;
     private _getTenantId;
-    listProjects({ projectIds, name, nameContains, referenceDatasetId, referenceDatasetName, referenceFree, metadata, }?: {
+    listProjects({ projectIds, name, nameContains, referenceDatasetId, referenceDatasetName, includeStats, datasetVersion, referenceFree, metadata, }?: {
         projectIds?: string[];
         name?: string;
         nameContains?: string;
         referenceDatasetId?: string;
         referenceDatasetName?: string;
+        includeStats?: boolean;
+        datasetVersion?: string;
         referenceFree?: boolean;
         metadata?: RecordStringAny;
-    }): AsyncIterable<TracerSession>;
+    }): AsyncIterable<TracerSessionResult>;
     deleteProject({ projectId, projectName, }: {
         projectId?: string;
         projectName?: string;
@@ -736,13 +873,14 @@ export declare class Client implements LangSmithTracingClientInterface {
         name: string;
         description?: string;
         queueId?: string;
-    }): Promise<AnnotationQueue>;
+        rubricInstructions?: string;
+    }): Promise<AnnotationQueueWithDetails>;
     /**
      * Read an annotation queue with the specified queue ID.
      * @param queueId - The ID of the annotation queue to read
-     * @returns The AnnotationQueue object
+     * @returns The AnnotationQueueWithDetails object
      */
-    readAnnotationQueue(queueId: string): Promise<AnnotationQueue>;
+    readAnnotationQueue(queueId: string): Promise<AnnotationQueueWithDetails>;
     /**
      * Update an annotation queue with the specified queue ID.
      * @param queueId - The ID of the annotation queue to update
@@ -753,6 +891,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     updateAnnotationQueue(queueId: string, options: {
         name: string;
         description?: string;
+        rubricInstructions?: string;
     }): Promise<void>;
     /**
      * Delete an annotation queue with the specified queue ID.
@@ -890,7 +1029,7 @@ export declare class Client implements LangSmithTracingClientInterface {
      *
      * @returns A promise that resolves once all currently pending traces have sent.
      */
-    awaitPendingTraceBatches(): Promise<void> | Promise<[...void[], void]>;
+    awaitPendingTraceBatches(): Promise<void>;
 }
 export interface LangSmithTracingClientInterface {
     createRun: (run: CreateRunParams) => Promise<void>;