docs: add examples to tsdocs

Author: stainless-app[bot]

src/resources/classifications/universal.ts

@@ -8,6 +8,18 @@ export class Universal extends APIResource {
   /**
    * Classify the relevance of legal documents to a query with an Isaacus universal
    * legal AI classifier.
+   *
+   * @example
+   * ```ts
+   * const universalClassification =
+   *   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.',
+   *     ],
+   *   });
+   * ```
    */
   create(body: UniversalCreateParams, options?: RequestOptions): APIPromise<UniversalClassification> {
     return this._client.post('/classifications/universal', { body, ...options });

src/resources/extractions/qa.ts

@@ -8,6 +8,19 @@ export class Qa extends APIResource {
   /**
    * Extract answers to questions from legal documents with an Isaacus legal AI
    * answer extractor.
+   *
+   * @example
+   * ```ts
+   * const answerExtraction = await client.extractions.qa.create(
+   *   {
+   *     model: 'kanon-answer-extractor',
+   *     query: 'What is the punishment for murder in Victoria?',
+   *     texts: [
+   *       'The standard sentence for murder in the State of Victoria is 30 years if the person murdered was a police officer and 25 years in any other case.',
+   *     ],
+   *   },
+   * );
+   * ```
    */
   create(body: QaCreateParams, options?: RequestOptions): APIPromise<AnswerExtraction> {
     return this._client.post('/extractions/qa', { body, ...options });

src/resources/rerankings.ts

@@ -8,6 +8,22 @@ export class Rerankings extends APIResource {
   /**
    * Rerank legal documents by their relevance to a query with an Isaacus legal AI
    * reranker.
+   *
+   * @example
+   * ```ts
+   * const reranking = await client.rerankings.create({
+   *   model: 'kanon-universal-classifier',
+   *   query:
+   *     'What are the essential elements required to establish a negligence claim?',
+   *   texts: [
+   *     'To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.',
+   *     'Criminal cases involve a completely different standard, requiring proof beyond a reasonable doubt.',
+   *     'In a negligence claim, the plaintiff must prove duty, breach, causation, and damages.',
+   *     'Negligence in tort law requires establishing a duty of care that the defendant owed to the plaintiff.',
+   *     'The concept of negligence is central to tort law, with courts assessing whether a breach of duty caused harm.',
+   *   ],
+   * });
+   * ```
    */
   create(body: RerankingCreateParams, options?: RequestOptions): APIPromise<Reranking> {
     return this._client.post('/rerankings', { body, ...options });