langsmith 0.10.11 → 0.10.13

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.10.13](https://github.com/langchain-ai/langsmith-javascript/compare/v0.10.12...v0.10.13) (2026-10-13)
+
+
+### Bug Fixes
+
+* cover all brace-expansion security patch lines ([#45](https://github.com/langchain-ai/langsmith-javascript/issues/45)) ([2c36f4e](https://github.com/langchain-ai/langsmith-javascript/commit/2c36f4e3ecbefc84632cb1a1fd7947a97cce36eb))
+* **sdk:** merge AddressApi with Address to ensure easier serialization ([#47](https://github.com/langchain-ai/langsmith-javascript/issues/47)) ([7a46bea](https://github.com/langchain-ai/langsmith-javascript/commit/7a46bea0378aecbe01249a156e12477027897b9a))
+
+## [0.10.12](https://github.com/langchain-ai/langsmith-javascript/compare/v0.10.11...v0.10.12) (2026-10-13)
+
+
+### Features
+
+* **runs:** add ai_search field and SSE streaming to query endpoints ([da3a95b](https://github.com/langchain-ai/langsmith-javascript/commit/da3a95bae3be74e8fe7af80ec84bfb1f893391e8))
+* **sandbox:** accept any JOSE asymmetric algorithm chosen by the JWKS key ([#46](https://github.com/langchain-ai/langsmith-javascript/issues/46)) ([988b7d1](https://github.com/langchain-ai/langsmith-javascript/commit/988b7d1366200930621092198919dad69e157bd9))
+* **sandboxes:** add encryption spec and cache/encryption mount variants ([6047b3c](https://github.com/langchain-ai/langsmith-javascript/commit/6047b3c2500b0291a8bb6b8492a15a243198790c))
+* **webhooks:** add test_webhook_destination endpoint ([a5c70fd](https://github.com/langchain-ai/langsmith-javascript/commit/a5c70fdb5fac90901a20b2a45a5dc1c43ec71ca9))
+
+
+### Bug Fixes
+
+* bump vulnerable transitive dependencies ([#43](https://github.com/langchain-ai/langsmith-javascript/issues/43)) ([caa8c27](https://github.com/langchain-ai/langsmith-javascript/commit/caa8c2747356093843f8a57f5ea08fdaed92e9b9))
+
+
+### Chores
+
+* move sandbox auth options to the bottom of README.md ([#44](https://github.com/langchain-ai/langsmith-javascript/issues/44)) ([d2d2a42](https://github.com/langchain-ai/langsmith-javascript/commit/d2d2a422166c5221df830f841e2ba6cedcc75b40))
+
 ## [0.10.11](https://github.com/langchain-ai/langsmith-javascript/compare/v0.10.10...v0.10.11) (2026-10-09)
 
 

package/README.md

@@ -25,204 +25,6 @@ A typical workflow looks like:
 
 We'll walk through these steps in more detail below.
 
-## Sandbox AWS Auth Proxy
-
-When sandbox code needs to call AWS services, use the sandbox AWS auth proxy.
-The proxy keeps the real AWS credentials outside the sandbox and signs supported
-AWS HTTPS requests with SigV4, so code in the sandbox can use AWS SDKs normally
-without storing long-lived AWS keys in files, environment variables, shell
-history, or logs.
-
-Store AWS credentials as LangSmith workspace secrets using names that make sense
-for your workspace. Then create the sandbox with an AWS auth proxy config:
-
-```ts
-import { SandboxClient, awsAuth, proxyConfig, workspaceSecret } from 'langsmith/sandbox';
-
-const client = new SandboxClient();
-const authConfig = proxyConfig({
-  rules: [
-    awsAuth({
-      accessKeyId: workspaceSecret('SANDBOX_AWS_ACCESS_KEY_ID'),
-      secretAccessKey: workspaceSecret('SANDBOX_AWS_SECRET_ACCESS_KEY'),
-    }),
-  ],
-});
-
-const sandbox = await client.createSandbox({
-  name: 'aws-sandbox',
-  proxyConfig: authConfig,
-});
-
-try {
-  const result = await sandbox.run('node your-aws-script.js');
-  console.log(result.stdout);
-} finally {
-  await sandbox.delete();
-}
-```
-
-Use `opaqueSecret("...")` instead of `workspaceSecret(...)` when your application
-needs to pass short-lived write-only AWS credentials at sandbox creation time.
-Plaintext AWS credential values are not accepted directly; wrap them as
-`opaqueSecret(...)` values.
-
-## Sandbox GCP Auth Proxy
-
-When sandbox code needs to call Google APIs, use the sandbox GCP auth proxy.
-The proxy keeps the service account JSON outside the sandbox and injects OAuth
-bearer tokens for Google API hosts matched automatically by the sandbox proxy.
-
-Store the service account JSON as a LangSmith workspace secret. Then create the
-sandbox with a GCP auth proxy config:
-
-```ts
-import { SandboxClient, gcpAuth, proxyConfig, workspaceSecret } from 'langsmith/sandbox';
-
-const client = new SandboxClient();
-const authConfig = proxyConfig({
-  rules: [
-    gcpAuth({
-      serviceAccountJson: workspaceSecret('SANDBOX_GCP_SERVICE_ACCOUNT_JSON'),
-      scopes: ['https://www.googleapis.com/auth/devstorage.read_write'],
-    }),
-  ],
-});
-
-const sandbox = await client.createSandbox({
-  name: 'gcp-sandbox',
-  proxyConfig: authConfig,
-});
-
-try {
-  const result = await sandbox.run('node your-gcp-script.js');
-  console.log(result.stdout);
-} finally {
-  await sandbox.delete();
-}
-```
-
-Use `opaqueSecret("...")` for short-lived write-only service account JSON.
-Plaintext service account JSON is not accepted directly.
-
-## Sandbox Mounts
-
-When you create a LangSmith sandbox that needs filesystem access to external
-data such as object storage buckets or public Git repositories, pass a
-`mountConfig` on sandbox creation. Mount specs contain only the mount target.
-Provider credentials stay in `mountConfig.auth`; the backend expands them into
-runtime proxy auth rules. You can also pass `proxyConfig` for non-mount proxy
-behavior such as custom headers, callbacks, access control, and generic egress
-rules. Explicit AWS/GCP proxy auth rules conflict with `mountConfig` auth for
-the same provider.
-
-S3 mounts require AWS auth:
-
-```ts
-import { awsAuth, mountConfig, s3Mount, workspaceSecret } from 'langsmith/sandbox';
-
-const mountCfg = mountConfig({
-  auth: [
-    awsAuth({
-      accessKeyId: workspaceSecret('SANDBOX_AWS_ACCESS_KEY_ID'),
-      secretAccessKey: workspaceSecret('SANDBOX_AWS_SECRET_ACCESS_KEY'),
-    }),
-  ],
-  mounts: [
-    s3Mount({
-      id: 'customer_data',
-      mountPath: '/mnt/mounts/customer-data',
-      bucket: 'example-bucket',
-      prefix: 'datasets/customer-data',
-      region: 'us-east-1',
-      endpointUrl: 'https://s3.amazonaws.com',
-      pathStyle: false,
-      readOnly: false,
-    }),
-  ],
-});
-
-const sandbox = await client.createSandbox({
-  name: 's3-mount-sandbox',
-  mountConfig: mountCfg,
-});
-
-try {
-  const result = await sandbox.run('ls /mnt/mounts/customer-data');
-  console.log(result.stdout);
-} finally {
-  await sandbox.delete();
-}
-```
-
-GCS mounts require GCP auth:
-
-```ts
-import { gcpAuth, gcsMount, mountConfig, workspaceSecret } from 'langsmith/sandbox';
-
-const mountCfg = mountConfig({
-  auth: [
-    gcpAuth({
-      serviceAccountJson: workspaceSecret('SANDBOX_GCP_SERVICE_ACCOUNT_JSON'),
-    }),
-  ],
-  mounts: [
-    gcsMount({
-      id: 'customer_data',
-      mountPath: '/mnt/mounts/customer-data',
-      bucket: 'example-bucket',
-      prefix: 'datasets/customer-data',
-    }),
-  ],
-});
-
-const sandbox = await client.createSandbox({
-  name: 'gcs-mount-sandbox',
-  mountConfig: mountCfg,
-});
-
-try {
-  const result = await sandbox.run('ls /mnt/mounts/customer-data');
-  console.log(result.stdout);
-} finally {
-  await sandbox.delete();
-}
-```
-
-Public Git mounts do not require AWS or GCP auth:
-
-```ts
-import { gitMount, mountConfig } from 'langsmith/sandbox';
-
-const mountCfg = mountConfig({
-  mounts: [
-    gitMount({
-      id: 'repo',
-      mountPath: '/mnt/repo',
-      remoteUrl: 'https://github.com/langchain-ai/langsmith-javascript.git',
-      ref: { type: 'branch', name: 'main' },
-      refreshIntervalSeconds: 60,
-    }),
-  ],
-});
-
-const sandbox = await client.createSandbox({
-  name: 'git-mount-sandbox',
-  mountConfig: mountCfg,
-});
-
-try {
-  const result = await sandbox.run('ls /mnt/repo');
-  console.log(result.stdout);
-} finally {
-  await sandbox.delete();
-}
-```
-
-Private Git repositories can use low-level `proxyConfig` rules when the remote
-requires proxy-managed auth. There is not yet a high-level private Git auth
-helper.
-
 ## 1. Connect to LangSmith
 
 Sign up for [LangSmith](https://smith.langchain.com/) using your GitHub, Discord accounts, or an email address and password. If you sign up with an email, make sure to verify your email address before logging in.
@@ -1030,6 +832,204 @@ const client = new Langsmith({
 });
 ```
 
+### Sandbox AWS Auth Proxy
+
+When sandbox code needs to call AWS services, use the sandbox AWS auth proxy.
+The proxy keeps the real AWS credentials outside the sandbox and signs supported
+AWS HTTPS requests with SigV4, so code in the sandbox can use AWS SDKs normally
+without storing long-lived AWS keys in files, environment variables, shell
+history, or logs.
+
+Store AWS credentials as LangSmith workspace secrets using names that make sense
+for your workspace. Then create the sandbox with an AWS auth proxy config:
+
+```ts
+import { SandboxClient, awsAuth, proxyConfig, workspaceSecret } from 'langsmith/sandbox';
+
+const client = new SandboxClient();
+const authConfig = proxyConfig({
+  rules: [
+    awsAuth({
+      accessKeyId: workspaceSecret('SANDBOX_AWS_ACCESS_KEY_ID'),
+      secretAccessKey: workspaceSecret('SANDBOX_AWS_SECRET_ACCESS_KEY'),
+    }),
+  ],
+});
+
+const sandbox = await client.createSandbox({
+  name: 'aws-sandbox',
+  proxyConfig: authConfig,
+});
+
+try {
+  const result = await sandbox.run('node your-aws-script.js');
+  console.log(result.stdout);
+} finally {
+  await sandbox.delete();
+}
+```
+
+Use `opaqueSecret("...")` instead of `workspaceSecret(...)` when your application
+needs to pass short-lived write-only AWS credentials at sandbox creation time.
+Plaintext AWS credential values are not accepted directly; wrap them as
+`opaqueSecret(...)` values.
+
+### Sandbox GCP Auth Proxy
+
+When sandbox code needs to call Google APIs, use the sandbox GCP auth proxy.
+The proxy keeps the service account JSON outside the sandbox and injects OAuth
+bearer tokens for Google API hosts matched automatically by the sandbox proxy.
+
+Store the service account JSON as a LangSmith workspace secret. Then create the
+sandbox with a GCP auth proxy config:
+
+```ts
+import { SandboxClient, gcpAuth, proxyConfig, workspaceSecret } from 'langsmith/sandbox';
+
+const client = new SandboxClient();
+const authConfig = proxyConfig({
+  rules: [
+    gcpAuth({
+      serviceAccountJson: workspaceSecret('SANDBOX_GCP_SERVICE_ACCOUNT_JSON'),
+      scopes: ['https://www.googleapis.com/auth/devstorage.read_write'],
+    }),
+  ],
+});
+
+const sandbox = await client.createSandbox({
+  name: 'gcp-sandbox',
+  proxyConfig: authConfig,
+});
+
+try {
+  const result = await sandbox.run('node your-gcp-script.js');
+  console.log(result.stdout);
+} finally {
+  await sandbox.delete();
+}
+```
+
+Use `opaqueSecret("...")` for short-lived write-only service account JSON.
+Plaintext service account JSON is not accepted directly.
+
+### Sandbox Mounts
+
+When you create a LangSmith sandbox that needs filesystem access to external
+data such as object storage buckets or public Git repositories, pass a
+`mountConfig` on sandbox creation. Mount specs contain only the mount target.
+Provider credentials stay in `mountConfig.auth`; the backend expands them into
+runtime proxy auth rules. You can also pass `proxyConfig` for non-mount proxy
+behavior such as custom headers, callbacks, access control, and generic egress
+rules. Explicit AWS/GCP proxy auth rules conflict with `mountConfig` auth for
+the same provider.
+
+S3 mounts require AWS auth:
+
+```ts
+import { awsAuth, mountConfig, s3Mount, workspaceSecret } from 'langsmith/sandbox';
+
+const mountCfg = mountConfig({
+  auth: [
+    awsAuth({
+      accessKeyId: workspaceSecret('SANDBOX_AWS_ACCESS_KEY_ID'),
+      secretAccessKey: workspaceSecret('SANDBOX_AWS_SECRET_ACCESS_KEY'),
+    }),
+  ],
+  mounts: [
+    s3Mount({
+      id: 'customer_data',
+      mountPath: '/mnt/mounts/customer-data',
+      bucket: 'example-bucket',
+      prefix: 'datasets/customer-data',
+      region: 'us-east-1',
+      endpointUrl: 'https://s3.amazonaws.com',
+      pathStyle: false,
+      readOnly: false,
+    }),
+  ],
+});
+
+const sandbox = await client.createSandbox({
+  name: 's3-mount-sandbox',
+  mountConfig: mountCfg,
+});
+
+try {
+  const result = await sandbox.run('ls /mnt/mounts/customer-data');
+  console.log(result.stdout);
+} finally {
+  await sandbox.delete();
+}
+```
+
+GCS mounts require GCP auth:
+
+```ts
+import { gcpAuth, gcsMount, mountConfig, workspaceSecret } from 'langsmith/sandbox';
+
+const mountCfg = mountConfig({
+  auth: [
+    gcpAuth({
+      serviceAccountJson: workspaceSecret('SANDBOX_GCP_SERVICE_ACCOUNT_JSON'),
+    }),
+  ],
+  mounts: [
+    gcsMount({
+      id: 'customer_data',
+      mountPath: '/mnt/mounts/customer-data',
+      bucket: 'example-bucket',
+      prefix: 'datasets/customer-data',
+    }),
+  ],
+});
+
+const sandbox = await client.createSandbox({
+  name: 'gcs-mount-sandbox',
+  mountConfig: mountCfg,
+});
+
+try {
+  const result = await sandbox.run('ls /mnt/mounts/customer-data');
+  console.log(result.stdout);
+} finally {
+  await sandbox.delete();
+}
+```
+
+Public Git mounts do not require AWS or GCP auth:
+
+```ts
+import { gitMount, mountConfig } from 'langsmith/sandbox';
+
+const mountCfg = mountConfig({
+  mounts: [
+    gitMount({
+      id: 'repo',
+      mountPath: '/mnt/repo',
+      remoteUrl: 'https://github.com/langchain-ai/langsmith-javascript.git',
+      ref: { type: 'branch', name: 'main' },
+      refreshIntervalSeconds: 60,
+    }),
+  ],
+});
+
+const sandbox = await client.createSandbox({
+  name: 'git-mount-sandbox',
+  mountConfig: mountCfg,
+});
+
+try {
+  const result = await sandbox.run('ls /mnt/repo');
+  console.log(result.stdout);
+} finally {
+  await sandbox.delete();
+}
+```
+
+Private Git repositories can use low-level `proxyConfig` rules when the remote
+requires proxy-managed auth. There is not yet a high-level private Git auth
+helper.
+
 ## Frequently Asked Questions
 
 ## Semantic versioning

package/lib/address.d.mts

@@ -1,69 +1,48 @@
 /** (beta) An agent environment. */
 export type Environment = "local" | "development" | "staging" | "production";
-/** (beta) The backend's form of an address, as the resolve endpoint takes it. */
-export type ApiAddress = {
-    kind: "AGENT" | "EXPERIMENT" | "EVALUATOR";
-    id?: string;
-    environment?: Uppercase<Environment>;
-};
-/** (beta) A feature that holds traces in a tracing project. */
-export interface Address {
-    /** The address in the backend's form. */
-    toApiAddress(): ApiAddress;
-}
-/** (beta) The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
-export declare class EnvAddressError extends Error {
-    constructor(message: string);
+/** (beta) The address of an agent's environment. */
+export interface AgentAddress {
+    kind: "AGENT";
+    id: string;
+    environment: Uppercase<Environment>;
 }
-/**
- * (beta) The address of an agent's environment.
- *
- * @example
- * ```ts
- * new AgentAddress("customer-support", "production");
- * ```
- */
-export declare class AgentAddress implements Address {
-    readonly id: string;
-    /** Always lowercase. */
-    readonly environment: Environment;
-    /**
-     * @param id 1 to 63 lowercase ASCII letters, digits or hyphens, starting
-     *   with a letter and ending with a letter or digit. The server creates the
-     *   agent on first use.
-     * @param environment One of `local`, `development`, `staging` or `production`, in
-     *   any case.
-     * @throws If a value is invalid.
-     */
+/** (beta) Construct and validate an agent address; plain objects are also accepted. */
+export declare class AgentAddress {
     constructor(id: string, environment: Environment | (string & {}));
-    toApiAddress(): ApiAddress;
-    /**
-     * Read the agent named by `LANGSMITH_AGENT_ID` and
-     * `LANGSMITH_AGENT_ENVIRONMENT`; `undefined` if neither is set.
-     * @throws {EnvAddressError} If only one is set, or a value is invalid.
-     */
-    static fromEnv(): AgentAddress | undefined;
 }
 /** (beta) The address of an experiment's tracing project. */
-export declare class ExperimentAddress implements Address {
-    /** Always lowercase. */
-    readonly id: string;
-    /**
-     * @param id The experiment's UUID.
-     * @throws If `id` is not a UUID.
-     */
+export interface ExperimentAddress {
+    kind: "EXPERIMENT";
+    id: string;
+}
+/** (beta) Construct and validate an experiment address. */
+export declare class ExperimentAddress {
     constructor(id: string);
-    toApiAddress(): ApiAddress;
 }
 /** (beta) The address of the workspace's shared evaluators project. */
-export declare class EvaluatorAddress implements Address {
+export interface EvaluatorAddress {
+    kind: "EVALUATOR";
+}
+/** (beta) Construct the workspace's evaluators address. */
+export declare class EvaluatorAddress {
     constructor();
-    toApiAddress(): ApiAddress;
 }
-/**
- * Return `value` if it is an `Address` of any kind, as a lookup takes it.
- * For the calls that only resolve an address to its project, such as
- * `getRunUrl`. Whatever receives traces takes `ensureAgent`.
- */
+/** (beta) A feature that holds traces in a tracing project. */
+export type Address = AgentAddress | ExperimentAddress | EvaluatorAddress;
+/** (beta) An address as the resolve endpoint takes it. */
+export type ApiAddress = Address;
+/** (beta) The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
+export declare class EnvAddressError extends Error {
+    constructor(message: string);
+}
+/** Validate an address at an SDK entrypoint and return a normalized copy. */
+export declare function ensureAddress<K extends Address["kind"]>(value: {
+    kind: K;
+    id?: unknown;
+    environment?: unknown;
+}): Extract<Address, {
+    kind: K;
+}>;
 export declare function ensureAddress(value: unknown): Address | undefined;
+export declare function ensureAgent(value: unknown): AgentAddress | undefined;
 //# sourceMappingURL=address.d.mts.map

package/lib/address.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.mts","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"AAmBA,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAQ7E,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACtC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,YAAY,IAAI,UAAU,CAAC;CAC5B;AAmBD,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;;;;;;OAOG;gBACS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAqBhE,YAAY,IAAI,UAAU;IA0B1B;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,YAAY,GAAG,SAAS;CAsB3C;AAED,6DAA6D;AAC7D,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;gBACS,EAAE,EAAE,MAAM;IAUtB,YAAY,IAAI,UAAU;CAG3B;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,YAAW,OAAO;;IAK9C,YAAY,IAAI,UAAU;CAG3B;AA8BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAcjE"}
+{"version":3,"file":"address.d.mts","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"AAmBA,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAQ7E,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,uFAAuF;AACvF,qBAAa,YAAY;gBACX,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;CAOjE;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,2DAA2D;AAC3D,qBAAa,iBAAiB;gBAChB,EAAE,EAAE,MAAM;CAMvB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,2DAA2D;AAC3D,qBAAa,gBAAgB;;CAK5B;AAED,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAE1E,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAcjC,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;IAC9D,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAClC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAoDnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC"}

package/lib/address.d.ts

@@ -1,69 +1,48 @@
 /** (beta) An agent environment. */
 export type Environment = "local" | "development" | "staging" | "production";
-/** (beta) The backend's form of an address, as the resolve endpoint takes it. */
-export type ApiAddress = {
-    kind: "AGENT" | "EXPERIMENT" | "EVALUATOR";
-    id?: string;
-    environment?: Uppercase<Environment>;
-};
-/** (beta) A feature that holds traces in a tracing project. */
-export interface Address {
-    /** The address in the backend's form. */
-    toApiAddress(): ApiAddress;
-}
-/** (beta) The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
-export declare class EnvAddressError extends Error {
-    constructor(message: string);
+/** (beta) The address of an agent's environment. */
+export interface AgentAddress {
+    kind: "AGENT";
+    id: string;
+    environment: Uppercase<Environment>;
 }
-/**
- * (beta) The address of an agent's environment.
- *
- * @example
- * ```ts
- * new AgentAddress("customer-support", "production");
- * ```
- */
-export declare class AgentAddress implements Address {
-    readonly id: string;
-    /** Always lowercase. */
-    readonly environment: Environment;
-    /**
-     * @param id 1 to 63 lowercase ASCII letters, digits or hyphens, starting
-     *   with a letter and ending with a letter or digit. The server creates the
-     *   agent on first use.
-     * @param environment One of `local`, `development`, `staging` or `production`, in
-     *   any case.
-     * @throws If a value is invalid.
-     */
+/** (beta) Construct and validate an agent address; plain objects are also accepted. */
+export declare class AgentAddress {
     constructor(id: string, environment: Environment | (string & {}));
-    toApiAddress(): ApiAddress;
-    /**
-     * Read the agent named by `LANGSMITH_AGENT_ID` and
-     * `LANGSMITH_AGENT_ENVIRONMENT`; `undefined` if neither is set.
-     * @throws {EnvAddressError} If only one is set, or a value is invalid.
-     */
-    static fromEnv(): AgentAddress | undefined;
 }
 /** (beta) The address of an experiment's tracing project. */
-export declare class ExperimentAddress implements Address {
-    /** Always lowercase. */
-    readonly id: string;
-    /**
-     * @param id The experiment's UUID.
-     * @throws If `id` is not a UUID.
-     */
+export interface ExperimentAddress {
+    kind: "EXPERIMENT";
+    id: string;
+}
+/** (beta) Construct and validate an experiment address. */
+export declare class ExperimentAddress {
     constructor(id: string);
-    toApiAddress(): ApiAddress;
 }
 /** (beta) The address of the workspace's shared evaluators project. */
-export declare class EvaluatorAddress implements Address {
+export interface EvaluatorAddress {
+    kind: "EVALUATOR";
+}
+/** (beta) Construct the workspace's evaluators address. */
+export declare class EvaluatorAddress {
     constructor();
-    toApiAddress(): ApiAddress;
 }
-/**
- * Return `value` if it is an `Address` of any kind, as a lookup takes it.
- * For the calls that only resolve an address to its project, such as
- * `getRunUrl`. Whatever receives traces takes `ensureAgent`.
- */
+/** (beta) A feature that holds traces in a tracing project. */
+export type Address = AgentAddress | ExperimentAddress | EvaluatorAddress;
+/** (beta) An address as the resolve endpoint takes it. */
+export type ApiAddress = Address;
+/** (beta) The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
+export declare class EnvAddressError extends Error {
+    constructor(message: string);
+}
+/** Validate an address at an SDK entrypoint and return a normalized copy. */
+export declare function ensureAddress<K extends Address["kind"]>(value: {
+    kind: K;
+    id?: unknown;
+    environment?: unknown;
+}): Extract<Address, {
+    kind: K;
+}>;
 export declare function ensureAddress(value: unknown): Address | undefined;
+export declare function ensureAgent(value: unknown): AgentAddress | undefined;
 //# sourceMappingURL=address.d.ts.map

package/lib/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"AAmBA,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAQ7E,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACtC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,YAAY,IAAI,UAAU,CAAC;CAC5B;AAmBD,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;;;;;;OAOG;gBACS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAqBhE,YAAY,IAAI,UAAU;IA0B1B;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,YAAY,GAAG,SAAS;CAsB3C;AAED,6DAA6D;AAC7D,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;gBACS,EAAE,EAAE,MAAM;IAUtB,YAAY,IAAI,UAAU;CAG3B;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,YAAW,OAAO;;IAK9C,YAAY,IAAI,UAAU;CAG3B;AA8BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAcjE"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"AAmBA,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAQ7E,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,uFAAuF;AACvF,qBAAa,YAAY;gBACX,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;CAOjE;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,2DAA2D;AAC3D,qBAAa,iBAAiB;gBAChB,EAAE,EAAE,MAAM;CAMvB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,2DAA2D;AAC3D,qBAAa,gBAAgB;;CAK5B;AAED,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAE1E,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAcjC,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;IAC9D,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAClC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAoDnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC"}