sdk-py: add versioning for assistants (langchain-ai#1665)

* add get_versions to python sdk

* fml

* add change_version to sdk

* add assistant name to create

* document assistant name

* change method

* version in payload

* fml

* add js methods and types

* name -> assistant_name

* export onconflictbehavior

* add assistant name to create

* add metadata/limit/offset to sdk

* add assistant_name to update

* assistantversion schema

* export assistnatversion

* add metadata/limit/offset to sdk

* assistantversion schema

* fmt

* fmt

* change version -> set version

* fmt

* assistant_name -> name

* naming

Author: isahers1

libs/sdk-js/src/client.ts

@@ -9,6 +9,7 @@ import {
   Thread,
   ThreadState,
   Cron,
+  AssistantVersion,
 } from "./schema.js";
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
 import {
@@ -244,6 +245,7 @@ export class AssistantsClient extends BaseClient {
     metadata?: Metadata;
     assistantId?: string;
     ifExists?: OnConflictBehavior;
+    name?: string;
   }): Promise<Assistant> {
     return this.fetch<Assistant>("/assistants", {
       method: "POST",
@@ -253,6 +255,7 @@ export class AssistantsClient extends BaseClient {
         metadata: payload.metadata,
         assistant_id: payload.assistantId,
         if_exists: payload.ifExists,
+        name: payload.name,
       },
     });
   }
@@ -269,6 +272,7 @@ export class AssistantsClient extends BaseClient {
       graphId?: string;
       config?: Config;
       metadata?: Metadata;
+      name?: string;
     },
   ): Promise<Assistant> {
     return this.fetch<Assistant>(`/assistants/${assistantId}`, {
@@ -277,6 +281,7 @@ export class AssistantsClient extends BaseClient {
         graph_id: payload.graphId,
         config: payload.config,
         metadata: payload.metadata,
+        name: payload.name,
       },
     });
   }
@@ -313,6 +318,47 @@ export class AssistantsClient extends BaseClient {
       },
     });
   }
+
+  /**
+   * List all versions of an assistant.
+   *
+   * @param assistantId ID of the assistant.
+   * @returns List of assistant versions.
+   */
+  async getVersions(
+    assistantId: string,
+    payload?: {
+      metadata?: Metadata;
+      limit?: number;
+      offset?: number;
+    },
+  ): Promise<AssistantVersion[]> {
+    return this.fetch<AssistantVersion[]>(
+      `/assistants/${assistantId}/versions`,
+      {
+        method: "POST",
+        json: {
+          metadata: payload?.metadata ?? undefined,
+          limit: payload?.limit ?? 10,
+          offset: payload?.offset ?? 0,
+        },
+      },
+    );
+  }
+
+  /**
+   * Change the version of an assistant.
+   *
+   * @param assistantId ID of the assistant.
+   * @param version The version to change to.
+   * @returns The updated assistant.
+   */
+  async setLatest(assistantId: string, version: number): Promise<Assistant> {
+    return this.fetch<Assistant>(`/assistants/${assistantId}/set_latest`, {
+      method: "POST",
+      json: { version },
+    });
+  }
 }
 
 export class ThreadsClient extends BaseClient {

libs/sdk-js/src/index.ts

@@ -2,6 +2,7 @@ export { Client } from "./client.js";
 
 export type {
   Assistant,
+  AssistantVersion,
   AssistantGraph,
   Config,
   DefaultValues,
@@ -12,3 +13,5 @@ export type {
   ThreadState,
   Cron,
 } from "./schema.js";
+
+export type { OnConflictBehavior } from "./types.js";

libs/sdk-js/src/schema.ts

@@ -75,13 +75,20 @@ export interface GraphSchema {
 
 export type Metadata = Optional<Record<string, unknown>>;
 
-export interface Assistant {
+export interface AssistantBase {
   assistant_id: string;
   graph_id: string;
   config: Config;
   created_at: string;
-  updated_at: string;
   metadata: Metadata;
+  version: number;
+}
+
+export interface AssistantVersion extends AssistantBase {}
+
+export interface Assistant extends AssistantBase {
+  updated_at: string;
+  name: string;
 }
 export type AssistantGraph = Record<string, Array<Record<string, unknown>>>;