@naturali/sdk 0.133.0 → 0.133.1

package/dist/index.d.cts

@@ -420,6 +420,8 @@ type ErrorResponse = {
 };
 /**
  * Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.
+ *
+ * Keys beginning `system.` are reserved: the platform writes them to record which conversation, actor, agent and role a row came from, and a write naming one is refused with `400 RESERVED_TAG_KEY`. They are read and filtered like any other tag.
  */
 type TagBag = {
   [key: string]: string;
@@ -2343,6 +2345,10 @@ type ConversationRecord = {
    * Actor ID associated with this conversation
    */
   actor_id?: string | null;
+  /**
+   * Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so `none` leaves them readable and reachable by full-text search without paying for an embedding. `null` (the default) inherits the project's `default_conversation_retrieval`.
+   */
+  retrieval?: 'embed' | 'none' | null;
 };
 type ConversationMessageRecord = {
   /**
@@ -11246,6 +11252,10 @@ type CreateConversationData = {
      * Actor ID to associate with this conversation
      */
     actor_id?: string | null;
+    /**
+     * Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so `none` leaves them readable and reachable by full-text search without paying for an embedding. `null` (the default) inherits the project's `default_conversation_retrieval`.
+     */
+    retrieval?: 'embed' | 'none' | null;
   };
   path: {
     /**
@@ -11362,6 +11372,10 @@ type UpdateConversationData = {
      * New conversation name
      */
     name?: string | null;
+    /**
+     * Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so `none` leaves them readable and reachable by full-text search without paying for an embedding. `null` (the default) inherits the project's `default_conversation_retrieval`. Switching it on embeds the turns already in the conversation, so the whole conversation becomes retrievable rather than only what is said next.
+     */
+    retrieval?: 'embed' | 'none' | null;
   };
   path: {
     /**
@@ -11798,7 +11812,7 @@ type CreateDocumentData = {
   body: {
     content: string;
     /**
-     * Logical path within the project (e.g. /reports/q1.txt). Defaults to /filename if omitted.
+     * Logical path within the project (e.g. /reports/q1.txt). Defaults to `/<filename>`, or to `/<document_id>.txt` when neither is given — a document with no path is reachable only by its id, since a prefix filter never matches null.
      */
     path?: string;
     filename?: string;
@@ -13475,6 +13489,10 @@ type ListFilesData = {
     project_id: string;
   };
   query?: {
+    /**
+     * Only files under this directory. The prefix is a path boundary, not a substring: `/reports` returns `/reports/q1.txt` and never `/reports-archive/q1.txt`, and `/` selects the whole project. A leading slash is optional and a trailing one is ignored, so `reports`, `/reports` and `/reports/` are the same filter. `%` and `_` are literal characters, not wildcards. Naming a directory under `/.system/` is what includes platform-written files, which a list without this parameter leaves out.
+     */
+    path_prefix?: string;
     /**
      * Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.
      *

package/dist/index.d.mts

@@ -420,6 +420,8 @@ type ErrorResponse = {
 };
 /**
  * Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.
+ *
+ * Keys beginning `system.` are reserved: the platform writes them to record which conversation, actor, agent and role a row came from, and a write naming one is refused with `400 RESERVED_TAG_KEY`. They are read and filtered like any other tag.
  */
 type TagBag = {
   [key: string]: string;
@@ -2343,6 +2345,10 @@ type ConversationRecord = {
    * Actor ID associated with this conversation
    */
   actor_id?: string | null;
+  /**
+   * Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so `none` leaves them readable and reachable by full-text search without paying for an embedding. `null` (the default) inherits the project's `default_conversation_retrieval`.
+   */
+  retrieval?: 'embed' | 'none' | null;
 };
 type ConversationMessageRecord = {
   /**
@@ -11246,6 +11252,10 @@ type CreateConversationData = {
      * Actor ID to associate with this conversation
      */
     actor_id?: string | null;
+    /**
+     * Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so `none` leaves them readable and reachable by full-text search without paying for an embedding. `null` (the default) inherits the project's `default_conversation_retrieval`.
+     */
+    retrieval?: 'embed' | 'none' | null;
   };
   path: {
     /**
@@ -11362,6 +11372,10 @@ type UpdateConversationData = {
      * New conversation name
      */
     name?: string | null;
+    /**
+     * Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so `none` leaves them readable and reachable by full-text search without paying for an embedding. `null` (the default) inherits the project's `default_conversation_retrieval`. Switching it on embeds the turns already in the conversation, so the whole conversation becomes retrievable rather than only what is said next.
+     */
+    retrieval?: 'embed' | 'none' | null;
   };
   path: {
     /**
@@ -11798,7 +11812,7 @@ type CreateDocumentData = {
   body: {
     content: string;
     /**
-     * Logical path within the project (e.g. /reports/q1.txt). Defaults to /filename if omitted.
+     * Logical path within the project (e.g. /reports/q1.txt). Defaults to `/<filename>`, or to `/<document_id>.txt` when neither is given — a document with no path is reachable only by its id, since a prefix filter never matches null.
      */
     path?: string;
     filename?: string;
@@ -13475,6 +13489,10 @@ type ListFilesData = {
     project_id: string;
   };
   query?: {
+    /**
+     * Only files under this directory. The prefix is a path boundary, not a substring: `/reports` returns `/reports/q1.txt` and never `/reports-archive/q1.txt`, and `/` selects the whole project. A leading slash is optional and a trailing one is ignored, so `reports`, `/reports` and `/reports/` are the same filter. `%` and `_` are literal characters, not wildcards. Naming a directory under `/.system/` is what includes platform-written files, which a list without this parameter leaves out.
+     */
+    path_prefix?: string;
     /**
      * Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.133.0",
+  "version": "0.133.1",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.133.0",
+    "@naturali/api": "0.133.1",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",