@soat/sdk 0.13.2 → 0.13.3

package/dist/index.d.cts

@@ -1265,7 +1265,11 @@ type DocumentRecord = {
    */
   size?: number;
   /**
-   * Text content (only present on getDocument)
+   * Ingestion lifecycle state. `pending` — enqueued; `processing` — chunks being extracted and embedded; `ready` — fully indexed; `failed` — processing error (see `metadata.failure_reason`).
+   */
+  status?: 'pending' | 'processing' | 'ready' | 'failed';
+  /**
+   * Text content (only present on getDocument, and only when status is ready)
    */
   content?: string | null;
   created_at?: Date;
@@ -2265,6 +2269,10 @@ type MemoryKnowledgeResult = {
    * Public ID of the parent memory
    */
   memory_id: string;
+  /**
+   * Human-readable name of the parent memory
+   */
+  memory_name: string;
   /**
    * Text content of the memory entry
    */
@@ -2567,7 +2575,7 @@ type NodeExecution = {
    * Type of the executed node (e.g. agent, transform).
    */
   node_type?: string | null;
-  status: 'completed' | 'failed' | 'requires_action';
+  status: 'completed' | 'failed' | 'requires_action' | 'skipped';
   /**
    * Resolved input_mapping the node received.
    */
@@ -4953,12 +4961,17 @@ type IngestDocumentData = {
     chunk_overlap?: number;
   };
   path?: never;
-  query?: never;
+  query?: {
+    /**
+     * When omitted or `true` (default), processing runs in the background and `202 Accepted` is returned immediately with `status=pending`. Pass `false` to run synchronously and receive `201 Created` with `status=ready`.
+     */
+    async?: boolean;
+  };
   url: '/api/v1/documents/ingest';
 };
 type IngestDocumentErrors = {
   /**
-   * Invalid request, file not found, unsupported content type, or no extractable text
+   * Invalid request, file not found, or unsupported content type
    */
   400: ErrorResponse;
   /**
@@ -4973,9 +4986,13 @@ type IngestDocumentErrors = {
 type IngestDocumentError = IngestDocumentErrors[keyof IngestDocumentErrors];
 type IngestDocumentResponses = {
   /**
-   * Document created from file
+   * Ingestion completed synchronously (only when `?async=false`). The document is fully indexed and ready for search.
    */
   201: IngestedDocumentRecord;
+  /**
+   * Ingestion accepted. The document record has been created with `status=pending` and processing runs in the background. Poll `GET /api/v1/documents/{document_id}` until `status` is `ready` or `failed`.
+   */
+  202: IngestedDocumentRecord;
 };
 type IngestDocumentResponse = IngestDocumentResponses[keyof IngestDocumentResponses];
 type DeleteDocumentData = {

package/dist/index.d.mts

@@ -1265,7 +1265,11 @@ type DocumentRecord = {
    */
   size?: number;
   /**
-   * Text content (only present on getDocument)
+   * Ingestion lifecycle state. `pending` — enqueued; `processing` — chunks being extracted and embedded; `ready` — fully indexed; `failed` — processing error (see `metadata.failure_reason`).
+   */
+  status?: 'pending' | 'processing' | 'ready' | 'failed';
+  /**
+   * Text content (only present on getDocument, and only when status is ready)
    */
   content?: string | null;
   created_at?: Date;
@@ -2265,6 +2269,10 @@ type MemoryKnowledgeResult = {
    * Public ID of the parent memory
    */
   memory_id: string;
+  /**
+   * Human-readable name of the parent memory
+   */
+  memory_name: string;
   /**
    * Text content of the memory entry
    */
@@ -2567,7 +2575,7 @@ type NodeExecution = {
    * Type of the executed node (e.g. agent, transform).
    */
   node_type?: string | null;
-  status: 'completed' | 'failed' | 'requires_action';
+  status: 'completed' | 'failed' | 'requires_action' | 'skipped';
   /**
    * Resolved input_mapping the node received.
    */
@@ -4953,12 +4961,17 @@ type IngestDocumentData = {
     chunk_overlap?: number;
   };
   path?: never;
-  query?: never;
+  query?: {
+    /**
+     * When omitted or `true` (default), processing runs in the background and `202 Accepted` is returned immediately with `status=pending`. Pass `false` to run synchronously and receive `201 Created` with `status=ready`.
+     */
+    async?: boolean;
+  };
   url: '/api/v1/documents/ingest';
 };
 type IngestDocumentErrors = {
   /**
-   * Invalid request, file not found, unsupported content type, or no extractable text
+   * Invalid request, file not found, or unsupported content type
    */
   400: ErrorResponse;
   /**
@@ -4973,9 +4986,13 @@ type IngestDocumentErrors = {
 type IngestDocumentError = IngestDocumentErrors[keyof IngestDocumentErrors];
 type IngestDocumentResponses = {
   /**
-   * Document created from file
+   * Ingestion completed synchronously (only when `?async=false`). The document is fully indexed and ready for search.
    */
   201: IngestedDocumentRecord;
+  /**
+   * Ingestion accepted. The document record has been created with `status=pending` and processing runs in the background. Poll `GET /api/v1/documents/{document_id}` until `status` is `ready` or `failed`.
+   */
+  202: IngestedDocumentRecord;
 };
 type IngestDocumentResponse = IngestDocumentResponses[keyof IngestDocumentResponses];
 type DeleteDocumentData = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "TypeScript SDK for the SOAT API",
   "type": "module",
   "main": "dist/index.mjs",