@xpert-ai/plugin-sdk 3.15.10 → 3.15.12

package/index.cjs.js

@@ -3,6 +3,7 @@
 var common = require('@nestjs/common');
 var constants = require('@nestjs/common/constants');
 var lodashEs = require('lodash-es');
+var collaborationClient = require('./collaboration-client.cjs2.js');
 var core = require('@nestjs/core');
 var rxjs = require('rxjs');
 var contracts = require('@xpert-ai/contracts');
@@ -151,28 +152,17 @@ 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 common.Logger(scope);
     const wrap = (level, msg, meta)=>{
         var // Maintain alignment with the Nest Logger interface
         _nestLogger_level;
-        const payload = meta ? _extends({}, baseMeta, meta) : baseMeta;
+        const payload = meta ? collaborationClient._extends({}, baseMeta, meta) : baseMeta;
         (_nestLogger_level = nestLogger[level]) == null ? void 0 : _nestLogger_level.call(nestLogger, msg + (Object.keys(payload).length ? ` ${JSON.stringify(payload)}` : ''));
     };
     return {
         child (meta) {
-            return createPluginLogger(scope, _extends({}, baseMeta, meta));
+            return createPluginLogger(scope, collaborationClient._extends({}, baseMeta, meta));
         },
         debug: (msg, meta)=>wrap('debug', msg, meta),
         log: (msg, meta)=>wrap('log', msg, meta),
@@ -539,10 +529,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;
@@ -650,6 +642,23 @@ __decorate([
     common.Inject(exports.StrategyBus),
     __metadata("design:type", exports.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;
+}
 
 exports.IntegrationStrategyRegistry = class IntegrationStrategyRegistry extends BaseStrategyRegistry {
     constructor(discoveryService, reflector){
@@ -1005,7 +1014,7 @@ class BuiltinToolset extends BaseToolset {
      *
      * @returns Credentials schema
      */ getCredentialsSchema() {
-        return _extends({}, this.credentialsSchema);
+        return collaborationClient._extends({}, this.credentialsSchema);
     }
     /**
      * Get toolset entity
@@ -1318,7 +1327,7 @@ class JsonSchemaValidator {
 const PLUGIN_WEBHOOK_AUTH_METADATA_KEY = 'xpert:plugin:webhook-auth';
 const PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN = 'XPERT_PLUGIN_WEBHOOK_AUTH_SERVICE';
 function PluginWebhookAuth(metadata = {}) {
-    return common.SetMetadata(PLUGIN_WEBHOOK_AUTH_METADATA_KEY, _extends({
+    return common.SetMetadata(PLUGIN_WEBHOOK_AUTH_METADATA_KEY, collaborationClient._extends({
         integrationParam: 'id',
         secretQueryParam: 'secret'
     }, metadata));
@@ -1352,7 +1361,7 @@ exports.PluginWebhookAuthGuard = class PluginWebhookAuthGuard {
         }
         request.user = principalContext.user;
         var _request_headers;
-        request.headers = _extends({}, (_request_headers = request.headers) != null ? _request_headers : {}, principalContext.headers);
+        request.headers = collaborationClient._extends({}, (_request_headers = request.headers) != null ? _request_headers : {}, principalContext.headers);
         return true;
     }
     resolveMetadata(context) {
@@ -2067,7 +2076,7 @@ const CommonParameterRules = [
     }
 ];
 function mergeCredentials(credentials, modelProperties) {
-    return _extends({}, credentials != null ? credentials : {}, modelProperties != null ? modelProperties : {});
+    return collaborationClient._extends({}, credentials != null ? credentials : {}, modelProperties != null ? modelProperties : {});
 }
 
 var AIModel_1;
@@ -2163,7 +2172,7 @@ let AIModel = AIModel_1 = class AIModel {
                 try {
                     const defaultParameterName = valueOf(DefaultParameterName, parameterRule.use_template);
                     const defaultParameterRule = getDefaultParameterRuleVariableMap(defaultParameterName);
-                    const copyDefaultParameterRule = _extends({}, defaultParameterRule, parameterRule);
+                    const copyDefaultParameterRule = collaborationClient._extends({}, defaultParameterRule, parameterRule);
                     parameterRule = copyDefaultParameterRule;
                 } catch (error) {
                 // Handle error if necessary
@@ -2714,7 +2723,7 @@ class Speech2TextChatModel extends chat_models.BaseChatModel {
         if (!apiKey) {
             throw new Error(`Tongyi API key not found. Please set the DASHSCOPE_API_KEY environment variable or pass the key into "apiKey" field.`);
         }
-        super(_extends({}, fields));
+        super(collaborationClient._extends({}, fields));
         this.fields = fields;
         this.apiKey = apiKey;
     }
@@ -2804,6 +2813,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)=>common.applyDecorators(common.SetMetadata(SKILL_SOURCE_PROVIDER, provider), common.SetMetadata(STRATEGY_META_KEY, SKILL_SOURCE_PROVIDER));
 
@@ -4169,6 +4209,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)=>common.applyDecorators(common.SetMetadata(SANDBOX_RUNTIME_PROVIDER, provider), common.SetMetadata(STRATEGY_META_KEY, SANDBOX_RUNTIME_PROVIDER));
+
+var SandboxRuntimeProviderRegistry_1;
+/** Discovers Runtime Provider strategies and rejects organization-scoped executable infrastructure. */ exports.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 common.Logger(SandboxRuntimeProviderRegistry_1.name);
+    }
+};
+exports.SandboxRuntimeProviderRegistry = SandboxRuntimeProviderRegistry_1 = __decorate([
+    common.Injectable(),
+    __metadata("design:paramtypes", [
+        core.DiscoveryService,
+        core.Reflector
+    ])
+], exports.SandboxRuntimeProviderRegistry);
+
+const SANDBOX_WORKSPACE_MAPPER = 'SANDBOX_WORKSPACE_MAPPER';
+/** Associates a workspace path mapper with a named Runtime Provider strategy. */ const SandboxWorkspaceMapperStrategy = (provider)=>common.applyDecorators(common.SetMetadata(SANDBOX_WORKSPACE_MAPPER, provider), common.SetMetadata(STRATEGY_META_KEY, SANDBOX_WORKSPACE_MAPPER));
+
+var SandboxWorkspaceMapperRegistry_1;
+/** Discovers Provider path mappers while enforcing the same system-level trust boundary as Providers. */ exports.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 common.Logger(SandboxWorkspaceMapperRegistry_1.name);
+    }
+};
+exports.SandboxWorkspaceMapperRegistry = SandboxWorkspaceMapperRegistry_1 = __decorate([
+    common.Injectable(),
+    __metadata("design:paramtypes", [
+        core.DiscoveryService,
+        core.Reflector
+    ])
+], exports.SandboxWorkspaceMapperRegistry);
+
 const MANAGED_CONNECTION_REGISTRY_TOKEN = 'XPERT_MANAGED_CONNECTION_REGISTRY';
 const CONNECTION_COMMAND_ROUTER_TOKEN = 'XPERT_CONNECTION_COMMAND_ROUTER';
 
@@ -4196,7 +4306,7 @@ function normalizePluginJobProcessorMetadata(options) {
     if (concurrency !== undefined && (!Number.isFinite(concurrency) || concurrency <= 0)) {
         throw new Error('PluginJobProcessor concurrency must be a positive number');
     }
-    return _extends({
+    return collaborationClient._extends({
         pluginName,
         queueName,
         jobName
@@ -4710,392 +4820,12 @@ exports.CollaborationDocumentProviderRegistry = __decorate([
     ])
 ], exports.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;
-}
-
+exports.base64ToBytes = collaborationClient.base64ToBytes;
+exports.bytesToBase64 = collaborationClient.bytesToBase64;
+exports.createCollaborationClient = collaborationClient.createCollaborationClient;
+exports.createCollaborationPresenceStore = collaborationClient.createCollaborationPresenceStore;
+exports.createSocketIoTransportAdapter = collaborationClient.createSocketIoTransportAdapter;
+exports.createYjsDocumentAdapter = collaborationClient.createYjsDocumentAdapter;
 Object.defineProperty(exports, "ASSISTANT_CHAT_SEND_MESSAGE_COMMAND", {
     enumerable: true,
     get: function () { return contracts.ASSISTANT_CHAT_SEND_MESSAGE_COMMAND; }
@@ -5208,8 +4938,11 @@ exports.RequestContext = RequestContext;
 exports.RequirePermissionOperation = RequirePermissionOperation;
 exports.RerankModel = RerankModel;
 exports.RetrieverStrategy = RetrieverStrategy;
+exports.SANDBOX_JOB_ERROR_CODES = SANDBOX_JOB_ERROR_CODES;
 exports.SANDBOX_PROVIDER = SANDBOX_PROVIDER;
+exports.SANDBOX_RUNTIME_PROVIDER = SANDBOX_RUNTIME_PROVIDER;
 exports.SANDBOX_SHELL_TIMEOUT_LIMITS_SEC = SANDBOX_SHELL_TIMEOUT_LIMITS_SEC;
+exports.SANDBOX_WORKSPACE_MAPPER = SANDBOX_WORKSPACE_MAPPER;
 exports.SKILL_SOURCE_PROVIDER = SKILL_SOURCE_PROVIDER;
 exports.SPEECH_TO_TEXT_PERMISSION_SERVICE_TOKEN = SPEECH_TO_TEXT_PERMISSION_SERVICE_TOKEN;
 exports.SPEECH_TO_TEXT_SERVICE_TOKEN = SPEECH_TO_TEXT_SERVICE_TOKEN;
@@ -5218,7 +4951,11 @@ exports.SSO_BINDING_PERMISSION_SERVICE_TOKEN = SSO_BINDING_PERMISSION_SERVICE_TO
 exports.SSO_PROVIDER = SSO_PROVIDER;
 exports.STRATEGY_META_KEY = STRATEGY_META_KEY;
 exports.SYSTEM_GLOBAL_SCOPE = SYSTEM_GLOBAL_SCOPE;
+exports.SandboxJobRuntimeError = SandboxJobRuntimeError;
+exports.SandboxJobsRuntimeCapability = SandboxJobsRuntimeCapability;
 exports.SandboxProviderStrategy = SandboxProviderStrategy;
+exports.SandboxRuntimeProviderStrategy = SandboxRuntimeProviderStrategy;
+exports.SandboxWorkspaceMapperStrategy = SandboxWorkspaceMapperStrategy;
 exports.SkillSourceProviderStrategy = SkillSourceProviderStrategy;
 exports.Speech2TextChatModel = Speech2TextChatModel;
 exports.SpeechToTextModel = SpeechToTextModel;
@@ -5248,19 +4985,13 @@ exports.XpFileSystem = XpFileSystem;
 exports.XpertServerPlugin = XpertServerPlugin;
 exports.als = als;
 exports.appendSandboxMessage = appendSandboxMessage;
-exports.base64ToBytes = base64ToBytes;
 exports.buildSandboxTimeoutMessage = buildSandboxTimeoutMessage;
-exports.bytesToBase64 = bytesToBase64;
 exports.calcTokenUsage = calcTokenUsage;
 exports.chunkText = chunkText;
 exports.countTokensSafe = countTokensSafe;
-exports.createCollaborationClient = createCollaborationClient;
-exports.createCollaborationPresenceStore = createCollaborationPresenceStore;
 exports.createI18nInstance = createI18nInstance;
 exports.createPluginLogger = createPluginLogger;
 exports.createRuntimeCapability = createRuntimeCapability;
-exports.createSocketIoTransportAdapter = createSocketIoTransportAdapter;
-exports.createYjsDocumentAdapter = createYjsDocumentAdapter;
 exports.defineAgentMessageType = defineAgentMessageType;
 exports.defineChannelMessageType = defineChannelMessageType;
 exports.derivePluginArtifactNamespace = derivePluginArtifactNamespace;
@@ -5277,9 +5008,11 @@ exports.getRequiredPermissionOperation = getRequiredPermissionOperation;
 exports.getTenantGlobalScopeKey = getTenantGlobalScopeKey;
 exports.isRemoteFile = isRemoteFile;
 exports.isSandboxBackend = isSandboxBackend;
+exports.isSandboxJobRuntimeError = isSandboxJobRuntimeError;
 exports.isSandboxManagedServiceAdapter = isSandboxManagedServiceAdapter;
 exports.isSandboxServiceProxyAdapter = isSandboxServiceProxyAdapter;
 exports.isSandboxTerminalAdapter = isSandboxTerminalAdapter;
+exports.isStrategyInstance = isStrategyInstance;
 exports.isStructuredMessageType = isStructuredMessageType;
 exports.isTenantGlobalScopeKey = isTenantGlobalScopeKey;
 exports.loadYamlFile = loadYamlFile;
@@ -5295,6 +5028,7 @@ exports.resolveSandboxExecutionOptions = resolveSandboxExecutionOptions;
 exports.resolveSandboxManagedServiceAdapter = resolveSandboxManagedServiceAdapter;
 exports.resolveSandboxServiceProxyAdapter = resolveSandboxServiceProxyAdapter;
 exports.resolveSandboxTerminalAdapter = resolveSandboxTerminalAdapter;
+exports.resolveStrategyMetadataTarget = resolveStrategyMetadataTarget;
 exports.resolveTenantGlobalScopeKey = resolveTenantGlobalScopeKey;
 exports.runWithRequestContext = runWithRequestContext;
 exports.secondsToMilliseconds = secondsToMilliseconds;