docs(sdk): make embeddings example first

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 4
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-ee884a4336559147aacf9a927a540f21e9760f00d2d5588af00fa8a25e2707d9.yml
 openapi_spec_hash: 2ba78bd360942c63a7d08dba791f00d2
-config_hash: efa2ea406c5ecd6883ff8b0fb428e579
+config_hash: a85580968a69d8d6fadf96e5e2d6870e

README.md

@@ -26,13 +26,12 @@ const client = new Isaacus({
   apiKey: process.env['ISAACUS_API_KEY'], // This is the default and can be omitted
 });
 
-const universalClassificationResponse = await client.classifications.universal.create({
-  model: 'kanon-universal-classifier',
-  query: 'This is a confidentiality clause.',
-  texts: ['I agree not to tell anyone about the document.'],
+const embeddingResponse = await client.embeddings.create({
+  model: 'kanon-2-embedder',
+  texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'],
 });
 
-console.log(universalClassificationResponse.classifications);
+console.log(embeddingResponse.embeddings);
 ```
 
 ### Request & Response types
@@ -47,13 +46,11 @@ const client = new Isaacus({
   apiKey: process.env['ISAACUS_API_KEY'], // This is the default and can be omitted
 });
 
-const params: Isaacus.Classifications.UniversalCreateParams = {
-  model: 'kanon-universal-classifier',
-  query: 'This is a confidentiality clause.',
-  texts: ['I agree not to tell anyone about the document.'],
+const params: Isaacus.EmbeddingCreateParams = {
+  model: 'kanon-2-embedder',
+  texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'],
 };
-const universalClassificationResponse: Isaacus.Classifications.UniversalClassificationResponse =
-  await client.classifications.universal.create(params);
+const embeddingResponse: Isaacus.EmbeddingResponse = await client.embeddings.create(params);
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -66,11 +63,10 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const universalClassificationResponse = await client.classifications.universal
+const embeddingResponse = await client.embeddings
   .create({
-    model: 'kanon-universal-classifier',
-    query: 'This is a confidentiality clause.',
-    texts: ['I agree not to tell anyone about the document.'],
+    model: 'kanon-2-embedder',
+    texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'],
   })
   .catch(async (err) => {
     if (err instanceof Isaacus.APIError) {
@@ -112,7 +108,7 @@ const client = new Isaacus({
 });
 
 // Or, configure per-request:
-await client.classifications.universal.create({ model: 'kanon-universal-classifier', query: 'This is a confidentiality clause.', texts: ['I agree not to tell anyone about the document.'] }, {
+await client.embeddings.create({ model: 'kanon-2-embedder', texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'] }, {
   maxRetries: 5,
 });
 ```
@@ -129,7 +125,7 @@ const client = new Isaacus({
 });
 
 // Override per-request:
-await client.classifications.universal.create({ model: 'kanon-universal-classifier', query: 'This is a confidentiality clause.', texts: ['I agree not to tell anyone about the document.'] }, {
+await client.embeddings.create({ model: 'kanon-2-embedder', texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'] }, {
   timeout: 5 * 1000,
 });
 ```
@@ -152,25 +148,23 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Isaacus();
 
-const response = await client.classifications.universal
+const response = await client.embeddings
   .create({
-    model: 'kanon-universal-classifier',
-    query: 'This is a confidentiality clause.',
-    texts: ['I agree not to tell anyone about the document.'],
+    model: 'kanon-2-embedder',
+    texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'],
   })
   .asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: universalClassificationResponse, response: raw } = await client.classifications.universal
+const { data: embeddingResponse, response: raw } = await client.embeddings
   .create({
-    model: 'kanon-universal-classifier',
-    query: 'This is a confidentiality clause.',
-    texts: ['I agree not to tell anyone about the document.'],
+    model: 'kanon-2-embedder',
+    texts: ['Are restraints of trade enforceable under English law?', 'What is a non-compete clause?'],
   })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
-console.log(universalClassificationResponse.classifications);
+console.log(embeddingResponse.embeddings);
 ```
 
 ### Logging
@@ -250,7 +244,7 @@ parameter. This library doesn't validate at runtime that the request matches the
 send will be sent as-is.
 
 ```ts
-client.classifications.universal.create({
+client.embeddings.create({
   // ...
   // @ts-expect-error baz is not yet public
   baz: 'undocumented option',