@xpert-ai/plugin-sdk 3.15.1 → 3.15.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @xpert-ai/plugin-sdk
 
+## 3.15.3
+
+### Patch Changes
+
+- bdcb73b: handoff messages
+- Updated dependencies [bdcb73b]
+  - @xpert-ai/contracts@3.15.4
+
+## 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.3",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/lib/agent/handoff/types.d.ts

@@ -79,6 +79,8 @@ export interface HandoffMessageHeaders extends Record<string, string> {
     source?: RunSource;
     requestedLane?: LaneName;
     integrationId?: string;
+    policyTimeoutMs?: string;
+    policyIdleTimeoutMs?: string;
 }
 /**
  * Processor execution policy: declared by the Processor, executed uniformly by the Dispatcher.
@@ -86,11 +88,14 @@ export interface HandoffMessageHeaders extends Record<string, string> {
 export interface ProcessorPolicy {
     lane: LaneName;
     timeoutMs?: number;
+    idleTimeoutMs?: number;
 }
 export interface ProcessContext {
     runId: string;
     traceId: string;
     abortSignal: AbortSignal;
+    heartbeat?: (reason?: string) => void;
+    getAbortReason?: () => string | undefined;
     /**
      * Optional local-process event channel for queue waiters (e.g. SSE connection awaiting this message).
      * This is intentionally process-local and best-effort.

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>;
 }