@deepraxis/sdk 0.1.0-dev.5e0f28e → 0.1.0-dev.6898104

package/dist/operations.generated.d.ts

@@ -6149,7 +6149,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "create";
     readonly summary: "Upload file";
-    readonly description: "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 104857600 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. OpenAI Uploads chunking is not supported. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.";
+    readonly description: "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.";
     readonly http: "POST";
     readonly path: "/file/v1/files";
     readonly streaming: "no";
@@ -6163,7 +6163,7 @@ export declare const operations: readonly [{
             readonly name: "file";
             readonly type: "string";
             readonly required: true;
-            readonly description: "File bytes in one multipart file part, not a filename or file ID. The file must be nonempty and at most 104857600 bytes; its content determines the MIME type.";
+            readonly description: "File bytes in one multipart file part, not a filename or file ID. The file must be nonempty and at most 100000000 bytes; its content determines the MIME type.";
         }, {
             readonly name: "purpose";
             readonly type: "string";
@@ -6200,7 +6200,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "retrieve";
     readonly summary: "Retrieve file";
-    readonly description: "Retrieve metadata for a live file owned by your tenant. Use its file_dp_ ID from upload or list. Missing, deleted, expired and other-tenant files return 404; use the content endpoint to download the bytes.";
+    readonly description: "Retrieve metadata for a live file owned by your tenant. Use its file- ID from upload or list. Missing, deleted, expired and other-tenant files return 404; use the content endpoint to download the bytes.";
     readonly http: "GET";
     readonly path: "/file/v1/files/{file_id}";
     readonly streaming: "no";
@@ -6214,7 +6214,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "retrieveContent";
     readonly summary: "Retrieve file content";
-    readonly description: "Download the original bytes of a live file owned by your tenant. Supply its file_dp_ ID from upload or list. A single byte Range can return a partial response; a range outside the file returns 416. Missing, deleted, expired and other-tenant files return 404.";
+    readonly description: "Download the original bytes of a live file owned by your tenant. Supply its file- ID from upload or list. A single byte Range can return a partial response; a range outside the file returns 416. Missing, deleted, expired and other-tenant files return 404.";
     readonly http: "GET";
     readonly path: "/file/v1/files/{file_id}/content";
     readonly streaming: "no";
@@ -6224,6 +6224,124 @@ export declare const operations: readonly [{
         readonly sdkName: "file_id";
     }];
     readonly query: readonly [];
+}, {
+    readonly resource: "file.uploads";
+    readonly method: "create";
+    readonly summary: "Create an upload";
+    readonly description: "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, only user_data, assistants and vision are accepted. The API accepts up to 8000000000 bytes; the Console and SDK uploadFile helper cap files at 2 GiB. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "bytes";
+            readonly type: "integer";
+            readonly required: true;
+            readonly description: "Exact complete file length in bytes, from 1 through 8000000000; the sum of completed parts must match.";
+        }, {
+            readonly name: "filename";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Filename for the resulting file, at most 255 UTF-8 bytes.";
+        }, {
+            readonly name: "mime_type";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Declared MIME type; validated against the assembled content.";
+        }, {
+            readonly name: "purpose";
+            readonly type: "string";
+            readonly enum: readonly ["user_data", "assistants", "vision"];
+            readonly required: true;
+            readonly description: "Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images.";
+        }, {
+            readonly name: "expires_after";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Optional expiry policy for the resulting file; omission retains the file until deletion.";
+        }, {
+            readonly name: "part_size";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Optional fixed part size in bytes, 5242880–64000000. Requires part_number on every part; retries of identical bytes at the same number return the same part. Omit to use arbitrary-sized parts.";
+        }];
+    };
+}, {
+    readonly resource: "file.uploads";
+    readonly method: "cancel";
+    readonly summary: "Cancel an upload";
+    readonly description: "Cancel an unfinished upload using upload_id from create and release its reserved storage. Further parts and completion are rejected. Cancelling an already cancelled upload returns the same terminal result; a completed upload cannot be cancelled. Delete its resulting file instead.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads/{upload_id}/cancel";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "upload_id";
+        readonly sdkName: "upload_id";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "file.uploads";
+    readonly method: "complete";
+    readonly summary: "Complete an upload";
+    readonly description: "Assemble the uploaded parts into a file. Supply upload_id from create and part_ids from addPart in file byte order; their sizes must total the declared bytes. Optional md5 verifies the assembled content. Retrying identical part_ids and normalized md5 returns the same result; different inputs return 409. Unlike OpenAI, completed can contain a file still processing (status uploaded). Poll files.retrieve using file.id until status processed (own face state active); error, expiry or 404 means processing failed and the file cannot be used.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads/{upload_id}/complete";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "upload_id";
+        readonly sdkName: "upload_id";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "part_ids";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly description: "All part IDs in concatenation order, without duplicates. Fixed-size uploads require increasing part_number order.";
+        }, {
+            readonly name: "md5";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Optional whole-file MD5 as 32 hexadecimal characters; verified after assembly.";
+        }];
+    };
+}, {
+    readonly resource: "file.uploads.parts";
+    readonly method: "create";
+    readonly summary: "Add an upload part";
+    readonly description: "Send one nonempty part as the multipart data field, at most 64000000 bytes. Parts may arrive concurrently in any order. Use upload_id from create. For a fixed-size upload, supply part_number starting at 1 and exactly part_size bytes except for the final remainder; retry the same number with identical bytes to recover its part ID. Without part_size, each request creates a new part and part_number is ignored. Save the returned part IDs for complete.";
+    readonly http: "POST";
+    readonly path: "/file/v1/uploads/{upload_id}/parts";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly multipart: true;
+    readonly pathParams: readonly [{
+        readonly name: "upload_id";
+        readonly sdkName: "upload_id";
+    }];
+    readonly query: readonly [{
+        readonly name: "part_number";
+        readonly type: "integer";
+        readonly required: false;
+        readonly description: "Required when create set part_size; 1 through ceil(bytes / part_size). Ignored for general uploads.";
+    }];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "data";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Raw bytes of this part, nonempty and at most 64000000 bytes.";
+        }];
+    };
 }, {
     readonly resource: "knowledge.vectorStores";
     readonly method: "list";

package/dist/operations.generated.js

@@ -7629,7 +7629,7 @@ export const operations = [
         "resource": "file.files",
         "method": "create",
         "summary": "Upload file",
-        "description": "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 104857600 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. OpenAI Uploads chunking is not supported. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.",
+        "description": "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.",
         "http": "POST",
         "path": "/file/v1/files",
         "streaming": "no",
@@ -7644,7 +7644,7 @@ export const operations = [
                     "name": "file",
                     "type": "string",
                     "required": true,
-                    "description": "File bytes in one multipart file part, not a filename or file ID. The file must be nonempty and at most 104857600 bytes; its content determines the MIME type."
+                    "description": "File bytes in one multipart file part, not a filename or file ID. The file must be nonempty and at most 100000000 bytes; its content determines the MIME type."
                 },
                 {
                     "name": "purpose",
@@ -7693,7 +7693,7 @@ export const operations = [
         "resource": "file.files",
         "method": "retrieve",
         "summary": "Retrieve file",
-        "description": "Retrieve metadata for a live file owned by your tenant. Use its file_dp_ ID from upload or list. Missing, deleted, expired and other-tenant files return 404; use the content endpoint to download the bytes.",
+        "description": "Retrieve metadata for a live file owned by your tenant. Use its file- ID from upload or list. Missing, deleted, expired and other-tenant files return 404; use the content endpoint to download the bytes.",
         "http": "GET",
         "path": "/file/v1/files/{file_id}",
         "streaming": "no",
@@ -7710,7 +7710,7 @@ export const operations = [
         "resource": "file.files",
         "method": "retrieveContent",
         "summary": "Retrieve file content",
-        "description": "Download the original bytes of a live file owned by your tenant. Supply its file_dp_ ID from upload or list. A single byte Range can return a partial response; a range outside the file returns 416. Missing, deleted, expired and other-tenant files return 404.",
+        "description": "Download the original bytes of a live file owned by your tenant. Supply its file- ID from upload or list. A single byte Range can return a partial response; a range outside the file returns 416. Missing, deleted, expired and other-tenant files return 404.",
         "http": "GET",
         "path": "/file/v1/files/{file_id}/content",
         "streaming": "no",
@@ -7723,6 +7723,152 @@ export const operations = [
         ],
         "query": []
     },
+    {
+        "resource": "file.uploads",
+        "method": "create",
+        "summary": "Create an upload",
+        "description": "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, only user_data, assistants and vision are accepted. The API accepts up to 8000000000 bytes; the Console and SDK uploadFile helper cap files at 2 GiB. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.",
+        "http": "POST",
+        "path": "/file/v1/uploads",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "bytes",
+                    "type": "integer",
+                    "required": true,
+                    "description": "Exact complete file length in bytes, from 1 through 8000000000; the sum of completed parts must match."
+                },
+                {
+                    "name": "filename",
+                    "type": "string",
+                    "required": true,
+                    "description": "Filename for the resulting file, at most 255 UTF-8 bytes."
+                },
+                {
+                    "name": "mime_type",
+                    "type": "string",
+                    "required": true,
+                    "description": "Declared MIME type; validated against the assembled content."
+                },
+                {
+                    "name": "purpose",
+                    "type": "string",
+                    "enum": [
+                        "user_data",
+                        "assistants",
+                        "vision"
+                    ],
+                    "required": true,
+                    "description": "Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images."
+                },
+                {
+                    "name": "expires_after",
+                    "type": "object",
+                    "required": false,
+                    "description": "Optional expiry policy for the resulting file; omission retains the file until deletion."
+                },
+                {
+                    "name": "part_size",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Optional fixed part size in bytes, 5242880–64000000. Requires part_number on every part; retries of identical bytes at the same number return the same part. Omit to use arbitrary-sized parts."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "file.uploads",
+        "method": "cancel",
+        "summary": "Cancel an upload",
+        "description": "Cancel an unfinished upload using upload_id from create and release its reserved storage. Further parts and completion are rejected. Cancelling an already cancelled upload returns the same terminal result; a completed upload cannot be cancelled. Delete its resulting file instead.",
+        "http": "POST",
+        "path": "/file/v1/uploads/{upload_id}/cancel",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "upload_id",
+                "sdkName": "upload_id"
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "file.uploads",
+        "method": "complete",
+        "summary": "Complete an upload",
+        "description": "Assemble the uploaded parts into a file. Supply upload_id from create and part_ids from addPart in file byte order; their sizes must total the declared bytes. Optional md5 verifies the assembled content. Retrying identical part_ids and normalized md5 returns the same result; different inputs return 409. Unlike OpenAI, completed can contain a file still processing (status uploaded). Poll files.retrieve using file.id until status processed (own face state active); error, expiry or 404 means processing failed and the file cannot be used.",
+        "http": "POST",
+        "path": "/file/v1/uploads/{upload_id}/complete",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "upload_id",
+                "sdkName": "upload_id"
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "part_ids",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "All part IDs in concatenation order, without duplicates. Fixed-size uploads require increasing part_number order."
+                },
+                {
+                    "name": "md5",
+                    "type": "string",
+                    "required": false,
+                    "description": "Optional whole-file MD5 as 32 hexadecimal characters; verified after assembly."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "file.uploads.parts",
+        "method": "create",
+        "summary": "Add an upload part",
+        "description": "Send one nonempty part as the multipart data field, at most 64000000 bytes. Parts may arrive concurrently in any order. Use upload_id from create. For a fixed-size upload, supply part_number starting at 1 and exactly part_size bytes except for the final remainder; retry the same number with identical bytes to recover its part ID. Without part_size, each request creates a new part and part_number is ignored. Save the returned part IDs for complete.",
+        "http": "POST",
+        "path": "/file/v1/uploads/{upload_id}/parts",
+        "streaming": "no",
+        "pagination": false,
+        "multipart": true,
+        "pathParams": [
+            {
+                "name": "upload_id",
+                "sdkName": "upload_id"
+            }
+        ],
+        "query": [
+            {
+                "name": "part_number",
+                "type": "integer",
+                "required": false,
+                "description": "Required when create set part_size; 1 through ceil(bytes / part_size). Ignored for general uploads."
+            }
+        ],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "data",
+                    "type": "string",
+                    "required": true,
+                    "description": "Raw bytes of this part, nonempty and at most 64000000 bytes."
+                }
+            ]
+        }
+    },
     {
         "resource": "knowledge.vectorStores",
         "method": "list",

package/dist/resources.generated.d.ts

@@ -3581,6 +3581,14 @@ export declare function createFile(transport: Transport): {
         retrieve: (options: import("./core/transport.js").CallOptions<Types.FileRetrieveFileData>) => Promise<Types.OwnFileOpenAiFile>;
         retrieveContent: (options: import("./core/transport.js").CallOptions<Types.FileRetrieveFileContentData>) => Promise<Blob | File>;
     };
+    uploads: {
+        cancel: (options: import("./core/transport.js").CallOptions<Types.FileCancelUploadData>) => Promise<Types.OwnFilePraxisUpload>;
+        complete: (options: import("./core/transport.js").CallOptions<Types.FileCompleteUploadData>) => Promise<Types.OwnFilePraxisUpload>;
+        create: (options: import("./core/transport.js").CallOptions<Types.FileCreateUploadData>) => Promise<Types.OwnFilePraxisUpload>;
+        parts: {
+            create: (options: import("./core/transport.js").CallOptions<Types.FileAddUploadPartData>) => Promise<Types.OwnFilePraxisUploadPart>;
+        };
+    };
 };
 export declare function createKnowledge(transport: Transport): {
     vectorStores: {

package/dist/resources.generated.js

@@ -400,6 +400,14 @@ export function createFile(transport) {
             retrieve: bind(transport, sdk.fileRetrieveFile),
             retrieveContent: bind(transport, sdk.fileRetrieveFileContent),
         },
+        uploads: {
+            cancel: bind(transport, sdk.fileCancelUpload),
+            complete: bind(transport, sdk.fileCompleteUpload),
+            create: bind(transport, sdk.fileCreateUpload),
+            parts: {
+                create: bind(transport, options => sdk.fileAddUploadPart({ ...options, bodySerializer: multipartBodySerializer, headers: { 'Content-Type': null, ...options.headers } })),
+            },
+        },
     };
 }
 export function createKnowledge(transport) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepraxis/sdk",
-  "version": "0.1.0-dev.5e0f28e",
+  "version": "0.1.0-dev.6898104",
   "type": "module",
   "sideEffects": false,
   "exports": {