@orq-ai/node 3.10.0-rc.9 → 3.10.2

package/docs/sdks/{knowledgebases → chunking}/README.md

@@ -1,18 +1,19 @@
-# KnowledgeBases
-(*knowledgeBases*)
+# Chunking
+(*chunking*)
 
 ## Overview
 
 ### Available Operations
 
-* [chunkText](#chunktext) - Chunk text
+* [parse](#parse) - Parse text
 
-## chunkText
+## parse
 
 Split large text documents into smaller, manageable chunks using different chunking strategies optimized for RAG (Retrieval-Augmented Generation) workflows. This endpoint supports multiple chunking algorithms including token-based, sentence-based, recursive, semantic, and specialized strategies.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="parse" method="post" path="/v2/chunking" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -21,7 +22,7 @@ const orq = new Orq({
 });
 
 async function run() {
-  const result = await orq.knowledgeBases.chunkText({
+  const result = await orq.chunking.parse({
     text: "The quick brown fox jumps over the lazy dog. This is a sample text that will be chunked into smaller pieces. Each chunk will maintain context while respecting the maximum chunk size.",
     metadata: true,
     strategy: "semantic",
@@ -44,7 +45,7 @@ The standalone function version of this method:
 
 ```typescript
 import { OrqCore } from "@orq-ai/node/core.js";
-import { knowledgeBasesChunkText } from "@orq-ai/node/funcs/knowledgeBasesChunkText.js";
+import { chunkingParse } from "@orq-ai/node/funcs/chunkingParse.js";
 
 // Use `OrqCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
@@ -53,7 +54,7 @@ const orq = new OrqCore({
 });
 
 async function run() {
-  const res = await knowledgeBasesChunkText(orq, {
+  const res = await chunkingParse(orq, {
     text: "The quick brown fox jumps over the lazy dog. This is a sample text that will be chunked into smaller pieces. Each chunk will maintain context while respecting the maximum chunk size.",
     metadata: true,
     strategy: "semantic",
@@ -67,7 +68,7 @@ async function run() {
     const { value: result } = res;
     console.log(result);
   } else {
-    console.log("knowledgeBasesChunkText failed:", res.error);
+    console.log("chunkingParse failed:", res.error);
   }
 }
 
@@ -78,14 +79,14 @@ run();
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `request`                                                                                                                                                                      | [operations.ChunkTextChunkingRequest](../../models/operations/chunktextchunkingrequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `request`                                                                                                                                                                      | [operations.ParseChunkingRequest](../../models/operations/parsechunkingrequest.md)                                                                                             | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
 
 ### Response
 
-**Promise\<[operations.ChunkTextResponseBody](../../models/operations/chunktextresponsebody.md)\>**
+**Promise\<[operations.ParseResponseBody](../../models/operations/parseresponsebody.md)\>**
 
 ### Errors
 

package/docs/sdks/contacts/README.md

@@ -17,6 +17,7 @@ Creates a new contact or updates an existing one based on external_id. Use this
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="CreateContact" method="post" path="/v2/contacts" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -117,6 +118,7 @@ Retrieves a paginated list of contacts in your workspace. Use pagination paramet
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="ListContacts" method="get" path="/v2/contacts" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -199,6 +201,7 @@ Retrieves detailed information about a specific contact using their contact ID o
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="RetrieveContact" method="get" path="/v2/contacts/{id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -272,6 +275,7 @@ Updates specific fields of an existing contact. Only the fields provided in the
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="UpdateContact" method="patch" path="/v2/contacts/{id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -377,6 +381,7 @@ Permanently deletes a contact from your workspace. This action cannot be undone.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeleteContact" method="delete" path="/v2/contacts/{id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 

package/docs/sdks/datasets/README.md

@@ -23,6 +23,7 @@ Retrieves a paginated list of datasets for the current workspace. Results can be
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="ListDatasets" method="get" path="/v2/datasets" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -91,6 +92,7 @@ Creates a new dataset in the specified project.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="CreateDataset" method="post" path="/v2/datasets" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -165,6 +167,7 @@ Retrieves a specific dataset by its unique identifier
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="RetrieveDataset" method="get" path="/v2/datasets/{dataset_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -238,6 +241,7 @@ Update a dataset
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="UpdateDataset" method="patch" path="/v2/datasets/{dataset_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -317,6 +321,7 @@ Permanently deletes a dataset and all its datapoints. This action is irreversibl
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeleteDataset" method="delete" path="/v2/datasets/{dataset_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -389,6 +394,7 @@ Retrieves a paginated list of datapoints from a specific dataset.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="ListDatasetDatapoints" method="get" path="/v2/datasets/{dataset_id}/datapoints" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -461,6 +467,7 @@ Creates a new datapoint in the specified dataset.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="CreateDatasetItem" method="post" path="/v2/datasets/{dataset_id}/datapoints" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -533,6 +540,7 @@ Retrieves a datapoint object
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="RetrieveDatapoint" method="get" path="/v2/datasets/{dataset_id}/datapoints/{datapoint_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -608,6 +616,7 @@ Update a datapoint
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="UpdateDatapoint" method="patch" path="/v2/datasets/{dataset_id}/datapoints/{datapoint_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -683,6 +692,7 @@ Permanently deletes a specific datapoint from a dataset.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeleteDatapoint" method="delete" path="/v2/datasets/{dataset_id}/datapoints/{datapoint_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -758,6 +768,7 @@ Delete all datapoints from a dataset. This action is irreversible.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="ClearDataset" method="delete" path="/v2/datasets/{dataset_id}/clear" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 

package/docs/sdks/deployments/README.md

@@ -16,6 +16,7 @@ Returns a list of your deployments. The deployments are returned sorted by creat
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="Deployments" method="get" path="/v2/deployments" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -85,6 +86,7 @@ Retrieve the deployment configuration
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeploymentGetConfig" method="post" path="/v2/deployments/get_config" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -157,6 +159,7 @@ Invoke a deployment with a given payload
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeploymentInvoke" method="post" path="/v2/deployments/invoke" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -233,6 +236,7 @@ Stream deployment generation. Only supported for completions and chat completion
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeploymentStream" method="post" path="/v2/deployments/stream" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 

package/docs/sdks/evals/README.md

@@ -54,6 +54,7 @@ Get all Evaluators
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="GetEvals" method="get" path="/v2/evaluators" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -123,6 +124,7 @@ Create an Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="CreateEval" method="post" path="/v2/evaluators" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -222,6 +224,7 @@ Update an Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="UpdateEval" method="patch" path="/v2/evaluators/{id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -303,6 +306,7 @@ Delete an Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="DeleteEval" method="delete" path="/v2/evaluators/{id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -376,6 +380,7 @@ Run BertScore Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsBertScore" method="post" path="/v2/evaluators/bert_score" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -446,6 +451,7 @@ Run BLEU Score Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsBleuScore" method="post" path="/v2/evaluators/bleu_score" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -516,6 +522,7 @@ Run Contains All Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContainsAll" method="post" path="/v2/evaluators/contains_all" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -586,6 +593,7 @@ Run Contains Any Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContainsAny" method="post" path="/v2/evaluators/contains_any" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -656,6 +664,7 @@ Run Contains Email Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContainsEmail" method="post" path="/v2/evaluators/contains_email" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -726,6 +735,7 @@ Run Contains None Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContainsNone" method="post" path="/v2/evaluators/contains_none" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -796,6 +806,7 @@ Run Contains URL Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContainsUrl" method="post" path="/v2/evaluators/contains_url" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -866,6 +877,7 @@ Run Contains Valid Link Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContainsValidLink" method="post" path="/v2/evaluators/contains_valid_link" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -936,6 +948,7 @@ Run Contains Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsContains" method="post" path="/v2/evaluators/contains" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1006,6 +1019,7 @@ Run Ends With Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsEndsWith" method="post" path="/v2/evaluators/ends_with" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1076,6 +1090,7 @@ Run Exact Match Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsExactMatch" method="post" path="/v2/evaluators/exact_match" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1146,6 +1161,7 @@ Run Length Between Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsLengthBetween" method="post" path="/v2/evaluators/length_between" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1216,6 +1232,7 @@ Run Length Greater Than Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsLengthGreaterThan" method="post" path="/v2/evaluators/length_greater_than" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1286,6 +1303,7 @@ Run Length Less Than Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsLengthLessThan" method="post" path="/v2/evaluators/length_less_than" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1356,6 +1374,7 @@ Run JSON Validation Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsValidJson" method="post" path="/v2/evaluators/valid_json" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1426,6 +1445,7 @@ Run Age Appropriate Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsAgeAppropriate" method="post" path="/v2/evaluators/age_appropriate" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1496,6 +1516,7 @@ Run Bot Detection Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsBotDetection" method="post" path="/v2/evaluators/bot_detection" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1566,6 +1587,7 @@ Run Fact Checking Knowledge Base Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsFactCheckingKnowledgeBase" method="post" path="/v2/evaluators/fact_checking_knowledge_base" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1636,6 +1658,7 @@ Run Grammar Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsGrammar" method="post" path="/v2/evaluators/grammar" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1706,6 +1729,7 @@ Run Localization Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsLocalization" method="post" path="/v2/evaluators/localization" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1776,6 +1800,7 @@ Run PII Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsPii" method="post" path="/v2/evaluators/pii" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1846,6 +1871,7 @@ Run Sentiment Classification Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsSentimentClassification" method="post" path="/v2/evaluators/sentiment_classification" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1916,6 +1942,7 @@ Run Summarization Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsSummarization" method="post" path="/v2/evaluators/summarization" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -1986,6 +2013,7 @@ Run Tone of Voice Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsToneOfVoice" method="post" path="/v2/evaluators/tone_of_voice" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2056,6 +2084,7 @@ Run Translation Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsTranslation" method="post" path="/v2/evaluators/translation" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2126,6 +2155,7 @@ Run Coherence Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasCoherence" method="post" path="/v2/evaluators/ragas_coherence" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2196,6 +2226,7 @@ Run Conciseness Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasConciseness" method="post" path="/v2/evaluators/ragas_conciseness" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2266,6 +2297,7 @@ Run Context Precision Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasContextPrecision" method="post" path="/v2/evaluators/ragas_context_precision" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2336,6 +2368,7 @@ Run Context Recall Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasContextRecall" method="post" path="/v2/evaluators/ragas_context_recall" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2406,6 +2439,7 @@ Run Context Entities Recall Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasContextEntitiesRecall" method="post" path="/v2/evaluators/ragas_context_entities_recall" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2476,6 +2510,7 @@ Run Correctness Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasCorrectness" method="post" path="/v2/evaluators/ragas_correctness" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2546,6 +2581,7 @@ Run Faithfulness Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasFaithfulness" method="post" path="/v2/evaluators/ragas_faithfulness" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2616,6 +2652,7 @@ Run Harmfulness Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasHarmfulness" method="post" path="/v2/evaluators/ragas_harmfulness" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2686,6 +2723,7 @@ Run Maliciousness Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasMaliciousness" method="post" path="/v2/evaluators/ragas_maliciousness" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2756,6 +2794,7 @@ Run Noise Sensitivity Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasNoiseSensitivity" method="post" path="/v2/evaluators/ragas_noise_sensitivity" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2826,6 +2865,7 @@ Run Response Relevancy Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasResponseRelevancy" method="post" path="/v2/evaluators/ragas_response_relevancy" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2896,6 +2936,7 @@ Run Summarization Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="EvalsRagasSummarization" method="post" path="/v2/evaluators/ragas_summarization" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -2966,6 +3007,7 @@ Invoke a Custom Evaluator
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="InvokeEval" method="post" path="/v2/evaluators/{id}/invoke" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 

package/docs/sdks/feedback/README.md

@@ -13,6 +13,7 @@ Submit feedback for the LLM transaction via the API
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="CreateFeedback" method="post" path="/v2/feedback" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 

package/docs/sdks/files/README.md

@@ -16,6 +16,7 @@ Files are used to upload documents that can be used with features like [Deployme
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="FileUpload" method="post" path="/v2/files" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 import { openAsBlob } from "node:fs";
@@ -90,6 +91,7 @@ Returns a list of the files that your account has access to. orq.ai sorts and re
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="FileList" method="get" path="/v2/files" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -158,6 +160,7 @@ Retrieves the details of an existing file object. After you supply a unique file
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="FileGet" method="get" path="/v2/files/{file_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -230,6 +233,7 @@ Delete file
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="FileDelete" method="delete" path="/v2/files/{file_id}" -->
 ```typescript
 import { Orq } from "@orq-ai/node";