@xpert-ai/plugin-sdk 3.15.10 → 3.15.12

package/index.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './index.cjs.js';
+export { _default as default } from './index.cjs.default.js';

package/index.esm.js

@@ -1,6 +1,8 @@
 import { Module, Logger, applyDecorators, SetMetadata, HttpException, HttpStatus, BadRequestException, Injectable, Inject, Optional, UnauthorizedException, NotFoundException, ForbiddenException } from '@nestjs/common';
 import { MODULE_METADATA } from '@nestjs/common/constants';
 import { pick } from 'lodash-es';
+import { _ as _extends } from './collaboration-client.esm2.js';
+export { b as base64ToBytes, a as bytesToBase64, c as createCollaborationClient, d as createCollaborationPresenceStore, e as createSocketIoTransportAdapter, f as createYjsDocumentAdapter } from './collaboration-client.esm2.js';
 import { DiscoveryService, Reflector } from '@nestjs/core';
 import { Subject, filter } from 'rxjs';
 import { LanguagesEnum, AiModelTypeEnum, ParameterType, PriceType, FetchFrom, ModelFeature, ModelPropertyKey } from '@xpert-ai/contracts';
@@ -131,17 +133,6 @@ function resolveTenantGlobalScopeKey(tenantId) {
     return GLOBAL_ORGANIZATION_SCOPE;
 }
 
-function _extends() {
-    _extends = Object.assign || function assign(target) {
-        for(var i = 1; i < arguments.length; i++){
-            var source = arguments[i];
-            for(var key in source)if (Object.prototype.hasOwnProperty.call(source, key)) target[key] = source[key];
-        }
-        return target;
-    };
-    return _extends.apply(this, arguments);
-}
-
 function createPluginLogger(scope, baseMeta = {}) {
     const nestLogger = new Logger(scope);
     const wrap = (level, msg, meta)=>{
@@ -519,10 +510,12 @@ class BaseStrategyRegistry {
         }
     }
     upsert(instance) {
-        const type = this.reflector.get(this.strategyKey, instance.constructor);
+        const target = resolveStrategyMetadataTarget(instance);
+        if (!target) {
+            return;
+        }
+        const type = this.reflector.get(this.strategyKey, target);
         if (type) {
-            var _instance_metatype;
-            const target = (_instance_metatype = instance.metatype) != null ? _instance_metatype : instance.constructor;
             const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
             var _this_reflector_get;
             const organizationId = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : pluginName ? GLOBAL_ORGANIZATION_SCOPE : BUILTIN_GLOBAL_SCOPE;
@@ -630,6 +623,23 @@ __decorate([
     Inject(StrategyBus),
     __metadata("design:type", StrategyBus)
 ], BaseStrategyRegistry.prototype, "bus", void 0);
+/** Returns whether a discovered provider can carry decorator metadata. */ function isStrategyInstance(instance) {
+    return typeof instance === 'object' && instance !== null || typeof instance === 'function';
+}
+/** Resolves the class used for plugin and organization metadata without reflecting over primitive provider values. */ function resolveStrategyMetadataTarget(instance) {
+    if (!isStrategyInstance(instance)) {
+        return null;
+    }
+    if (typeof instance === 'function') {
+        return instance;
+    }
+    const metatype = instance.metatype;
+    if (typeof metatype === 'function') {
+        return metatype;
+    }
+    const constructor = instance.constructor;
+    return typeof constructor === 'function' ? constructor : null;
+}
 
 let IntegrationStrategyRegistry = class IntegrationStrategyRegistry extends BaseStrategyRegistry {
     constructor(discoveryService, reflector){
@@ -2784,6 +2794,37 @@ const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.worksp
     description: 'Upload, understand, read, and delete raw files in Xpert workspace volumes.'
 });
 
+/** Stable machine-readable failures emitted by the Sandbox Jobs capability. */ const SANDBOX_JOB_ERROR_CODES = [
+    'SANDBOX_ACTION_UNAVAILABLE',
+    'SANDBOX_ACTION_INVALID',
+    'SANDBOX_PROFILE_UNAVAILABLE',
+    'SANDBOX_RUNTIME_UNAVAILABLE',
+    'SANDBOX_VERSION_MISMATCH',
+    'SANDBOX_CAPACITY_UNAVAILABLE',
+    'SANDBOX_START_FAILED',
+    'BROWSER_LAUNCH_FAILED',
+    'EXPORT_TIMEOUT',
+    'EXPORT_OOM',
+    'EXPORT_INPUT_INVALID',
+    'EXPORT_OUTPUT_INVALID',
+    'SANDBOX_CANCELLED'
+];
+/** Error carrying retry policy and Job identity across plugin queue handlers. */ class SandboxJobRuntimeError extends Error {
+    constructor(code, message, retryable, jobId){
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.jobId = jobId;
+        this.name = 'SandboxJobRuntimeError';
+    }
+}
+/** Narrows an unknown failure to the structured Sandbox Jobs runtime error contract. */ function isSandboxJobRuntimeError(error) {
+    return error instanceof SandboxJobRuntimeError;
+}
+/** Runtime capability key used to resolve SandboxJobsApi from the platform registry. */ const SandboxJobsRuntimeCapability = createRuntimeCapability('platform.sandbox.jobs', {
+    description: 'Run registered plugin actions in isolated, short-lived Sandbox Runtime jobs.'
+});
+
 const SKILL_SOURCE_PROVIDER = 'SKILL_SOURCE_PROVIDER';
 const SkillSourceProviderStrategy = (provider)=>applyDecorators(SetMetadata(SKILL_SOURCE_PROVIDER, provider), SetMetadata(STRATEGY_META_KEY, SKILL_SOURCE_PROVIDER));
 
@@ -4149,6 +4190,76 @@ function resolveSandboxTerminalAdapter(sandbox) {
     return isSandboxTerminalAdapter(candidate) ? candidate : null;
 }
 
+const SANDBOX_RUNTIME_PROVIDER = 'SANDBOX_RUNTIME_PROVIDER';
+/** Marks a built-in or system-plugin class as a named Sandbox Runtime Provider strategy. */ const SandboxRuntimeProviderStrategy = (provider)=>applyDecorators(SetMetadata(SANDBOX_RUNTIME_PROVIDER, provider), SetMetadata(STRATEGY_META_KEY, SANDBOX_RUNTIME_PROVIDER));
+
+var SandboxRuntimeProviderRegistry_1;
+/** Discovers Runtime Provider strategies and rejects organization-scoped executable infrastructure. */ let SandboxRuntimeProviderRegistry = SandboxRuntimeProviderRegistry_1 = class SandboxRuntimeProviderRegistry extends BaseStrategyRegistry {
+    upsert(instance) {
+        const target = resolveStrategyMetadataTarget(instance);
+        if (!target) {
+            return;
+        }
+        if (!this.reflector.get(SANDBOX_RUNTIME_PROVIDER, target)) {
+            return;
+        }
+        const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
+        var _this_reflector_get;
+        const scope = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : BUILTIN_GLOBAL_SCOPE;
+        if (pluginName && scope !== SYSTEM_GLOBAL_SCOPE) {
+            this.runtimeLogger.warn(`Ignored Sandbox Runtime Provider from non-system plugin ${pluginName} in scope ${scope}.`);
+            return;
+        }
+        super.upsert(instance);
+    }
+    constructor(discoveryService, reflector){
+        super(SANDBOX_RUNTIME_PROVIDER, discoveryService, reflector);
+        this.runtimeLogger = new Logger(SandboxRuntimeProviderRegistry_1.name);
+    }
+};
+SandboxRuntimeProviderRegistry = SandboxRuntimeProviderRegistry_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [
+        DiscoveryService,
+        Reflector
+    ])
+], SandboxRuntimeProviderRegistry);
+
+const SANDBOX_WORKSPACE_MAPPER = 'SANDBOX_WORKSPACE_MAPPER';
+/** Associates a workspace path mapper with a named Runtime Provider strategy. */ const SandboxWorkspaceMapperStrategy = (provider)=>applyDecorators(SetMetadata(SANDBOX_WORKSPACE_MAPPER, provider), SetMetadata(STRATEGY_META_KEY, SANDBOX_WORKSPACE_MAPPER));
+
+var SandboxWorkspaceMapperRegistry_1;
+/** Discovers Provider path mappers while enforcing the same system-level trust boundary as Providers. */ let SandboxWorkspaceMapperRegistry = SandboxWorkspaceMapperRegistry_1 = class SandboxWorkspaceMapperRegistry extends BaseStrategyRegistry {
+    upsert(instance) {
+        const target = resolveStrategyMetadataTarget(instance);
+        if (!target) {
+            return;
+        }
+        if (!this.reflector.get(SANDBOX_WORKSPACE_MAPPER, target)) {
+            return;
+        }
+        const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
+        var _this_reflector_get;
+        const scope = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : BUILTIN_GLOBAL_SCOPE;
+        if (pluginName && scope !== SYSTEM_GLOBAL_SCOPE) {
+            this.mapperLogger.warn(`Ignored Sandbox Workspace Mapper from non-system plugin ${pluginName} in scope ${scope}.`);
+            return;
+        }
+        super.upsert(instance);
+    }
+    constructor(discoveryService, reflector){
+        super(SANDBOX_WORKSPACE_MAPPER, discoveryService, reflector);
+        this.mapperLogger = new Logger(SandboxWorkspaceMapperRegistry_1.name);
+    }
+};
+SandboxWorkspaceMapperRegistry = SandboxWorkspaceMapperRegistry_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [
+        DiscoveryService,
+        Reflector
+    ])
+], SandboxWorkspaceMapperRegistry);
+
 const MANAGED_CONNECTION_REGISTRY_TOKEN = 'XPERT_MANAGED_CONNECTION_REGISTRY';
 const CONNECTION_COMMAND_ROUTER_TOKEN = 'XPERT_CONNECTION_COMMAND_ROUTER';
 
@@ -4690,390 +4801,4 @@ CollaborationDocumentProviderRegistry = __decorate([
     ])
 ], CollaborationDocumentProviderRegistry);
 
-function createSocketIoTransportAdapter(socket) {
-    return {
-        get connected () {
-            return socket.connected;
-        },
-        get clientId () {
-            var _socket_id;
-            return (_socket_id = socket.id) != null ? _socket_id : null;
-        },
-        connect: ()=>{
-            socket.connect();
-        },
-        disconnect: ()=>{
-            socket.disconnect();
-        },
-        emit: (event, payload = {})=>{
-            socket.emit(event, payload);
-        },
-        on: (event, handler)=>{
-            socket.on(event, handler);
-            return ()=>{
-                socket.off(event, handler);
-            };
-        }
-    };
-}
-/** Wrap a caller-owned `Y.Doc` without passing it across the runtime capability boundary. */ function createYjsDocumentAdapter(document, yjs) {
-    return {
-        applyUpdate: (update, origin)=>yjs.applyUpdate(document, update, origin),
-        encodeStateVector: ()=>yjs.encodeStateVector(document),
-        mergeUpdates: (updates)=>yjs.mergeUpdates(updates),
-        onUpdate: (handler)=>{
-            document.on('update', handler);
-            return ()=>document.off('update', handler);
-        }
-    };
-}
-/**
- * Keep per-client sessions for cursors while exposing one collaborator per stable actor identity.
- * This prevents a second tab owned by the same user from either duplicating or hiding that user.
- */ function createCollaborationPresenceStore(options = {}) {
-    let selfClientId = null;
-    let sessions = new Map();
-    const readSnapshot = ()=>{
-        const activeSessions = Array.from(sessions.values()).sort((left, right)=>right.updatedAt - left.updatedAt);
-        const remoteSessions = activeSessions.filter((item)=>item.clientId !== selfClientId);
-        const actors = new Map();
-        for (const item of activeSessions)if (!actors.has(item.presenceId)) actors.set(item.presenceId, item);
-        if (options.includeSelf !== false && options.selfActor) {
-            const existing = activeSessions.find((item)=>{
-                var _options_selfActor;
-                return item.clientId === selfClientId || item.presenceId === ((_options_selfActor = options.selfActor) == null ? void 0 : _options_selfActor.presenceId);
-            });
-            actors.set(options.selfActor.presenceId, existing != null ? existing : actorPresence(options.selfActor, selfClientId));
-        }
-        const collaborators = Array.from(actors.values()).sort((left, right)=>{
-            var _options_selfActor, _options_selfActor1;
-            const leftSelf = left.presenceId === ((_options_selfActor = options.selfActor) == null ? void 0 : _options_selfActor.presenceId) ? 1 : 0;
-            const rightSelf = right.presenceId === ((_options_selfActor1 = options.selfActor) == null ? void 0 : _options_selfActor1.presenceId) ? 1 : 0;
-            return rightSelf - leftSelf || right.updatedAt - left.updatedAt;
-        });
-        return {
-            selfClientId,
-            sessions: activeSessions,
-            remoteSessions,
-            collaborators
-        };
-    };
-    const publish = ()=>options.onChange == null ? void 0 : options.onChange.call(options, readSnapshot());
-    return {
-        setSelfClientId: (clientId)=>{
-            selfClientId = clientId;
-            publish();
-        },
-        replace: (items, clientId = selfClientId)=>{
-            selfClientId = clientId;
-            sessions = new Map(items.map((item)=>[
-                    item.clientId,
-                    item
-                ]));
-            publish();
-        },
-        upsert: (item)=>{
-            sessions.set(item.clientId, item);
-            publish();
-        },
-        remove: (clientId)=>{
-            if (sessions.delete(clientId)) publish();
-        },
-        clear: ()=>{
-            sessions.clear();
-            selfClientId = null;
-            publish();
-        },
-        snapshot: readSnapshot
-    };
-}
-/**
- * Create a collaboration client with update batching, state-vector repair, presence heartbeat,
- * and reconnect synchronization. The caller retains ownership of the document and transport.
- */ function createCollaborationClient(options) {
-    const remoteOrigin = Object.freeze({
-        kind: 'platform.collaboration.remote'
-    });
-    const batchMs = positiveInteger(options.batchMs, 40);
-    const syncIntervalMs = positiveInteger(options.syncIntervalMs, 2000);
-    const presenceHeartbeatMs = positiveInteger(options.presenceHeartbeatMs, 5000);
-    const presenceStaleMs = positiveInteger(options.presenceStaleMs, 15000);
-    var _options_initialPresence;
-    let presence = _extends({}, (_options_initialPresence = options.initialPresence) != null ? _options_initialPresence : {});
-    let pending = [];
-    let flushTimer;
-    let syncTimer;
-    let presenceTimer;
-    let presenceCleanupTimer;
-    var _options_transport_clientId;
-    let selfClientId = (_options_transport_clientId = options.transport.clientId) != null ? _options_transport_clientId : null;
-    let started = false;
-    const cleanups = [];
-    const presenceSeenAt = new Map();
-    const reportError = (error)=>options.onError == null ? void 0 : options.onError.call(options, error instanceof Error ? error : new Error(String(error)));
-    const emitPresence = ()=>options.transport.emit('presence', _extends({}, presence));
-    // Merge the short burst of local Yjs transactions into one network update.
-    const flush = ()=>{
-        if (flushTimer) clearTimeout(flushTimer);
-        flushTimer = undefined;
-        if (!pending.length || !options.transport.connected) return;
-        const updates = pending;
-        pending = [];
-        options.transport.emit('update', {
-            updateBase64: bytesToBase64(options.document.mergeUpdates(updates)),
-            origin: 'plugin-client'
-        });
-    };
-    // A state vector lets the server return only bytes missing from this client.
-    const requestSync = ()=>{
-        if (!options.transport.connected) return;
-        options.transport.emit('sync-request', {
-            stateVectorBase64: bytesToBase64(options.document.encodeStateVector())
-        });
-    };
-    // Mark server updates with `remoteOrigin` so the document observer does not send them back.
-    const applyRemote = (payload)=>{
-        const encoded = stringValue(payload['updateBase64']);
-        if (!encoded) return;
-        try {
-            options.document.applyUpdate(base64ToBytes(encoded), remoteOrigin);
-        } catch (error) {
-            reportError(error);
-        }
-    };
-    // Register listeners once, then start repair and presence heartbeats before opening the socket.
-    const connect = ()=>{
-        if (started) return;
-        started = true;
-        options.onConnectionChange == null ? void 0 : options.onConnectionChange.call(options, 'connecting');
-        cleanups.push(options.document.onUpdate((update, origin)=>{
-            if (origin === remoteOrigin) return;
-            pending.push(update);
-            if (!flushTimer) flushTimer = setTimeout(flush, batchMs);
-        }));
-        cleanups.push(options.transport.on('connect', ()=>{
-            var _options_transport_clientId;
-            selfClientId = (_options_transport_clientId = options.transport.clientId) != null ? _options_transport_clientId : selfClientId;
-            options.onConnectionChange == null ? void 0 : options.onConnectionChange.call(options, 'connected');
-            requestSync();
-            emitPresence();
-        }));
-        cleanups.push(options.transport.on('disconnect', ()=>options.onConnectionChange == null ? void 0 : options.onConnectionChange.call(options, 'disconnected')));
-        cleanups.push(options.transport.on('sync', applyRemote));
-        cleanups.push(options.transport.on('update', applyRemote));
-        cleanups.push(options.transport.on('update-ack', (payload)=>{
-            const ack = parseAck(payload);
-            if (ack) options.onAck == null ? void 0 : options.onAck.call(options, ack);
-        }));
-        cleanups.push(options.transport.on('presence', (payload)=>{
-            const item = parsePresence(payload);
-            if (item) {
-                presenceSeenAt.set(item.clientId, Date.now());
-                options.onPresence == null ? void 0 : options.onPresence.call(options, item);
-            }
-        }));
-        cleanups.push(options.transport.on('presence-snapshot', (payload)=>{
-            const rawItems = payload['items'];
-            const items = Array.isArray(rawItems) ? rawItems.map(parsePresence).filter(isPresence) : [];
-            var _stringValue, _ref;
-            selfClientId = (_ref = (_stringValue = stringValue(payload['selfClientId'])) != null ? _stringValue : options.transport.clientId) != null ? _ref : selfClientId;
-            presenceSeenAt.clear();
-            for (const item of items)presenceSeenAt.set(item.clientId, Date.now());
-            options.onPresenceSnapshot == null ? void 0 : options.onPresenceSnapshot.call(options, items, {
-                selfClientId
-            });
-        }));
-        cleanups.push(options.transport.on('presence-remove', (payload)=>{
-            const clientId = stringValue(payload['clientId']);
-            if (clientId) {
-                presenceSeenAt.delete(clientId);
-                options.onPresenceRemove == null ? void 0 : options.onPresenceRemove.call(options, clientId);
-            }
-        }));
-        cleanups.push(options.transport.on('error', (payload)=>{
-            var _stringValue;
-            return reportError((_stringValue = stringValue(payload['message'])) != null ? _stringValue : 'Collaboration failed.');
-        }));
-        syncTimer = setInterval(requestSync, syncIntervalMs);
-        presenceTimer = setInterval(emitPresence, presenceHeartbeatMs);
-        presenceCleanupTimer = setInterval(()=>{
-            const cutoff = Date.now() - presenceStaleMs;
-            for (const [clientId, seenAt] of presenceSeenAt){
-                if (clientId === selfClientId || seenAt >= cutoff) continue;
-                presenceSeenAt.delete(clientId);
-                options.onPresenceRemove == null ? void 0 : options.onPresenceRemove.call(options, clientId);
-            }
-        }, Math.min(5000, Math.max(1000, Math.floor(presenceStaleMs / 3))));
-        options.transport.connect();
-    };
-    // Flush best-effort pending state and release all timers/listeners owned by this client.
-    const disconnect = ()=>{
-        var _cleanups_pop;
-        if (!started) return;
-        flush();
-        started = false;
-        if (flushTimer) clearTimeout(flushTimer);
-        if (syncTimer) clearInterval(syncTimer);
-        if (presenceTimer) clearInterval(presenceTimer);
-        if (presenceCleanupTimer) clearInterval(presenceCleanupTimer);
-        flushTimer = undefined;
-        syncTimer = undefined;
-        presenceTimer = undefined;
-        presenceCleanupTimer = undefined;
-        presenceSeenAt.clear();
-        while(cleanups.length)(_cleanups_pop = cleanups.pop()) == null ? void 0 : _cleanups_pop();
-        options.transport.disconnect();
-        options.onConnectionChange == null ? void 0 : options.onConnectionChange.call(options, 'disconnected');
-    };
-    return {
-        get selfClientId () {
-            return selfClientId;
-        },
-        remoteOrigin,
-        connect,
-        disconnect,
-        flush,
-        requestSync,
-        setPresence: (patch)=>{
-            presence = _extends({}, presence, patch);
-            if (options.transport.connected) emitPresence();
-        }
-    };
-}
-function actorPresence(actor, clientId) {
-    return _extends({}, actor, {
-        clientId: clientId != null ? clientId : `self:${actor.presenceId}`,
-        pageId: null,
-        pointer: null,
-        focus: null,
-        selection: null,
-        viewport: null,
-        mode: null,
-        status: null,
-        toolName: null,
-        operationLabel: null,
-        updatedAt: Date.now()
-    });
-}
-/** Encode bytes in browsers without Node.js `Buffer`; chunks avoid argument-size limits. */ function bytesToBase64(bytes) {
-    let binary = '';
-    const chunkSize = 0x8000;
-    for(let offset = 0; offset < bytes.length; offset += chunkSize){
-        binary += String.fromCharCode(...bytes.subarray(offset, Math.min(offset + chunkSize, bytes.length)));
-    }
-    return globalThis.btoa(binary);
-}
-/** Decode base64 in browsers without requiring Node.js polyfills. */ function base64ToBytes(value) {
-    const binary = globalThis.atob(value);
-    const bytes = new Uint8Array(binary.length);
-    for(let index = 0; index < binary.length; index += 1)bytes[index] = binary.charCodeAt(index);
-    return bytes;
-}
-function parseAck(payload) {
-    const documentId = stringValue(payload['documentId']);
-    const stateVectorBase64 = stringValue(payload['stateVectorBase64']);
-    const sequenceNumber = payload['sequenceNumber'];
-    if (!documentId || !stateVectorBase64 || typeof sequenceNumber !== 'number') return null;
-    const materializationStatus = payload['materializationStatus'];
-    if (materializationStatus !== 'ready' && materializationStatus !== 'pending' && materializationStatus !== 'failed') return null;
-    return {
-        documentId,
-        duplicate: payload['duplicate'] === true,
-        sequenceNumber,
-        updateId: stringValue(payload['updateId']),
-        stateVectorBase64,
-        materializationStatus
-    };
-}
-function parsePresence(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
-    const item = value;
-    const clientId = stringValue(item['clientId']);
-    const presenceId = stringValue(item['presenceId']);
-    const displayName = stringValue(item['displayName']);
-    const color = stringValue(item['color']);
-    const actorType = item['actorType'];
-    if (!clientId || !presenceId || !displayName || !color || actorType !== 'user' && actorType !== 'agent' && actorType !== 'system') return null;
-    return {
-        clientId,
-        presenceId,
-        displayName,
-        color,
-        actorType,
-        avatarUrl: nullableString(item['avatarUrl']),
-        pageId: nullableString(item['pageId']),
-        pointer: parsePointer(item['pointer']),
-        focus: parseFocus(item['focus']),
-        selection: parseSelection(item['selection']),
-        viewport: parseViewport(item['viewport']),
-        mode: nullableString(item['mode']),
-        status: actorStatus(item['status']),
-        toolName: nullableString(item['toolName']),
-        operationLabel: nullableString(item['operationLabel']),
-        updatedAt: typeof item['updatedAt'] === 'number' ? item['updatedAt'] : Date.now()
-    };
-}
-function parsePointer(value) {
-    const item = recordValue(value);
-    if (!item || typeof item['x'] !== 'number' || typeof item['y'] !== 'number') return null;
-    return {
-        pageId: nullableString(item['pageId']),
-        x: item['x'],
-        y: item['y'],
-        visible: item['visible'] !== false
-    };
-}
-function parseFocus(value) {
-    const item = recordValue(value);
-    const kind = item && stringValue(item['kind']);
-    if (!item || !kind) return null;
-    return {
-        kind,
-        key: nullableString(item['key']),
-        pageId: nullableString(item['pageId']),
-        elementId: nullableString(item['elementId']),
-        fieldKey: nullableString(item['fieldKey'])
-    };
-}
-function parseSelection(value) {
-    const item = recordValue(value);
-    const kind = item == null ? void 0 : item['kind'];
-    if (!item || kind !== 'text' && kind !== 'elements') return null;
-    return {
-        kind,
-        fieldKey: nullableString(item['fieldKey']),
-        elementIds: Array.isArray(item['elementIds']) ? item['elementIds'].filter((entry)=>typeof entry === 'string') : null,
-        anchorRelativeBase64: nullableString(item['anchorRelativeBase64']),
-        headRelativeBase64: nullableString(item['headRelativeBase64'])
-    };
-}
-function parseViewport(value) {
-    const item = recordValue(value);
-    if (!item || typeof item['zoom'] !== 'number' || typeof item['width'] !== 'number' || typeof item['height'] !== 'number') return null;
-    return {
-        zoom: item['zoom'],
-        width: item['width'],
-        height: item['height']
-    };
-}
-function recordValue(value) {
-    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
-}
-function isPresence(value) {
-    return value !== null;
-}
-function stringValue(value) {
-    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-function nullableString(value) {
-    var _stringValue;
-    return (_stringValue = stringValue(value)) != null ? _stringValue : null;
-}
-function actorStatus(value) {
-    return value === 'thinking' || value === 'editing' || value === 'done' || value === 'failed' ? value : null;
-}
-function positiveInteger(value, fallback) {
-    return Number.isFinite(value) && Number(value) > 0 ? Math.trunc(Number(value)) : fallback;
-}
-
-export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, ArtifactsRuntimeCapability, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, COLLABORATION_DOCUMENT_PROVIDER, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CollaborationDocumentProvider, CollaborationDocumentProviderRegistry, CollaborationRuntimeCapability, CommonParameterRules, ConnectorRuntimeCapability, ConnectorStrategyKey, ConnectorStrategyRegistry, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DefaultRuntimeCapabilityRegistry as DefaultAgentMiddlewareRuntimeCapabilityRegistry, DefaultRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, PluginJobProcessor, PluginWebhookAuth, PluginWebhookAuthGuard, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SPEECH_TO_TEXT_PERMISSION_SERVICE_TOKEN, SPEECH_TO_TEXT_SERVICE_TOKEN, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SYSTEM_GLOBAL_SCOPE, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TENANT_GLOBAL_SCOPE_PREFIX, TENANT_GLOBAL_SCOPE_SUFFIX, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WORKSPACE_FILES_SOURCE, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WorkspaceFilesRuntimeCapability, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, base64ToBytes, buildSandboxTimeoutMessage, bytesToBase64, calcTokenUsage, chunkText, countTokensSafe, createCollaborationClient, createCollaborationPresenceStore, createI18nInstance, createPluginLogger, createRuntimeCapability, createSocketIoTransportAdapter, createYjsDocumentAdapter, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };
+export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, ArtifactsRuntimeCapability, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, COLLABORATION_DOCUMENT_PROVIDER, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CollaborationDocumentProvider, CollaborationDocumentProviderRegistry, CollaborationRuntimeCapability, CommonParameterRules, ConnectorRuntimeCapability, ConnectorStrategyKey, ConnectorStrategyRegistry, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DefaultRuntimeCapabilityRegistry as DefaultAgentMiddlewareRuntimeCapabilityRegistry, DefaultRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, PluginJobProcessor, PluginWebhookAuth, PluginWebhookAuthGuard, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_JOB_ERROR_CODES, SANDBOX_PROVIDER, SANDBOX_RUNTIME_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SANDBOX_WORKSPACE_MAPPER, SKILL_SOURCE_PROVIDER, SPEECH_TO_TEXT_PERMISSION_SERVICE_TOKEN, SPEECH_TO_TEXT_SERVICE_TOKEN, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SYSTEM_GLOBAL_SCOPE, SandboxJobRuntimeError, SandboxJobsRuntimeCapability, SandboxProviderRegistry, SandboxProviderStrategy, SandboxRuntimeProviderRegistry, SandboxRuntimeProviderStrategy, SandboxWorkspaceMapperRegistry, SandboxWorkspaceMapperStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TENANT_GLOBAL_SCOPE_PREFIX, TENANT_GLOBAL_SCOPE_SUFFIX, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WORKSPACE_FILES_SOURCE, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WorkspaceFilesRuntimeCapability, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isRemoteFile, isSandboxBackend, isSandboxJobRuntimeError, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.15.10",
+  "version": "3.15.12",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@langchain/openai": "0.6.9",
-    "@xpert-ai/contracts": "3.15.10",
+    "@xpert-ai/contracts": "3.15.12",
     "express": "^4.22.1",
     "js-tiktoken": "^1.0.21"
   },
@@ -38,5 +38,20 @@
     "yaml": "*",
     "zod": "*"
   },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "module": "./index.esm.js",
+      "types": "./index.d.ts",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
+    },
+    "./collaboration-client": {
+      "module": "./collaboration-client.esm.js",
+      "types": "./collaboration-client.d.ts",
+      "import": "./collaboration-client.cjs.mjs",
+      "default": "./collaboration-client.cjs.js"
+    }
+  },
   "types": "./index.d.ts"
 }

package/src/collaboration-client.d.ts

@@ -0,0 +1,3 @@
+/** Browser-safe collaboration client entry point without server-side SDK dependencies. */
+export * from './lib/collaboration/client';
+export type * from './lib/collaboration/types';

package/src/lib/agent/middleware/capabilities/assistant-task.d.ts

@@ -15,6 +15,7 @@ export type AgentMiddlewareAssistantTaskInput = {
     xpertId: string;
     agentKey?: string;
     conversationId?: string | null;
+    executionId?: string | null;
     projectId?: string | null;
     taskId?: string;
     clientMessageId?: string;

package/src/lib/core/runtime-capability.d.ts

@@ -7,6 +7,7 @@ export declare function createRuntimeCapability<T>(id: string, options?: {
     description?: string;
 }): RuntimeCapabilityKey<T>;
 export interface RuntimeCapabilityRegistry {
+    register<T>(key: RuntimeCapabilityKey<T> | string, implementation: T): this;
     has<T>(key: RuntimeCapabilityKey<T> | string): boolean;
     get<T>(key: RuntimeCapabilityKey<T> | string): T | undefined;
     require<T>(key: RuntimeCapabilityKey<T> | string): T;