langsmith 0.5.22 → 0.5.24

package/dist/client.d.ts

@@ -1,6 +1,7 @@
 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, TimeDelta, TracerSession, TracerSessionResult, ValueType, AnnotationQueue, RunWithAnnotationQueueInfo, Attachments, UploadExamplesResponse, UpdateExamplesResponse, DatasetVersion, AnnotationQueueWithDetails, AnnotationQueueRubricItem, FeedbackConfigSchema } 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, TimeDelta, TracerSession, TracerSessionResult, ValueType, AnnotationQueue, RunWithAnnotationQueueInfo, Attachments, UploadExamplesResponse, UpdateExamplesResponse, DatasetVersion, AnnotationQueueWithDetails, AnnotationQueueRubricItem, FeedbackConfigSchema, AgentContext, SkillContext, Entry } from "./schemas.js";
+import { type TracingMode } from "./utils/env.js";
 import { EvaluationResult, EvaluationResults } from "./evaluation/evaluator.js";
 import { PromptCache } from "./utils/prompt_cache/index.js";
 export interface ClientConfig {
@@ -56,6 +57,17 @@ export interface ClientConfig {
      * By default, prompt caching is enabled globally.
      */
     disablePromptCache?: boolean;
+    /**
+     * Where to send traces.  One of:
+     *
+     * - `"langsmith"` (default) — LangSmith REST API only.
+     * - `"otel"` — OpenTelemetry export only.
+     *
+     * Falls back to the `LANGSMITH_TRACING_MODE` env var, then to the
+     * legacy `OTEL_ENABLED` / `LANGSMITH_OTEL_ENABLED` env vars, then to
+     * `"langsmith"`.
+     */
+    tracingMode?: TracingMode;
     /**
      * Additional HTTP headers to include in all requests.
      * These headers will be merged with the default headers (User-Agent,
@@ -414,11 +426,37 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _serverInfo;
     private _getServerInfoPromise?;
     private manualFlushMode;
+    private _serializeWorker?;
+    /**
+     * Tracks in-flight drainAutoBatchQueue promises so awaitPendingTraceBatches
+     * can wait on them even if the flush involves async work (worker-thread
+     * serialize) that hasn't yet registered with batchIngestCaller.queue.
+     */
+    private _pendingDrains;
     private langSmithToOTELTranslator?;
+    private _tracingMode;
+    get tracingMode(): TracingMode;
     private fetchImplementation?;
     private cachedLSEnvVarsForMetadata?;
     private _promptCache?;
     private get _fetch();
+    /**
+     * Serialize a payload for tracing, optionally offloading the work to a
+     * Node worker thread when LANGSMITH_PERF_OPTIMIZATION=true and the runtime
+     * supports worker_threads.
+     *
+     * Falls back to synchronous serialization when:
+     *  - the perf flag is off
+     *  - manualFlushMode is enabled (serverless: worker boot cost > benefit)
+     *  - worker_threads is unavailable (non-Node runtimes)
+     *  - the payload contains values that can't be structured-cloned across
+     *    threads (functions, non-cloneable class instances, streams, etc.)
+     *  - the worker throws for any other reason
+     *
+     * In all fallback cases the returned bytes are identical to the sync path.
+     */
+    private _trackDrain;
+    private _serializeBody;
     private multipartStreamingDisabled;
     private _multipartDisabled;
     private _runCompressionDisabled;
@@ -1306,6 +1344,83 @@ export declare class Client implements LangSmithTracingClientInterface {
         tags?: string[];
         commitDescription?: string;
     }): Promise<string>;
+    /**
+     * Check if an agent repo exists.
+     */
+    agentExists(identifier: string): Promise<boolean>;
+    /**
+     * Check if a skill repo exists.
+     */
+    skillExists(identifier: string): Promise<boolean>;
+    /**
+     * Pull an agent directory from Hub.
+     * @param identifier The identifier (owner/name[:version]).
+     * @param options.version Commit hash or tag; overrides identifier's version.
+     */
+    pullAgent(identifier: string, options?: {
+        version?: string;
+    }): Promise<AgentContext>;
+    /**
+     * Pull a skill directory from Hub.
+     */
+    pullSkill(identifier: string, options?: {
+        version?: string;
+    }): Promise<SkillContext>;
+    /**
+     * Push an agent to Hub. Creates the repo if missing, patches metadata if
+     * provided, then commits the given files.
+     * @returns The URL of the resulting commit.
+     */
+    pushAgent(identifier: string, options: {
+        files: Record<string, Entry | null>;
+        parentCommit?: string;
+        description?: string;
+        readme?: string;
+        tags?: string[];
+        isPublic?: boolean;
+    }): Promise<string>;
+    /**
+     * Push a skill to Hub.
+     */
+    pushSkill(identifier: string, options: {
+        files: Record<string, Entry | null>;
+        parentCommit?: string;
+        description?: string;
+        readme?: string;
+        tags?: string[];
+        isPublic?: boolean;
+    }): Promise<string>;
+    /**
+     * Delete an agent and all its owned child file repos.
+     */
+    deleteAgent(identifier: string): Promise<void>;
+    /**
+     * Delete a skill and all its owned child file repos.
+     */
+    deleteSkill(identifier: string): Promise<void>;
+    /**
+     * List agent repos. Yields one at a time, auto-paginating.
+     */
+    listAgents(options?: {
+        isPublic?: boolean;
+        isArchived?: boolean;
+        query?: string;
+    }): AsyncIterableIterator<Prompt>;
+    /**
+     * List skill repos. Yields one at a time, auto-paginating.
+     */
+    listSkills(options?: {
+        isPublic?: boolean;
+        isArchived?: boolean;
+        query?: string;
+    }): AsyncIterableIterator<Prompt>;
+    private _listReposByType;
+    private _pullDirectory;
+    private _pushDirectory;
+    private _deleteDirectory;
+    private _repoExists;
+    private _createRepo;
+    private _updateRepoMetadata;
     /**
      * Clone a public dataset to your own langsmith tenant.
      * This operation is idempotent. If you already have a dataset with the given name,