@xpert-ai/plugin-sdk 3.15.1 → 3.15.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @xpert-ai/plugin-sdk
 
+## 3.15.2
+
+### Patch Changes
+
+- 481ffba: file understanding & vector store
+- Updated dependencies [481ffba]
+  - @xpert-ai/contracts@3.15.3
+
 ## 3.15.1
 
 ### Patch Changes

package/index.cjs.js

@@ -2768,7 +2768,7 @@ const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platfor
 });
 
 const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.workspace.files', {
-    description: 'Upload, read, and delete raw files in Xpert workspace volumes.'
+    description: 'Upload, understand, read, and delete raw files in Xpert workspace volumes.'
 });
 
 const SKILL_SOURCE_PROVIDER = 'SKILL_SOURCE_PROVIDER';

package/index.esm.js

@@ -2748,7 +2748,7 @@ const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platfor
 });
 
 const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.workspace.files', {
-    description: 'Upload, read, and delete raw files in Xpert workspace volumes.'
+    description: 'Upload, understand, read, and delete raw files in Xpert workspace volumes.'
 });
 
 const SKILL_SOURCE_PROVIDER = 'SKILL_SOURCE_PROVIDER';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.15.1",
+  "version": "3.15.2",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/lib/runtime/capabilities/workspace-files.d.ts

@@ -37,8 +37,37 @@ export type WorkspaceFile = {
 export type WorkspaceFileBuffer = WorkspaceFile & {
     buffer: Buffer;
 };
+export type WorkspaceUnderstandFileInput = WorkspaceFileReference & {
+    originalName?: string | null;
+    mimeType?: string | null;
+    size?: number | null;
+    fileUrl?: string | null;
+    url?: string | null;
+    purpose?: 'chat_attachment' | 'workspace' | 'knowledge';
+    parseMode?: 'auto' | 'fast' | 'deep' | 'none';
+    conversationId?: string | null;
+    threadId?: string | null;
+    projectId?: string | null;
+    xpertId?: string | null;
+    metadata?: Record<string, unknown>;
+    runInline?: boolean | null;
+};
+export type WorkspaceUnderstoodFile = WorkspaceFile & {
+    id: string;
+    fileId: string;
+    fileAssetId: string;
+    storageFileId?: string;
+    originalName?: string;
+    status: string;
+    parseStatus: string;
+    purpose?: string;
+    parseMode?: string;
+    capabilities?: string[];
+    summary?: string;
+};
 export interface WorkspaceFilesApi {
     uploadBuffer(input: WorkspaceUploadBufferInput): Promise<WorkspaceFile>;
+    understandFile(input: WorkspaceUnderstandFileInput): Promise<WorkspaceUnderstoodFile>;
     readBuffer(input: WorkspaceFileReference): Promise<WorkspaceFileBuffer>;
     deleteFile(input: WorkspaceFileReference): Promise<void>;
 }