@deepraxis/sdk 0.1.1-dev.ed5af3e → 0.1.1-dev.f8aa5de

package/dist/generated/sdk.gen.d.ts

@@ -428,7 +428,7 @@ export declare const fileListFiles: <ThrowOnError extends boolean = false>(optio
 /**
  * Upload file
  *
- * 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.
+ * 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 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–7776000). Without expiry, the file persists until deleted.
  */
 export declare const fileCreateFile: <ThrowOnError extends boolean = false>(options: Options<FileCreateFileData, ThrowOnError>) => RequestResult<FileCreateFileResponses, FileCreateFileErrors, ThrowOnError>;
 /**
@@ -452,7 +452,7 @@ export declare const fileRetrieveFileContent: <ThrowOnError extends boolean = fa
 /**
  * Create an upload
  *
- * 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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. 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.
+ * 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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data and vision purposes. 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.
  */
 export declare const fileCreateUpload: <ThrowOnError extends boolean = false>(options: Options<FileCreateUploadData, ThrowOnError>) => RequestResult<FileCreateUploadResponses, FileCreateUploadErrors, ThrowOnError>;
 /**

package/dist/generated/sdk.gen.js

@@ -1092,7 +1092,7 @@ export const fileListFiles = (options) => (options?.client ?? client).get({
 /**
  * Upload file
  *
- * 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.
+ * 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 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–7776000). Without expiry, the file persists until deleted.
  */
 export const fileCreateFile = (options) => (options.client ?? client).post({
     ...formDataBodySerializer,
@@ -1169,7 +1169,7 @@ export const fileRetrieveFileContent = (options) => (options.client ?? client).g
 /**
  * Create an upload
  *
- * 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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. 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.
+ * 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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data and vision purposes. 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.
  */
 export const fileCreateUpload = (options) => (options.client ?? client).post({
     security: [{

package/dist/generated/types.gen.d.ts

@@ -1020,19 +1020,10 @@ export type OwnFileCreateFileRequest = {
      */
     file: Blob | File;
     /**
-     * Purpose label stored with the file: user_data, assistants or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.
+     * Purpose label stored with the file: user_data or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.
      */
-    purpose: 'user_data' | 'assistants' | 'vision';
+    purpose: 'user_data' | 'vision';
     expires_after?: OwnFileFileExpirationAfter;
-    /**
-     * Own-face extensions. Use at most one expiry setting.
-     */
-    praxis?: {
-        /**
-         * Lifetime in seconds after creation, from 3600 through 7776000. Send as the multipart field praxis[expires_in_seconds]; mutually exclusive with expires_after.
-         */
-        expires_in_seconds?: number;
-    };
 };
 /**
  * OpenAIFile
@@ -1067,7 +1058,7 @@ export type OwnFileOpenAiFile = {
     /**
      * Upload purpose. Image references in conversations require user_data.
      */
-    purpose: 'user_data' | 'assistants' | 'vision';
+    purpose: 'user_data' | 'vision';
     /**
      * Deprecated. The current status of the file, which can be either `uploaded`, `processed`, or `error`.
      *
@@ -1165,9 +1156,9 @@ export type OwnFilePraxisCreateUpload = {
      */
     mime_type: string;
     /**
-     * Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images.
+     * Use user_data for conversation attachments, or vision for PNG, JPEG, GIF and WebP images.
      */
-    purpose: 'user_data' | 'assistants' | 'vision';
+    purpose: 'user_data' | 'vision';
     /**
      * Optional expiry policy for the resulting file; omission retains the file until deletion.
      */
@@ -1212,9 +1203,9 @@ export type OwnFilePraxisUpload = {
      */
     filename: string;
     /**
-     * File purpose: user_data for conversation attachments, assistants for assistant files, vision for images.
+     * File purpose: user_data for conversation attachments, vision for images.
      */
-    purpose: 'user_data' | 'assistants' | 'vision';
+    purpose: 'user_data' | 'vision';
     /**
      * Upload state: pending accepts parts; completed has a file; cancelled was cancelled; expired exceeded its one-hour lifetime.
      */
@@ -11084,7 +11075,7 @@ export type DatabaseNewField = {
      */
     unique?: boolean;
     /**
-     * Whether to maintain an index for faster filters and ordering. Defaults to true for scalar types and is not allowed for json and link fields. At most 16 indexed or unique fields per table.
+     * Whether to maintain an index for faster filters and ordering. Defaults to false and is not allowed for json and link fields. At most 16 indexed or unique fields per table.
      */
     indexed?: boolean;
     /**
@@ -11119,7 +11110,7 @@ export type DatabaseNewField = {
      */
     unique?: boolean;
     /**
-     * Whether to maintain an index for faster filters and ordering. Defaults to true for scalar types and is not allowed for json and link fields. At most 16 indexed or unique fields per table.
+     * Whether to maintain an index for faster filters and ordering. Defaults to false and is not allowed for json and link fields. At most 16 indexed or unique fields per table.
      */
     indexed?: boolean;
     /**
@@ -11159,7 +11150,7 @@ export type DatabaseNewField = {
      */
     unique?: boolean;
     /**
-     * Whether to maintain an index for faster filters and ordering. Defaults to true for scalar types and is not allowed for json and link fields. At most 16 indexed or unique fields per table.
+     * Whether to maintain an index for faster filters and ordering. Defaults to false and is not allowed for json and link fields. At most 16 indexed or unique fields per table.
      */
     indexed?: boolean;
     /**
@@ -13871,7 +13862,7 @@ export type OwnFileFileExpirationAfter = {
      */
     anchor: 'created_at';
     /**
-     * Lifetime in seconds after creation, from 3600 through 2592000. Send as expires_after[seconds]; do not combine with praxis[expires_in_seconds].
+     * Lifetime in seconds after creation, from 3600 through 7776000. Send as expires_after[seconds].
      */
     seconds: number;
 };
@@ -22423,7 +22414,7 @@ export type MediaSemanticHit = {
      */
     asset: MediaAsset;
     /**
-     * Ranking score: cosine similarity for semantic or visual search; normalized rank-fusion score for hybrid search. Higher values rank first.
+     * Ranking score: cosine similarity for semantic or visual search; normalized rank-fusion score for hybrid search. Higher values rank first; hybrid scores are not probabilities or confidence.
      */
     score: number;
     /**
@@ -63022,7 +63013,7 @@ export type MediaUploadAssetData = {
          */
         filename_override?: string;
         /**
-         * Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true.
+         * Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true.
          */
         overwrite?: boolean;
         /**
@@ -63119,7 +63110,7 @@ export type MediaImportAssetData = {
      */
     body: {
         /**
-         * File ID to copy into this library; passed as the upload source instead of file bytes.
+         * File ID to copy into this library; passed as the upload source instead of file bytes. This creates an independent public copy readable without authentication. Deleting the source File does not delete this asset; do not import confidential content.
          */
         file_id: string;
         /**
@@ -63155,7 +63146,7 @@ export type MediaImportAssetData = {
          */
         filename_override?: string;
         /**
-         * Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true.
+         * Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true.
          */
         overwrite?: boolean;
         /**
@@ -63614,7 +63605,7 @@ export type MediaExpressionSearchData = {
      */
     body: {
         /**
-         * Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets.
+         * Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: ["context"] to include context.
          */
         expression?: string;
         /**

package/dist/helpers/file-upload.d.ts

@@ -1,8 +1,8 @@
 import type { Praxis } from '../core/client.js';
 import type { OwnFileOpenAiFile } from '../generated/types.gen.js';
 export interface UploadFileOptions {
-    /** user_data for conversation attachments; assistants for assistant files; vision for PNG/JPEG/GIF/WebP. */
-    purpose: 'user_data' | 'assistants' | 'vision';
+    /** user_data for conversation attachments and documents; vision for PNG/JPEG/GIF/WebP. */
+    purpose: 'user_data' | 'vision';
     /** Defaults to File.name, or upload for a Blob. */
     filename?: string;
     /** Fixed part size in bytes, 5 MiB–64 MB; defaults to 50 MiB. */

package/dist/operations.generated.d.ts

@@ -6732,7 +6732,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 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 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 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–7776000). Without expiry, the file persists until deleted.";
     readonly http: "POST";
     readonly path: "/file/v1/files";
     readonly streaming: "no";
@@ -6750,19 +6750,14 @@ export declare const operations: readonly [{
         }, {
             readonly name: "purpose";
             readonly type: "string";
-            readonly enum: readonly ["user_data", "assistants", "vision"];
+            readonly enum: readonly ["user_data", "vision"];
             readonly required: true;
-            readonly description: "Purpose label stored with the file: user_data, assistants or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.";
+            readonly description: "Purpose label stored with the file: user_data or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.";
         }, {
             readonly name: "expires_after";
             readonly type: "object";
             readonly required: false;
             readonly description: "Optional expiry relative to created_at. Files without an expiry persist until deleted.";
-        }, {
-            readonly name: "praxis";
-            readonly type: "object";
-            readonly required: false;
-            readonly description: "Own-face extensions. Use at most one expiry setting.";
         }];
     };
 }, {
@@ -6814,7 +6809,7 @@ export declare const operations: 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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. 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 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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data and vision purposes. 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";
@@ -6841,9 +6836,9 @@ export declare const operations: readonly [{
         }, {
             readonly name: "purpose";
             readonly type: "string";
-            readonly enum: readonly ["user_data", "assistants", "vision"];
+            readonly enum: readonly ["user_data", "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 description: "Use user_data for conversation attachments, or vision for PNG, JPEG, GIF and WebP images.";
         }, {
             readonly name: "expires_after";
             readonly type: "object";
@@ -7793,7 +7788,7 @@ export declare const operations: readonly [{
             readonly name: "overwrite";
             readonly type: "boolean";
             readonly required: false;
-            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true.";
+            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true.";
         }, {
             readonly name: "tags";
             readonly type: "object";
@@ -7838,7 +7833,7 @@ export declare const operations: readonly [{
             readonly name: "file_id";
             readonly type: "string";
             readonly required: true;
-            readonly description: "File ID to copy into this library; passed as the upload source instead of file bytes.";
+            readonly description: "File ID to copy into this library; passed as the upload source instead of file bytes. This creates an independent public copy readable without authentication. Deleting the source File does not delete this asset; do not import confidential content.";
         }, {
             readonly name: "public_id";
             readonly type: "string";
@@ -7883,7 +7878,7 @@ export declare const operations: readonly [{
             readonly name: "overwrite";
             readonly type: "boolean";
             readonly required: false;
-            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true.";
+            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true.";
         }, {
             readonly name: "tags";
             readonly type: "object";
@@ -8292,7 +8287,7 @@ export declare const operations: readonly [{
             readonly name: "expression";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets.";
+            readonly description: "Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: [\"context\"] to include context.";
         }, {
             readonly name: "sort_by";
             readonly type: "array";

package/dist/operations.generated.js

@@ -8289,7 +8289,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 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.",
+        "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 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–7776000). Without expiry, the file persists until deleted.",
         "http": "POST",
         "path": "/file/v1/files",
         "streaming": "no",
@@ -8311,23 +8311,16 @@ export const operations = [
                     "type": "string",
                     "enum": [
                         "user_data",
-                        "assistants",
                         "vision"
                     ],
                     "required": true,
-                    "description": "Purpose label stored with the file: user_data, assistants or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data."
+                    "description": "Purpose label stored with the file: user_data or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data."
                 },
                 {
                     "name": "expires_after",
                     "type": "object",
                     "required": false,
                     "description": "Optional expiry relative to created_at. Files without an expiry persist until deleted."
-                },
-                {
-                    "name": "praxis",
-                    "type": "object",
-                    "required": false,
-                    "description": "Own-face extensions. Use at most one expiry setting."
                 }
             ]
         }
@@ -8390,7 +8383,7 @@ export const operations = [
         "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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. 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.",
+        "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, uploads accept at most 2 GiB (2147483648 bytes) and only user_data and vision purposes. 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",
@@ -8423,11 +8416,10 @@ export const operations = [
                     "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."
+                    "description": "Use user_data for conversation attachments, or vision for PNG, JPEG, GIF and WebP images."
                 },
                 {
                     "name": "expires_after",
@@ -9607,7 +9599,7 @@ export const operations = [
                     "name": "overwrite",
                     "type": "boolean",
                     "required": false,
-                    "description": "Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true."
+                    "description": "Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true."
                 },
                 {
                     "name": "tags",
@@ -9666,7 +9658,7 @@ export const operations = [
                     "name": "file_id",
                     "type": "string",
                     "required": true,
-                    "description": "File ID to copy into this library; passed as the upload source instead of file bytes."
+                    "description": "File ID to copy into this library; passed as the upload source instead of file bytes. This creates an independent public copy readable without authentication. Deleting the source File does not delete this asset; do not import confidential content."
                 },
                 {
                     "name": "public_id",
@@ -9720,7 +9712,7 @@ export const operations = [
                     "name": "overwrite",
                     "type": "boolean",
                     "required": false,
-                    "description": "Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true."
+                    "description": "Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true."
                 },
                 {
                     "name": "tags",
@@ -10237,7 +10229,7 @@ export const operations = [
                     "name": "expression",
                     "type": "string",
                     "required": false,
-                    "description": "Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets."
+                    "description": "Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: [\"context\"] to include context."
                 },
                 {
                     "name": "sort_by",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepraxis/sdk",
-  "version": "0.1.1-dev.ed5af3e",
+  "version": "0.1.1-dev.f8aa5de",
   "type": "module",
   "sideEffects": false,
   "exports": {