@xpert-ai/plugin-sdk 3.7.1 → 3.8.0

package/index.cjs.js

@@ -4,6 +4,7 @@ var common = require('@nestjs/common');
 var constants = require('@nestjs/common/constants');
 var lodashEs = require('lodash-es');
 var core = require('@nestjs/core');
+var rxjs = require('rxjs');
 var contracts = require('@metad/contracts');
 var node_async_hooks = require('node:async_hooks');
 var passportJwt = require('passport-jwt');
@@ -20,6 +21,8 @@ var path = require('path');
 var i18next = require('i18next');
 var FsBackend = require('i18next-fs-backend');
 var yaml = require('yaml');
+var Ajv = require('ajv');
+var schemaDraft04 = require('ajv/dist/refs/json-schema-draft-06.json');
 var _axios = require('axios');
 var openai = require('@langchain/openai');
 var documents = require('@langchain/core/documents');
@@ -27,6 +30,7 @@ var chat_models = require('@langchain/core/language_models/chat_models');
 var messages = require('@langchain/core/messages');
 var env = require('@langchain/core/utils/env');
 require('js-tiktoken');
+var base = require('@langchain/core/language_models/base');
 
 function _interopNamespaceDefault(e) {
 	var n = Object.create(null);
@@ -122,44 +126,6 @@ function createPluginLogger(scope, baseMeta = {}) {
 const INTEGRATION_STRATEGY = 'INTEGRATION_STRATEGY';
 const IntegrationStrategyKey = (provider)=>common.applyDecorators(common.SetMetadata(INTEGRATION_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, INTEGRATION_STRATEGY));
 
-/******************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */ /* global Reflect, Promise, SuppressedError, Symbol, Iterator */ function _instanceof$2(left, right) {
-    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
-        return !!right[Symbol.hasInstance](left);
-    } else {
-        return left instanceof right;
-    }
-}
-var extendStatics = function extendStatics1(d, b) {
-    extendStatics = Object.setPrototypeOf || _instanceof$2({
-        __proto__: []
-    }, Array) && function(d, b) {
-        d.__proto__ = b;
-    } || function(d, b) {
-        for(var p in b)if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p];
-    };
-    return extendStatics(d, b);
-};
-function __extends(d, b) {
-    if (typeof b !== "function" && b !== null) throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-    extendStatics(d, b);
-    function __() {
-        this.constructor = d;
-    }
-    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-}
 function __decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -169,763 +135,11 @@ function __decorate(decorators, target, key, desc) {
 function __metadata(metadataKey, metadataValue) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
 }
-function __values(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function next() {
-            if (o && i >= o.length) o = void 0;
-            return {
-                value: o && o[i++],
-                done: !o
-            };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-}
-function __read(o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while((n === void 0 || n-- > 0) && !(r = i.next()).done)ar.push(r.value);
-    } catch (error) {
-        e = {
-            error: error
-        };
-    } finally{
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        } finally{
-            if (e) throw e.error;
-        }
-    }
-    return ar;
-}
-function __spreadArray(to, from, pack) {
-    if (pack || arguments.length === 2) for(var i = 0, l = from.length, ar; i < l; i++){
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-}
 typeof SuppressedError === "function" ? SuppressedError : function _SuppressedError(error, suppressed, message) {
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-function isFunction(value) {
-    return typeof value === "function";
-}
-
-function createErrorClass(createImpl) {
-    var _super = function _super(instance) {
-        Error.call(instance);
-        instance.stack = new Error().stack;
-    };
-    var ctorFunc = createImpl(_super);
-    ctorFunc.prototype = Object.create(Error.prototype);
-    ctorFunc.prototype.constructor = ctorFunc;
-    return ctorFunc;
-}
-
-var UnsubscriptionError = createErrorClass(function(_super) {
-    return function UnsubscriptionErrorImpl(errors) {
-        _super(this);
-        this.message = errors ? errors.length + " errors occurred during unsubscription:\n" + errors.map(function(err, i) {
-            return i + 1 + ") " + err.toString();
-        }).join("\n  ") : "";
-        this.name = "UnsubscriptionError";
-        this.errors = errors;
-    };
-});
-
-function arrRemove(arr, item) {
-    if (arr) {
-        var index = arr.indexOf(item);
-        0 <= index && arr.splice(index, 1);
-    }
-}
-
-function _instanceof$1(left, right) {
-    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
-        return !!right[Symbol.hasInstance](left);
-    } else {
-        return left instanceof right;
-    }
-}
-var Subscription = function() {
-    function Subscription(initialTeardown) {
-        this.initialTeardown = initialTeardown;
-        this.closed = false;
-        this._parentage = null;
-        this._finalizers = null;
-    }
-    Subscription.prototype.unsubscribe = function() {
-        var e_1, _a, e_2, _b;
-        var errors;
-        if (!this.closed) {
-            this.closed = true;
-            var _parentage = this._parentage;
-            if (_parentage) {
-                this._parentage = null;
-                if (Array.isArray(_parentage)) {
-                    try {
-                        for(var _parentage_1 = __values(_parentage), _parentage_1_1 = _parentage_1.next(); !_parentage_1_1.done; _parentage_1_1 = _parentage_1.next()){
-                            var parent_1 = _parentage_1_1.value;
-                            parent_1.remove(this);
-                        }
-                    } catch (e_1_1) {
-                        e_1 = {
-                            error: e_1_1
-                        };
-                    } finally{
-                        try {
-                            if (_parentage_1_1 && !_parentage_1_1.done && (_a = _parentage_1.return)) _a.call(_parentage_1);
-                        } finally{
-                            if (e_1) throw e_1.error;
-                        }
-                    }
-                } else {
-                    _parentage.remove(this);
-                }
-            }
-            var initialFinalizer = this.initialTeardown;
-            if (isFunction(initialFinalizer)) {
-                try {
-                    initialFinalizer();
-                } catch (e) {
-                    errors = _instanceof$1(e, UnsubscriptionError) ? e.errors : [
-                        e
-                    ];
-                }
-            }
-            var _finalizers = this._finalizers;
-            if (_finalizers) {
-                this._finalizers = null;
-                try {
-                    for(var _finalizers_1 = __values(_finalizers), _finalizers_1_1 = _finalizers_1.next(); !_finalizers_1_1.done; _finalizers_1_1 = _finalizers_1.next()){
-                        var finalizer = _finalizers_1_1.value;
-                        try {
-                            execFinalizer(finalizer);
-                        } catch (err) {
-                            errors = errors !== null && errors !== void 0 ? errors : [];
-                            if (_instanceof$1(err, UnsubscriptionError)) {
-                                errors = __spreadArray(__spreadArray([], __read(errors)), __read(err.errors));
-                            } else {
-                                errors.push(err);
-                            }
-                        }
-                    }
-                } catch (e_2_1) {
-                    e_2 = {
-                        error: e_2_1
-                    };
-                } finally{
-                    try {
-                        if (_finalizers_1_1 && !_finalizers_1_1.done && (_b = _finalizers_1.return)) _b.call(_finalizers_1);
-                    } finally{
-                        if (e_2) throw e_2.error;
-                    }
-                }
-            }
-            if (errors) {
-                throw new UnsubscriptionError(errors);
-            }
-        }
-    };
-    Subscription.prototype.add = function(teardown) {
-        var _a;
-        if (teardown && teardown !== this) {
-            if (this.closed) {
-                execFinalizer(teardown);
-            } else {
-                if (_instanceof$1(teardown, Subscription)) {
-                    if (teardown.closed || teardown._hasParent(this)) {
-                        return;
-                    }
-                    teardown._addParent(this);
-                }
-                (this._finalizers = (_a = this._finalizers) !== null && _a !== void 0 ? _a : []).push(teardown);
-            }
-        }
-    };
-    Subscription.prototype._hasParent = function(parent) {
-        var _parentage = this._parentage;
-        return _parentage === parent || Array.isArray(_parentage) && _parentage.includes(parent);
-    };
-    Subscription.prototype._addParent = function(parent) {
-        var _parentage = this._parentage;
-        this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [
-            _parentage,
-            parent
-        ] : parent;
-    };
-    Subscription.prototype._removeParent = function(parent) {
-        var _parentage = this._parentage;
-        if (_parentage === parent) {
-            this._parentage = null;
-        } else if (Array.isArray(_parentage)) {
-            arrRemove(_parentage, parent);
-        }
-    };
-    Subscription.prototype.remove = function(teardown) {
-        var _finalizers = this._finalizers;
-        _finalizers && arrRemove(_finalizers, teardown);
-        if (_instanceof$1(teardown, Subscription)) {
-            teardown._removeParent(this);
-        }
-    };
-    Subscription.EMPTY = function() {
-        var empty = new Subscription();
-        empty.closed = true;
-        return empty;
-    }();
-    return Subscription;
-}();
-var EMPTY_SUBSCRIPTION = Subscription.EMPTY;
-function isSubscription(value) {
-    return _instanceof$1(value, Subscription) || value && "closed" in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe);
-}
-function execFinalizer(finalizer) {
-    if (isFunction(finalizer)) {
-        finalizer();
-    } else {
-        finalizer.unsubscribe();
-    }
-}
-
-var config = {
-    Promise: undefined};
-
-var timeoutProvider = {
-    setTimeout: function setTimeout1(handler, timeout) {
-        var args = [];
-        for(var _i = 2; _i < arguments.length; _i++){
-            args[_i - 2] = arguments[_i];
-        }
-        return setTimeout.apply(void 0, __spreadArray([
-            handler,
-            timeout
-        ], __read(args)));
-    },
-    clearTimeout: function clearTimeout1(handle) {
-        return (clearTimeout)(handle);
-    },
-    delegate: undefined
-};
-
-function reportUnhandledError(err) {
-    timeoutProvider.setTimeout(function() {
-        {
-            throw err;
-        }
-    });
-}
-
-function noop() {}
-
-function errorContext(cb) {
-    {
-        cb();
-    }
-}
-
-var Subscriber = function(_super) {
-    __extends(Subscriber, _super);
-    function Subscriber(destination) {
-        var _this = _super.call(this) || this;
-        _this.isStopped = false;
-        if (destination) {
-            _this.destination = destination;
-            if (isSubscription(destination)) {
-                destination.add(_this);
-            }
-        } else {
-            _this.destination = EMPTY_OBSERVER;
-        }
-        return _this;
-    }
-    Subscriber.create = function(next, error, complete) {
-        return new SafeSubscriber(next, error, complete);
-    };
-    Subscriber.prototype.next = function(value) {
-        if (this.isStopped) ; else {
-            this._next(value);
-        }
-    };
-    Subscriber.prototype.error = function(err) {
-        if (this.isStopped) ; else {
-            this.isStopped = true;
-            this._error(err);
-        }
-    };
-    Subscriber.prototype.complete = function() {
-        if (this.isStopped) ; else {
-            this.isStopped = true;
-            this._complete();
-        }
-    };
-    Subscriber.prototype.unsubscribe = function() {
-        if (!this.closed) {
-            this.isStopped = true;
-            _super.prototype.unsubscribe.call(this);
-            this.destination = null;
-        }
-    };
-    Subscriber.prototype._next = function(value) {
-        this.destination.next(value);
-    };
-    Subscriber.prototype._error = function(err) {
-        try {
-            this.destination.error(err);
-        } finally{
-            this.unsubscribe();
-        }
-    };
-    Subscriber.prototype._complete = function() {
-        try {
-            this.destination.complete();
-        } finally{
-            this.unsubscribe();
-        }
-    };
-    return Subscriber;
-}(Subscription);
-var ConsumerObserver = function() {
-    function ConsumerObserver(partialObserver) {
-        this.partialObserver = partialObserver;
-    }
-    ConsumerObserver.prototype.next = function(value) {
-        var partialObserver = this.partialObserver;
-        if (partialObserver.next) {
-            try {
-                partialObserver.next(value);
-            } catch (error) {
-                handleUnhandledError(error);
-            }
-        }
-    };
-    ConsumerObserver.prototype.error = function(err) {
-        var partialObserver = this.partialObserver;
-        if (partialObserver.error) {
-            try {
-                partialObserver.error(err);
-            } catch (error) {
-                handleUnhandledError(error);
-            }
-        } else {
-            handleUnhandledError(err);
-        }
-    };
-    ConsumerObserver.prototype.complete = function() {
-        var partialObserver = this.partialObserver;
-        if (partialObserver.complete) {
-            try {
-                partialObserver.complete();
-            } catch (error) {
-                handleUnhandledError(error);
-            }
-        }
-    };
-    return ConsumerObserver;
-}();
-var SafeSubscriber = function(_super) {
-    __extends(SafeSubscriber, _super);
-    function SafeSubscriber(observerOrNext, error, complete) {
-        var _this = _super.call(this) || this;
-        var partialObserver;
-        if (isFunction(observerOrNext) || !observerOrNext) {
-            partialObserver = {
-                next: observerOrNext !== null && observerOrNext !== void 0 ? observerOrNext : undefined,
-                error: error !== null && error !== void 0 ? error : undefined,
-                complete: complete !== null && complete !== void 0 ? complete : undefined
-            };
-        } else {
-            {
-                partialObserver = observerOrNext;
-            }
-        }
-        _this.destination = new ConsumerObserver(partialObserver);
-        return _this;
-    }
-    return SafeSubscriber;
-}(Subscriber);
-function handleUnhandledError(error) {
-    {
-        reportUnhandledError(error);
-    }
-}
-function defaultErrorHandler(err) {
-    throw err;
-}
-var EMPTY_OBSERVER = {
-    closed: true,
-    next: noop,
-    error: defaultErrorHandler,
-    complete: noop
-};
-
-var observable = function() {
-    return typeof Symbol === "function" && Symbol.observable || "@@observable";
-}();
-
-function identity(x) {
-    return x;
-}
-
-function pipeFromArray(fns) {
-    if (fns.length === 0) {
-        return identity;
-    }
-    if (fns.length === 1) {
-        return fns[0];
-    }
-    return function piped(input) {
-        return fns.reduce(function(prev, fn) {
-            return fn(prev);
-        }, input);
-    };
-}
-
-function _instanceof(left, right) {
-    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
-        return !!right[Symbol.hasInstance](left);
-    } else {
-        return left instanceof right;
-    }
-}
-var Observable = function() {
-    function Observable(subscribe) {
-        if (subscribe) {
-            this._subscribe = subscribe;
-        }
-    }
-    Observable.prototype.lift = function(operator) {
-        var observable = new Observable();
-        observable.source = this;
-        observable.operator = operator;
-        return observable;
-    };
-    Observable.prototype.subscribe = function(observerOrNext, error, complete) {
-        var _this = this;
-        var subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);
-        errorContext(function() {
-            var _a = _this, operator = _a.operator, source = _a.source;
-            subscriber.add(operator ? operator.call(subscriber, source) : source ? _this._subscribe(subscriber) : _this._trySubscribe(subscriber));
-        });
-        return subscriber;
-    };
-    Observable.prototype._trySubscribe = function(sink) {
-        try {
-            return this._subscribe(sink);
-        } catch (err) {
-            sink.error(err);
-        }
-    };
-    Observable.prototype.forEach = function(next, promiseCtor) {
-        var _this = this;
-        promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve, reject) {
-            var subscriber = new SafeSubscriber({
-                next: function next1(value) {
-                    try {
-                        next(value);
-                    } catch (err) {
-                        reject(err);
-                        subscriber.unsubscribe();
-                    }
-                },
-                error: reject,
-                complete: resolve
-            });
-            _this.subscribe(subscriber);
-        });
-    };
-    Observable.prototype._subscribe = function(subscriber) {
-        var _a;
-        return (_a = this.source) === null || _a === void 0 ? void 0 : _a.subscribe(subscriber);
-    };
-    Observable.prototype[observable] = function() {
-        return this;
-    };
-    Observable.prototype.pipe = function() {
-        var operations = [];
-        for(var _i = 0; _i < arguments.length; _i++){
-            operations[_i] = arguments[_i];
-        }
-        return pipeFromArray(operations)(this);
-    };
-    Observable.prototype.toPromise = function(promiseCtor) {
-        var _this = this;
-        promiseCtor = getPromiseCtor(promiseCtor);
-        return new promiseCtor(function(resolve, reject) {
-            var value;
-            _this.subscribe(function(x) {
-                return value = x;
-            }, function(err) {
-                return reject(err);
-            }, function() {
-                return resolve(value);
-            });
-        });
-    };
-    Observable.create = function(subscribe) {
-        return new Observable(subscribe);
-    };
-    return Observable;
-}();
-function getPromiseCtor(promiseCtor) {
-    var _a;
-    return (_a = promiseCtor !== null && promiseCtor !== void 0 ? promiseCtor : config.Promise) !== null && _a !== void 0 ? _a : Promise;
-}
-function isObserver(value) {
-    return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);
-}
-function isSubscriber(value) {
-    return value && _instanceof(value, Subscriber) || isObserver(value) && isSubscription(value);
-}
-
-function hasLift(source) {
-    return isFunction(source === null || source === void 0 ? void 0 : source.lift);
-}
-function operate(init) {
-    return function(source) {
-        if (hasLift(source)) {
-            return source.lift(function(liftedSource) {
-                try {
-                    return init(liftedSource, this);
-                } catch (err) {
-                    this.error(err);
-                }
-            });
-        }
-        throw new TypeError("Unable to lift unknown Observable type");
-    };
-}
-
-function createOperatorSubscriber(destination, onNext, onComplete, onError, onFinalize) {
-    return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);
-}
-var OperatorSubscriber = function(_super) {
-    __extends(OperatorSubscriber, _super);
-    function OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize, shouldUnsubscribe) {
-        var _this = _super.call(this, destination) || this;
-        _this.onFinalize = onFinalize;
-        _this.shouldUnsubscribe = shouldUnsubscribe;
-        _this._next = onNext ? function(value) {
-            try {
-                onNext(value);
-            } catch (err) {
-                destination.error(err);
-            }
-        } : _super.prototype._next;
-        _this._error = onError ? function(err) {
-            try {
-                onError(err);
-            } catch (err) {
-                destination.error(err);
-            } finally{
-                this.unsubscribe();
-            }
-        } : _super.prototype._error;
-        _this._complete = onComplete ? function() {
-            try {
-                onComplete();
-            } catch (err) {
-                destination.error(err);
-            } finally{
-                this.unsubscribe();
-            }
-        } : _super.prototype._complete;
-        return _this;
-    }
-    OperatorSubscriber.prototype.unsubscribe = function() {
-        var _a;
-        if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {
-            var closed_1 = this.closed;
-            _super.prototype.unsubscribe.call(this);
-            !closed_1 && ((_a = this.onFinalize) === null || _a === void 0 ? void 0 : _a.call(this));
-        }
-    };
-    return OperatorSubscriber;
-}(Subscriber);
-
-var ObjectUnsubscribedError = createErrorClass(function(_super) {
-    return function ObjectUnsubscribedErrorImpl() {
-        _super(this);
-        this.name = "ObjectUnsubscribedError";
-        this.message = "object unsubscribed";
-    };
-});
-
-var Subject = function(_super) {
-    __extends(Subject, _super);
-    function Subject() {
-        var _this = _super.call(this) || this;
-        _this.closed = false;
-        _this.currentObservers = null;
-        _this.observers = [];
-        _this.isStopped = false;
-        _this.hasError = false;
-        _this.thrownError = null;
-        return _this;
-    }
-    Subject.prototype.lift = function(operator) {
-        var subject = new AnonymousSubject(this, this);
-        subject.operator = operator;
-        return subject;
-    };
-    Subject.prototype._throwIfClosed = function() {
-        if (this.closed) {
-            throw new ObjectUnsubscribedError();
-        }
-    };
-    Subject.prototype.next = function(value) {
-        var _this = this;
-        errorContext(function() {
-            var e_1, _a;
-            _this._throwIfClosed();
-            if (!_this.isStopped) {
-                if (!_this.currentObservers) {
-                    _this.currentObservers = Array.from(_this.observers);
-                }
-                try {
-                    for(var _b = __values(_this.currentObservers), _c = _b.next(); !_c.done; _c = _b.next()){
-                        var observer = _c.value;
-                        observer.next(value);
-                    }
-                } catch (e_1_1) {
-                    e_1 = {
-                        error: e_1_1
-                    };
-                } finally{
-                    try {
-                        if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-                    } finally{
-                        if (e_1) throw e_1.error;
-                    }
-                }
-            }
-        });
-    };
-    Subject.prototype.error = function(err) {
-        var _this = this;
-        errorContext(function() {
-            _this._throwIfClosed();
-            if (!_this.isStopped) {
-                _this.hasError = _this.isStopped = true;
-                _this.thrownError = err;
-                var observers = _this.observers;
-                while(observers.length){
-                    observers.shift().error(err);
-                }
-            }
-        });
-    };
-    Subject.prototype.complete = function() {
-        var _this = this;
-        errorContext(function() {
-            _this._throwIfClosed();
-            if (!_this.isStopped) {
-                _this.isStopped = true;
-                var observers = _this.observers;
-                while(observers.length){
-                    observers.shift().complete();
-                }
-            }
-        });
-    };
-    Subject.prototype.unsubscribe = function() {
-        this.isStopped = this.closed = true;
-        this.observers = this.currentObservers = null;
-    };
-    Object.defineProperty(Subject.prototype, "observed", {
-        get: function get() {
-            var _a;
-            return ((_a = this.observers) === null || _a === void 0 ? void 0 : _a.length) > 0;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Subject.prototype._trySubscribe = function(subscriber) {
-        this._throwIfClosed();
-        return _super.prototype._trySubscribe.call(this, subscriber);
-    };
-    Subject.prototype._subscribe = function(subscriber) {
-        this._throwIfClosed();
-        this._checkFinalizedStatuses(subscriber);
-        return this._innerSubscribe(subscriber);
-    };
-    Subject.prototype._innerSubscribe = function(subscriber) {
-        var _this = this;
-        var _a = this, hasError = _a.hasError, isStopped = _a.isStopped, observers = _a.observers;
-        if (hasError || isStopped) {
-            return EMPTY_SUBSCRIPTION;
-        }
-        this.currentObservers = null;
-        observers.push(subscriber);
-        return new Subscription(function() {
-            _this.currentObservers = null;
-            arrRemove(observers, subscriber);
-        });
-    };
-    Subject.prototype._checkFinalizedStatuses = function(subscriber) {
-        var _a = this, hasError = _a.hasError, thrownError = _a.thrownError, isStopped = _a.isStopped;
-        if (hasError) {
-            subscriber.error(thrownError);
-        } else if (isStopped) {
-            subscriber.complete();
-        }
-    };
-    Subject.prototype.asObservable = function() {
-        var observable = new Observable();
-        observable.source = this;
-        return observable;
-    };
-    Subject.create = function(destination, source) {
-        return new AnonymousSubject(destination, source);
-    };
-    return Subject;
-}(Observable);
-var AnonymousSubject = function(_super) {
-    __extends(AnonymousSubject, _super);
-    function AnonymousSubject(destination, source) {
-        var _this = _super.call(this) || this;
-        _this.destination = destination;
-        _this.source = source;
-        return _this;
-    }
-    AnonymousSubject.prototype.next = function(value) {
-        var _a, _b;
-        (_b = (_a = this.destination) === null || _a === void 0 ? void 0 : _a.next) === null || _b === void 0 ? void 0 : _b.call(_a, value);
-    };
-    AnonymousSubject.prototype.error = function(err) {
-        var _a, _b;
-        (_b = (_a = this.destination) === null || _a === void 0 ? void 0 : _a.error) === null || _b === void 0 ? void 0 : _b.call(_a, err);
-    };
-    AnonymousSubject.prototype.complete = function() {
-        var _a, _b;
-        (_b = (_a = this.destination) === null || _a === void 0 ? void 0 : _a.complete) === null || _b === void 0 ? void 0 : _b.call(_a);
-    };
-    AnonymousSubject.prototype._subscribe = function(subscriber) {
-        var _a, _b;
-        return (_b = (_a = this.source) === null || _a === void 0 ? void 0 : _a.subscribe(subscriber)) !== null && _b !== void 0 ? _b : EMPTY_SUBSCRIPTION;
-    };
-    return AnonymousSubject;
-}(Subject);
-
-function filter(predicate, thisArg) {
-    return operate(function(source, subscriber) {
-        var index = 0;
-        source.subscribe(createOperatorSubscriber(subscriber, function(value) {
-            return predicate.call(thisArg, value, index++) && subscriber.next(value);
-        }));
-    });
-}
-
 // request-context.ts
 class RequestContext {
     static currentRequestContext() {
@@ -1158,7 +372,7 @@ exports.StrategyBus = class StrategyBus {
         });
     }
     constructor(){
-        this.subject = new Subject();
+        this.subject = new rxjs.Subject();
         this.events$ = this.subject.asObservable();
     }
 };
@@ -1168,8 +382,7 @@ exports.StrategyBus = __decorate([
 
 class BaseStrategyRegistry {
     onModuleInit() {
-        this.bus.events$.pipe(filter((event)=>!event.strategyType || event.strategyType === this.strategyKey)).subscribe((evt)=>{
-            this.logger.debug(`Received strategy bus event: ${JSON.stringify(evt)}`);
+        this.bus.events$.pipe(rxjs.filter((event)=>!event.strategyType || event.strategyType === this.strategyKey)).subscribe((evt)=>{
             if (evt.type === 'UPSERT') {
                 this.upsert(evt.entry.instance);
             } else if (evt.type === 'REMOVE') {
@@ -1739,6 +952,52 @@ BuiltinToolset.provider = '';
     }
 }
 
+/**
+ * System token for resolving integration read service from plugin context.
+ */ const INTEGRATION_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_INTEGRATION_PERMISSION_SERVICE';
+
+/**
+ * System token for resolving analytics permission service from plugin context.
+ */ const ANALYTICS_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_ANALYTICS_PERMISSION_SERVICE';
+
+const PERMISSION_OPERATION_METADATA_KEY = 'XPERT_PLUGIN_PERMISSION_OPERATION';
+function RequirePermissionOperation(permissionType, operation) {
+    return (_target, _propertyKey, descriptor)=>{
+        const method = descriptor.value;
+        if (typeof method !== 'function') {
+            throw new Error('RequirePermissionOperation can only be applied to methods');
+        }
+        Reflect.defineMetadata(PERMISSION_OPERATION_METADATA_KEY, {
+            permissionType,
+            operation
+        }, method);
+    };
+}
+function getPermissionOperationMetadata(method) {
+    if (typeof method !== 'function') {
+        return undefined;
+    }
+    return Reflect.getMetadata(PERMISSION_OPERATION_METADATA_KEY, method);
+}
+function getRequiredPermissionOperation(method, permissionType) {
+    const metadata = getPermissionOperationMetadata(method);
+    if (!metadata || metadata.permissionType !== permissionType) {
+        return undefined;
+    }
+    return metadata.operation;
+}
+
+/**
+ * System token for resolving handoff queue service from plugin context.
+ */ const HANDOFF_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_HANDOFF_PERMISSION_SERVICE';
+/**
+ * Internal system token used by core to expose the handoff queue bridge.
+ */ const HANDOFF_QUEUE_SERVICE_TOKEN = 'XPERT_HANDOFF_QUEUE_SERVICE';
+
+/**
+ * System token for resolving user permission service from plugin context.
+ */ const USER_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_USER_PERMISSION_SERVICE';
+
 async function createI18nInstance(pluginDir, language) {
     const instance = i18next.createInstance();
     const i18nDir = path.join(pluginDir, 'i18n');
@@ -1818,6 +1077,28 @@ function getErrorMessage(err) {
     }
     return error;
 }
+class JsonSchemaValidator {
+    parseAndValidate(schemaStr) {
+        if (!schemaStr) return undefined;
+        let schema;
+        try {
+            schema = JSON.parse(schemaStr);
+        } catch (e) {
+            throw new Error('Schema is not valid JSON');
+        }
+        const validate = this.ajv.getSchema(schemaDraft04.$id);
+        if (!validate(schema)) {
+            throw new Error('Invalid JSON Schema: ' + this.ajv.errorsText(validate.errors));
+        }
+        return schema;
+    }
+    constructor(){
+        this.ajv = new Ajv({
+            strict: false
+        });
+        this.ajv.addMetaSchema(schemaDraft04);
+    }
+}
 
 const DATASOURCE_STRATEGY = 'DATASOURCE_STRATEGY';
 const DataSourceStrategy = (provider)=>common.applyDecorators(common.SetMetadata(DATASOURCE_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, DATASOURCE_STRATEGY));
@@ -2131,6 +1412,18 @@ function AIModelProviderStrategy(provider) {
     if (file == null ? void 0 : file.startsWith('file:///')) {
         file = file.replace('file://', '');
     }
+    // Strip :line:col suffix (e.g. "/path/file.js:37:5" -> "/path/file.js")
+    if (file) {
+        file = file.replace(/:\d+:\d+$/, '');
+    }
+    // Decode URL-encoded paths (e.g. Chinese characters: %E9%A1%B9%E7%9B%AE -> 项目)
+    if (file) {
+        try {
+            file = decodeURIComponent(file);
+        } catch (e) {
+        // keep as-is if decode fails
+        }
+    }
     const dir = file ? path.dirname(file) : process.cwd();
     return function(target) {
         common.SetMetadata(STRATEGY_META_KEY, AI_MODEL_PROVIDER)(target);
@@ -2425,6 +1718,46 @@ const PARAMETER_RULE_TEMPLATE = {
     }
 };
 
+const CommonParameterRules = [
+    {
+        name: 'temperature',
+        label: {
+            zh_Hans: '温度',
+            en_US: `Temperature`
+        },
+        type: contracts.ParameterType.FLOAT,
+        help: {
+            zh_Hans: '控制模型输出的随机性。较高的值（例如 1.0）使响应更具创意，而较低的值（例如 0.1）使响应更具确定性和重点性。',
+            en_US: `Controls the randomness of the model's output. A higher value (e.g., 1.0) makes responses more creative, while a lower value (e.g., 0.1) makes them more deterministic and focused.`
+        },
+        required: false,
+        default: 0.2,
+        min: 0,
+        max: 1,
+        precision: 0.1
+    },
+    {
+        label: {
+            zh_Hans: '最大尝试次数',
+            en_US: 'The maximum number of attempts'
+        },
+        type: contracts.ParameterType.INT,
+        help: {
+            zh_Hans: '如果请求由于网络超时或速率限制等问题而失败，系统将尝试重新发送请求的最大次数',
+            en_US: 'The maximum number of attempts the system will make to resend a request if it fails due to issues like network timeouts or rate limits'
+        },
+        required: false,
+        default: 6,
+        min: 0,
+        max: 10,
+        precision: 0,
+        name: 'maxRetries'
+    }
+];
+function mergeCredentials(credentials, modelProperties) {
+    return _extends({}, credentials != null ? credentials : {}, modelProperties != null ? modelProperties : {});
+}
+
 let AIModel = class AIModel {
     getChatModel(copilotModel, options) {
         throw new Error(`Unsupport chat model!`);
@@ -2568,6 +1901,15 @@ let AIModel = class AIModel {
             ...parameterRules.filter((_)=>!CommonParameterRules.some((r)=>r.name === _.name))
         ];
     }
+    getModelProfile(model, credentials) {
+        var _modelSchema_model_properties, _modelSchema_features, _modelSchema_features1, _modelSchema_features2, _modelSchema_features3;
+        const modelSchema = this.getModelSchema(model, credentials);
+        return modelSchema && {
+            maxInputTokens: (_modelSchema_model_properties = modelSchema.model_properties) == null ? void 0 : _modelSchema_model_properties.context_size,
+            toolCalling: ((_modelSchema_features = modelSchema.features) == null ? void 0 : _modelSchema_features.includes(contracts.ModelFeature.TOOL_CALL)) || ((_modelSchema_features1 = modelSchema.features) == null ? void 0 : _modelSchema_features1.includes(contracts.ModelFeature.MULTI_TOOL_CALL)) || ((_modelSchema_features2 = modelSchema.features) == null ? void 0 : _modelSchema_features2.includes(contracts.ModelFeature.STREAM_TOOL_CALL)),
+            structuredOutput: (_modelSchema_features3 = modelSchema.features) == null ? void 0 : _modelSchema_features3.includes(contracts.ModelFeature.STRUCTURED_OUTPUT)
+        };
+    }
     constructor(modelProvider, modelType){
         this.modelProvider = modelProvider;
         this.modelType = modelType;
@@ -2607,46 +1949,6 @@ class RerankModel extends AIModel {
     }
 }
 
-const CommonParameterRules = [
-    {
-        name: 'temperature',
-        label: {
-            zh_Hans: '温度',
-            en_US: `Temperature`
-        },
-        type: contracts.ParameterType.FLOAT,
-        help: {
-            zh_Hans: '控制模型输出的随机性。较高的值（例如 1.0）使响应更具创意，而较低的值（例如 0.1）使响应更具确定性和重点性。',
-            en_US: `Controls the randomness of the model's output. A higher value (e.g., 1.0) makes responses more creative, while a lower value (e.g., 0.1) makes them more deterministic and focused.`
-        },
-        required: false,
-        default: 0.2,
-        min: 0,
-        max: 1,
-        precision: 0.1
-    },
-    {
-        label: {
-            zh_Hans: '最大尝试次数',
-            en_US: 'The maximum number of attempts'
-        },
-        type: contracts.ParameterType.INT,
-        help: {
-            zh_Hans: '如果请求由于网络超时或速率限制等问题而失败，系统将尝试重新发送请求的最大次数',
-            en_US: 'The maximum number of attempts the system will make to resend a request if it fails due to issues like network timeouts or rate limits'
-        },
-        required: false,
-        default: 6,
-        min: 0,
-        max: 10,
-        precision: 0,
-        name: 'maxRetries'
-    }
-];
-function mergeCredentials(credentials, modelProperties) {
-    return _extends({}, credentials != null ? credentials : {}, modelProperties != null ? modelProperties : {});
-}
-
 class SpeechToTextModel extends AIModel {
 }
 
@@ -2973,7 +2275,7 @@ class OpenAICompatibleReranker {
             if (!Array.isArray(output)) {
                 throw new Error('Invalid response format: missing results array');
             }
-            // 收集原始分数并进行归一化处理
+            // Collect raw scores and normalize them.
             const scores = output.map((r)=>r.relevance_score);
             const minScore = Math.min(...scores);
             const maxScore = Math.max(...scores);
@@ -3040,6 +2342,48 @@ class Speech2TextChatModel extends chat_models.BaseChatModel {
     return 0;
 }
 
+function getModelContextSize(input) {
+    if (isCopilotModel(input)) {
+        var _input_options;
+        return normalizeContextSize((_input_options = input.options) == null ? void 0 : _input_options[contracts.ModelPropertyKey.CONTEXT_SIZE]);
+    }
+    // Backward compatibility for langchain <1.0.0
+    if (input.metadata && "profile" in input.metadata) {
+        const profile = input.metadata['profile'];
+        if ("maxInputTokens" in profile && (typeof profile.maxInputTokens === "number" || profile.maxInputTokens == null)) {
+            var _profile_maxInputTokens;
+            return (_profile_maxInputTokens = profile.maxInputTokens) != null ? _profile_maxInputTokens : undefined;
+        }
+    }
+    // Langchain v1.0.0+
+    if ("profile" in input && typeof input.profile === "object" && input.profile && "maxInputTokens" in input.profile && (typeof input.profile.maxInputTokens === "number" || input.profile.maxInputTokens == null)) {
+        var _input_profile_maxInputTokens;
+        return (_input_profile_maxInputTokens = input.profile.maxInputTokens) != null ? _input_profile_maxInputTokens : undefined;
+    }
+    if ("model" in input && typeof input.model === "string") {
+        return base.getModelContextSize(input.model);
+    }
+    if ("modelName" in input && typeof input.modelName === "string") {
+        return base.getModelContextSize(input.modelName);
+    }
+    return undefined;
+}
+function isCopilotModel(input) {
+    return typeof input === "object" && input !== null && !("invoke" in input);
+}
+function normalizeContextSize(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+        return Math.floor(value);
+    }
+    if (typeof value === "string") {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+
 /**
  * Get a Chat Model of copilot model and check it's token limitation, record the token usage
  */ class CreateModelClientCommand extends cqrs.Command {
@@ -3076,6 +2420,651 @@ exports.AgentMiddlewareRegistry = __decorate([
     "end"
 ];
 
+/**
+ * Structured message types (suggested format):
+ * - channel.{provider}.{action}.v{number}
+ * - agent.{action}.v{number}
+ * - system.{action}.v{number}
+ * - plugin.{domain}.{action}.v{number}
+ *
+ * Note: At runtime, any string type is still allowed, facilitating dynamic extension by plugins.
+ */ const SEGMENT_PATTERN = /^[a-z][a-z0-9_-]*$/i;
+const VERSION_PATTERN = /^v[1-9][0-9]*$/;
+function assertSegment(input, name) {
+    if (!SEGMENT_PATTERN.test(input)) {
+        throw new Error(`Invalid ${name} segment: "${input}"`);
+    }
+}
+/**
+ * Unified construction of channel message types to avoid manual string errors.
+ * Example: channel.lark.inbound.v1
+ */ function defineChannelMessageType(provider, action, version) {
+    assertSegment(provider, 'provider');
+    assertSegment(action, 'action');
+    if (!Number.isInteger(version) || version <= 0) {
+        throw new Error(`Invalid version: "${version}"`);
+    }
+    return `channel.${provider}.${action}.v${version}`;
+}
+/**
+ * Unified construction of agent message types.
+ * Example: agent.handoff.v1
+ */ function defineAgentMessageType(action, version) {
+    assertSegment(action, 'action');
+    if (!Number.isInteger(version) || version <= 0) {
+        throw new Error(`Invalid version: "${version}"`);
+    }
+    return `agent.${action}.v${version}`;
+}
+/**
+ * Check if a type conforms to the structured naming convention (format only, no semantic validation).
+ */ function isStructuredMessageType(type) {
+    const parts = type.split('.');
+    if (parts.length < 3) {
+        return false;
+    }
+    const version = parts[parts.length - 1];
+    if (!VERSION_PATTERN.test(version)) {
+        return false;
+    }
+    return parts.slice(0, -1).every((part)=>SEGMENT_PATTERN.test(part));
+}
+
+const AGENT_CHAT_DISPATCH_MESSAGE_TYPE = defineAgentMessageType('chat_dispatch', 1);
+
+/**
+ * Handoff Processor meta key。
+ */ const HANDOFF_PROCESSOR_STRATEGY = 'HANDOFF_PROCESSOR_STRATEGY';
+/**
+ * Declare on a provider:
+ * 1) Which message types it handles
+ * 2) Default execution policy (lane/timeout)
+ */ function HandoffProcessorStrategy(provider, metadata) {
+    var _metadata_types;
+    if (!(metadata == null ? void 0 : (_metadata_types = metadata.types) == null ? void 0 : _metadata_types.length)) {
+        throw new Error('HandoffProcessor requires at least one message type');
+    }
+    return common.applyDecorators(common.SetMetadata(HANDOFF_PROCESSOR_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, HANDOFF_PROCESSOR_STRATEGY));
+}
+
+exports.HandoffProcessorRegistry = class HandoffProcessorRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(HANDOFF_PROCESSOR_STRATEGY, discoveryService, reflector);
+    }
+};
+exports.HandoffProcessorRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
+        typeof core.Reflector === "undefined" ? Object : core.Reflector
+    ])
+], exports.HandoffProcessorRegistry);
+
+/**
+ * Handoff execution types.
+ *
+ * Note:
+ * - Two-gate lane/session permit logic has been removed.
+ * - Lane is now an execution tag for observability and soft policy only.
+ */ const DEFAULT_EXECUTION_CONFIG = {
+    lanes: {
+        main: 8,
+        subagent: 16,
+        cron: 4,
+        nested: 8
+    },
+    runTtlMs: 10 * 60 * 1000
+};
+
+/**
+ * Common platform message length limits
+ */ const CHAT_CHANNEL_TEXT_LIMITS = {
+    lark: 4000,
+    wecom: 2048,
+    dingtalk: 4000,
+    slack: 4000,
+    telegram: 4096,
+    discord: 2000
+};
+/**
+ * Chunk long text by specified length
+ *
+ * @param text - Text to chunk
+ * @param limit - Maximum characters per chunk
+ * @param mode - Chunking mode: 'text' splits by character, 'markdown' tries to preserve paragraphs
+ * @returns Array of chunked text
+ */ function chunkText(text, limit, mode = 'text') {
+    if (!text || text.length <= limit) {
+        return [
+            text
+        ];
+    }
+    const chunks = [];
+    if (mode === 'markdown') {
+        // Markdown mode: try to split at paragraph boundaries
+        const paragraphs = text.split(/\n\n+/);
+        let currentChunk = '';
+        for (const para of paragraphs){
+            if (currentChunk.length + para.length + 2 <= limit) {
+                currentChunk += (currentChunk ? '\n\n' : '') + para;
+            } else if (para.length > limit) {
+                // Paragraph itself is too long, need hard split
+                if (currentChunk) {
+                    chunks.push(currentChunk);
+                    currentChunk = '';
+                }
+                let remaining = para;
+                while(remaining.length > limit){
+                    chunks.push(remaining.slice(0, limit));
+                    remaining = remaining.slice(limit);
+                }
+                currentChunk = remaining;
+            } else {
+                if (currentChunk) {
+                    chunks.push(currentChunk);
+                }
+                currentChunk = para;
+            }
+        }
+        if (currentChunk) {
+            chunks.push(currentChunk);
+        }
+    } else {
+        // Plain text mode: split directly by length
+        let remaining = text;
+        while(remaining.length > limit){
+            chunks.push(remaining.slice(0, limit));
+            remaining = remaining.slice(limit);
+        }
+        if (remaining) {
+            chunks.push(remaining);
+        }
+    }
+    return chunks;
+}
+
+/**
+ * Metadata key for chat channel
+ */ const CHAT_CHANNEL = 'CHAT_CHANNEL';
+/**
+ * Decorator for chat channel implementations
+ *
+ * Use this decorator to register a chat channel implementation.
+ * The decorated class will be automatically discovered and registered
+ * to ChatChannelRegistry on module initialization.
+ *
+ * @param type - The channel type identifier (e.g., 'lark', 'wecom', 'dingtalk')
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @ChatChannel('lark')
+ * export class LarkChatChannel implements IChatChannel {
+ *   // Implementation
+ * }
+ * ```
+ */ const ChatChannel = (type)=>common.SetMetadata(CHAT_CHANNEL, type);
+
+exports.ChatChannelRegistry = class ChatChannelRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(CHAT_CHANNEL, discoveryService, reflector);
+    }
+};
+exports.ChatChannelRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
+        typeof core.Reflector === "undefined" ? Object : core.Reflector
+    ])
+], exports.ChatChannelRegistry);
+
+class CancelConversationCommand {
+    constructor(input){
+        this.input = input;
+    }
+}
+CancelConversationCommand.type = '[Chat Conversation] Cancel';
+
+/**
+ * Protocol definition for pluggable memory backends.
+ *
+ * This module defines the BackendProtocol that all backend implementations
+ * must follow. Backends can store files in different locations (state, filesystem,
+ * database, etc.) and provide a uniform interface for file operations.
+ */ /**
+ * Type guard to check if a backend supports execution.
+ *
+ * @param backend - Backend instance to check
+ * @returns True if the backend implements SandboxBackendProtocol
+ */ function isSandboxBackend(backend) {
+    return typeof backend.execute === "function" && typeof backend.id === "string";
+}
+
+/**
+ * BaseSandbox: Abstract base class for sandbox backends with command execution.
+ *
+ * This class provides default implementations for all SandboxBackendProtocol
+ * methods using shell commands executed via execute(). Concrete implementations
+ * only need to implement the execute() method.
+ *
+ * Requires Node.js 20+ on the sandbox host.
+ */ /**
+ * Node.js command template for glob operations.
+ * Uses web-standard atob() for base64 decoding.
+ */ function buildGlobCommand(searchPath, pattern) {
+    const pathB64 = btoa(searchPath);
+    const patternB64 = btoa(pattern);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const searchPath = atob('${pathB64}');
+const pattern = atob('${patternB64}');
+
+function globMatch(relativePath, pattern) {
+  const regexPattern = pattern
+    .replace(/\\*\\*/g, '<<<GLOBSTAR>>>')
+    .replace(/\\*/g, '[^/]*')
+    .replace(/\\?/g, '.')
+    .replace(/<<<GLOBSTAR>>>/g, '.*');
+  return new RegExp('^' + regexPattern + '$').test(relativePath);
+}
+
+function walkDir(dir, baseDir, results) {
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      const relativePath = path.relative(baseDir, fullPath);
+      if (entry.isDirectory()) {
+        walkDir(fullPath, baseDir, results);
+      } else if (globMatch(relativePath, pattern)) {
+        const stat = fs.statSync(fullPath);
+        console.log(JSON.stringify({
+          path: relativePath,
+          size: stat.size,
+          mtime: stat.mtimeMs,
+          isDir: false
+        }));
+      }
+    }
+  } catch (e) {
+    // Silent failure for non-existent paths
+  }
+}
+
+try {
+  process.chdir(searchPath);
+  walkDir('.', '.', []);
+} catch (e) {
+  // Silent failure for non-existent paths
+}
+"`;
+}
+/**
+ * Node.js command template for listing directory contents.
+ */ function buildLsCommand(dirPath) {
+    const pathB64 = btoa(dirPath);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const dirPath = atob('${pathB64}');
+
+try {
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    const stat = fs.statSync(fullPath);
+    console.log(JSON.stringify({
+      path: entry.isDirectory() ? fullPath + '/' : fullPath,
+      size: stat.size,
+      mtime: stat.mtimeMs,
+      isDir: entry.isDirectory()
+    }));
+  }
+} catch (e) {
+  console.error('Error: ' + e.message);
+  process.exit(1);
+}
+"`;
+}
+/**
+ * Node.js command template for reading files.
+ */ function buildReadCommand(filePath, offset, limit) {
+    const pathB64 = btoa(filePath);
+    // Coerce offset and limit to safe non-negative integers before embedding in the shell command.
+    const safeOffset = Number.isFinite(offset) && offset > 0 ? Math.floor(offset) : 0;
+    const safeLimit = Number.isFinite(limit) && limit > 0 && limit < Number.MAX_SAFE_INTEGER ? Math.floor(limit) : 0;
+    return `node -e "
+const fs = require('fs');
+
+const filePath = atob('${pathB64}');
+const offset = ${safeOffset};
+const limit = ${safeLimit};
+
+if (!fs.existsSync(filePath)) {
+  console.log('Error: File not found');
+  process.exit(1);
+}
+
+const stat = fs.statSync(filePath);
+if (stat.size === 0) {
+  console.log('System reminder: File exists but has empty contents');
+  process.exit(0);
+}
+
+const content = fs.readFileSync(filePath, 'utf-8');
+const lines = content.split('\\n');
+const selected = lines.slice(offset, offset + limit);
+
+for (let i = 0; i < selected.length; i++) {
+  const lineNum = offset + i + 1;
+  console.log(String(lineNum).padStart(6) + '\\t' + selected[i]);
+}
+"`;
+}
+/**
+ * Node.js command template for writing files.
+ */ function buildWriteCommand(filePath, content) {
+    const pathB64 = btoa(filePath);
+    const contentB64 = btoa(content);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const filePath = atob('${pathB64}');
+const content = atob('${contentB64}');
+
+if (fs.existsSync(filePath)) {
+  console.error('Error: File already exists');
+  process.exit(1);
+}
+
+const parentDir = path.dirname(filePath) || '.';
+fs.mkdirSync(parentDir, { recursive: true });
+
+fs.writeFileSync(filePath, content, 'utf-8');
+console.log('OK');
+"`;
+}
+/**
+ * Node.js command template for editing files.
+ */ function buildEditCommand(filePath, oldStr, newStr, replaceAll) {
+    const pathB64 = btoa(filePath);
+    const oldB64 = btoa(oldStr);
+    const newB64 = btoa(newStr);
+    return `node -e "
+const fs = require('fs');
+
+const filePath = atob('${pathB64}');
+const oldStr = atob('${oldB64}');
+const newStr = atob('${newB64}');
+const replaceAll = ${Boolean(replaceAll)};
+
+let text;
+try {
+  text = fs.readFileSync(filePath, 'utf-8');
+} catch (e) {
+  process.exit(3);
+}
+
+const count = text.split(oldStr).length - 1;
+
+if (count === 0) {
+  process.exit(1);
+}
+if (count > 1 && !replaceAll) {
+  process.exit(2);
+}
+
+const result = text.split(oldStr).join(newStr);
+fs.writeFileSync(filePath, result, 'utf-8');
+console.log(count);
+"`;
+}
+/**
+ * Node.js command template for grep operations.
+ */ function buildGrepCommand(pattern, searchPath, globPattern) {
+    const patternB64 = btoa(pattern);
+    const pathB64 = btoa(searchPath);
+    const globB64 = globPattern ? btoa(globPattern) : "";
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const pattern = atob('${patternB64}');
+const searchPath = atob('${pathB64}');
+const globPattern = ${globPattern ? `atob('${globB64}')` : "null"};
+
+let regex;
+try {
+  regex = new RegExp(pattern);
+} catch (e) {
+  console.error('Invalid regex: ' + e.message);
+  process.exit(1);
+}
+
+function globMatch(filePath, pattern) {
+  if (!pattern) return true;
+  const regexPattern = pattern
+    .replace(/\\*\\*/g, '<<<GLOBSTAR>>>')
+    .replace(/\\*/g, '[^/]*')
+    .replace(/\\?/g, '.')
+    .replace(/<<<GLOBSTAR>>>/g, '.*');
+  return new RegExp('^' + regexPattern + '$').test(filePath);
+}
+
+function walkDir(dir, results) {
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walkDir(fullPath, results);
+      } else {
+        const relativePath = path.relative(searchPath, fullPath);
+        if (globMatch(relativePath, globPattern)) {
+          try {
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const lines = content.split('\\n');
+            for (let i = 0; i < lines.length; i++) {
+              if (regex.test(lines[i])) {
+                console.log(JSON.stringify({
+                  path: fullPath,
+                  line: i + 1,
+                  text: lines[i]
+                }));
+              }
+            }
+          } catch (e) {
+            // Skip unreadable files
+          }
+        }
+      }
+    }
+  } catch (e) {
+    // Skip unreadable directories
+  }
+}
+
+try {
+  walkDir(searchPath, []);
+} catch (e) {
+  // Silent failure
+}
+"`;
+}
+/**
+ * Base sandbox implementation with execute() as the only abstract method.
+ *
+ * This class provides default implementations for all SandboxBackendProtocol
+ * methods using shell commands executed via execute(). Concrete implementations
+ * only need to implement the execute() method.
+ *
+ * Requires Node.js 20+ on the sandbox host.
+ */ class BaseSandbox {
+    /**
+   * List files and directories in the specified directory (non-recursive).
+   *
+   * @param path - Absolute path to directory
+   * @returns List of FileInfo objects for files and directories directly in the directory.
+   */ async lsInfo(path) {
+        const command = buildLsCommand(path);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            return [];
+        }
+        const infos = [];
+        const lines = result.output.trim().split("\n").filter(Boolean);
+        for (const line of lines){
+            try {
+                const parsed = JSON.parse(line);
+                infos.push({
+                    path: parsed.path,
+                    is_dir: parsed.isDir,
+                    size: parsed.size,
+                    modified_at: parsed.mtime ? new Date(parsed.mtime).toISOString() : undefined
+                });
+            } catch (e) {
+            // Skip invalid JSON lines
+            }
+        }
+        return infos;
+    }
+    /**
+   * Read file content with line numbers.
+   *
+   * @param filePath - Absolute file path
+   * @param offset - Line offset to start reading from (0-indexed)
+   * @param limit - Maximum number of lines to read
+   * @returns Formatted file content with line numbers, or error message
+   */ async read(filePath, offset = 0, limit = 500) {
+        const command = buildReadCommand(filePath, offset, limit);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            return `Error: File '${filePath}' not found`;
+        }
+        return result.output;
+    }
+    /**
+   * Structured search results or error string for invalid input.
+   */ async grepRaw(pattern, path = "/", glob = null) {
+        const command = buildGrepCommand(pattern, path, glob);
+        const result = await this.execute(command);
+        if (result.exitCode === 1) {
+            // Check if it's a regex error
+            if (result.output.includes("Invalid regex:")) {
+                return result.output.trim();
+            }
+        }
+        const matches = [];
+        const lines = result.output.trim().split("\n").filter(Boolean);
+        for (const line of lines){
+            try {
+                const parsed = JSON.parse(line);
+                matches.push({
+                    path: parsed.path,
+                    line: parsed.line,
+                    text: parsed.text
+                });
+            } catch (e) {
+            // Skip invalid JSON lines
+            }
+        }
+        return matches;
+    }
+    /**
+   * Structured glob matching returning FileInfo objects.
+   */ async globInfo(pattern, path = "/") {
+        const command = buildGlobCommand(path, pattern);
+        const result = await this.execute(command);
+        const infos = [];
+        const lines = result.output.trim().split("\n").filter(Boolean);
+        for (const line of lines){
+            try {
+                const parsed = JSON.parse(line);
+                infos.push({
+                    path: parsed.path,
+                    is_dir: parsed.isDir,
+                    size: parsed.size,
+                    modified_at: parsed.mtime ? new Date(parsed.mtime).toISOString() : undefined
+                });
+            } catch (e) {
+            // Skip invalid JSON lines
+            }
+        }
+        return infos;
+    }
+    /**
+   * Create a new file with content.
+   */ async write(filePath, content) {
+        const command = buildWriteCommand(filePath, content);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            return {
+                error: `Cannot write to ${filePath} because it already exists. Read and then make an edit, or write to a new path.`
+            };
+        }
+        return {
+            path: filePath,
+            filesUpdate: null
+        };
+    }
+    /**
+   * Edit a file by replacing string occurrences.
+   */ async edit(filePath, oldString, newString, replaceAll = false) {
+        const command = buildEditCommand(filePath, oldString, newString, replaceAll);
+        const result = await this.execute(command);
+        switch(result.exitCode){
+            case 0:
+                {
+                    const occurrences = parseInt(result.output.trim(), 10) || 1;
+                    return {
+                        path: filePath,
+                        filesUpdate: null,
+                        occurrences
+                    };
+                }
+            case 1:
+                return {
+                    error: `String not found in file '${filePath}'`
+                };
+            case 2:
+                return {
+                    error: `Multiple occurrences found in '${filePath}'. Use replaceAll=true to replace all.`
+                };
+            case 3:
+                return {
+                    error: `Error: File '${filePath}' not found`
+                };
+            default:
+                return {
+                    error: `Unknown error editing file '${filePath}'`
+                };
+        }
+    }
+}
+
+const SANDBOX_PROVIDER = 'SANDBOX_PROVIDER';
+const SandboxProviderStrategy = (provider)=>common.applyDecorators(common.SetMetadata(SANDBOX_PROVIDER, provider), common.SetMetadata(STRATEGY_META_KEY, SANDBOX_PROVIDER));
+
+exports.SandboxProviderRegistry = class SandboxProviderRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(SANDBOX_PROVIDER, discoveryService, reflector);
+    }
+};
+exports.SandboxProviderRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
+        typeof core.Reflector === "undefined" ? Object : core.Reflector
+    ])
+], exports.SandboxProviderRegistry);
+
 Object.defineProperty(exports, "IColumnDef", {
 	enumerable: true,
 	get: function () { return contracts.IColumnDef; }
@@ -3092,42 +3081,57 @@ Object.defineProperty(exports, "TDocumentAsset", {
 	enumerable: true,
 	get: function () { return contracts.TDocumentAsset; }
 });
+exports.AGENT_CHAT_DISPATCH_MESSAGE_TYPE = AGENT_CHAT_DISPATCH_MESSAGE_TYPE;
 exports.AGENT_MIDDLEWARE_STRATEGY = AGENT_MIDDLEWARE_STRATEGY;
 exports.AIModelProviderNotFoundException = AIModelProviderNotFoundException;
 exports.AIModelProviderStrategy = AIModelProviderStrategy;
 exports.AI_MODEL_PROVIDER = AI_MODEL_PROVIDER;
+exports.ANALYTICS_PERMISSION_SERVICE_TOKEN = ANALYTICS_PERMISSION_SERVICE_TOKEN;
 exports.AdapterDataSourceStrategy = AdapterDataSourceStrategy;
 exports.AgentMiddlewareStrategy = AgentMiddlewareStrategy;
 exports.AiModelNotFoundException = AiModelNotFoundException;
 exports.BaseHTTPQueryRunner = BaseHTTPQueryRunner;
 exports.BaseQueryRunner = BaseQueryRunner;
 exports.BaseSQLQueryRunner = BaseSQLQueryRunner;
+exports.BaseSandbox = BaseSandbox;
 exports.BaseStrategyRegistry = BaseStrategyRegistry;
 exports.BaseTool = BaseTool;
 exports.BaseToolset = BaseToolset;
 exports.BuiltinToolset = BuiltinToolset;
+exports.CHAT_CHANNEL = CHAT_CHANNEL;
+exports.CHAT_CHANNEL_TEXT_LIMITS = CHAT_CHANNEL_TEXT_LIMITS;
+exports.CancelConversationCommand = CancelConversationCommand;
+exports.ChatChannel = ChatChannel;
 exports.ChatOAICompatReasoningModel = ChatOAICompatReasoningModel;
 exports.CommonParameterRules = CommonParameterRules;
 exports.CreateModelClientCommand = CreateModelClientCommand;
 exports.CredentialsValidateFailedError = CredentialsValidateFailedError;
 exports.DATASOURCE_STRATEGY = DATASOURCE_STRATEGY;
+exports.DEFAULT_EXECUTION_CONFIG = DEFAULT_EXECUTION_CONFIG;
 exports.DOCUMENT_SOURCE_STRATEGY = DOCUMENT_SOURCE_STRATEGY;
 exports.DOCUMENT_TRANSFORMER_STRATEGY = DOCUMENT_TRANSFORMER_STRATEGY;
 exports.DataSourceStrategy = DataSourceStrategy;
 exports.DocumentSourceStrategy = DocumentSourceStrategy;
 exports.DocumentTransformerStrategy = DocumentTransformerStrategy;
 exports.GLOBAL_ORGANIZATION_SCOPE = GLOBAL_ORGANIZATION_SCOPE;
+exports.HANDOFF_PERMISSION_SERVICE_TOKEN = HANDOFF_PERMISSION_SERVICE_TOKEN;
+exports.HANDOFF_PROCESSOR_STRATEGY = HANDOFF_PROCESSOR_STRATEGY;
+exports.HANDOFF_QUEUE_SERVICE_TOKEN = HANDOFF_QUEUE_SERVICE_TOKEN;
+exports.HandoffProcessorStrategy = HandoffProcessorStrategy;
 exports.IMAGE_UNDERSTANDING_STRATEGY = IMAGE_UNDERSTANDING_STRATEGY;
+exports.INTEGRATION_PERMISSION_SERVICE_TOKEN = INTEGRATION_PERMISSION_SERVICE_TOKEN;
 exports.INTEGRATION_STRATEGY = INTEGRATION_STRATEGY;
 exports.ImageUnderstandingStrategy = ImageUnderstandingStrategy;
 exports.IntegrationStrategyKey = IntegrationStrategyKey;
 exports.JUMP_TO_TARGETS = JUMP_TO_TARGETS;
+exports.JsonSchemaValidator = JsonSchemaValidator;
 exports.KNOWLEDGE_STRATEGY = KNOWLEDGE_STRATEGY;
 exports.KnowledgeStrategyKey = KnowledgeStrategyKey;
 exports.LLMUsage = LLMUsage;
 exports.LargeLanguageModel = LargeLanguageModel;
 exports.ORGANIZATION_METADATA_KEY = ORGANIZATION_METADATA_KEY;
 exports.OpenAICompatibleReranker = OpenAICompatibleReranker;
+exports.PERMISSION_OPERATION_METADATA_KEY = PERMISSION_OPERATION_METADATA_KEY;
 exports.PLUGIN_METADATA = PLUGIN_METADATA;
 exports.PLUGIN_METADATA_KEY = PLUGIN_METADATA_KEY;
 exports.PROVIDE_AI_MODEL_LLM = PROVIDE_AI_MODEL_LLM;
@@ -3138,9 +3142,12 @@ exports.PROVIDE_AI_MODEL_TEXT_EMBEDDING = PROVIDE_AI_MODEL_TEXT_EMBEDDING;
 exports.PROVIDE_AI_MODEL_TTS = PROVIDE_AI_MODEL_TTS;
 exports.RETRIEVER_STRATEGY = RETRIEVER_STRATEGY;
 exports.RequestContext = RequestContext;
+exports.RequirePermissionOperation = RequirePermissionOperation;
 exports.RerankModel = RerankModel;
 exports.RetrieverStrategy = RetrieverStrategy;
+exports.SANDBOX_PROVIDER = SANDBOX_PROVIDER;
 exports.STRATEGY_META_KEY = STRATEGY_META_KEY;
+exports.SandboxProviderStrategy = SandboxProviderStrategy;
 exports.Speech2TextChatModel = Speech2TextChatModel;
 exports.SpeechToTextModel = SpeechToTextModel;
 exports.TEXT_SPLITTER_STRATEGY = TEXT_SPLITTER_STRATEGY;
@@ -3149,6 +3156,7 @@ exports.TextEmbeddingModelManager = TextEmbeddingModelManager;
 exports.TextSplitterStrategy = TextSplitterStrategy;
 exports.TextToSpeechModel = TextToSpeechModel;
 exports.ToolsetStrategy = ToolsetStrategy;
+exports.USER_PERMISSION_SERVICE_TOKEN = USER_PERMISSION_SERVICE_TOKEN;
 exports.VECTOR_STORE_STRATEGY = VECTOR_STORE_STRATEGY;
 exports.VectorStoreStrategy = VectorStoreStrategy;
 exports.WORKFLOW_NODE_STRATEGY = WORKFLOW_NODE_STRATEGY;
@@ -3160,17 +3168,26 @@ exports.XpFileSystem = XpFileSystem;
 exports.XpertServerPlugin = XpertServerPlugin;
 exports.als = als;
 exports.calcTokenUsage = calcTokenUsage;
+exports.chunkText = chunkText;
 exports.countTokensSafe = countTokensSafe;
 exports.createI18nInstance = createI18nInstance;
 exports.createPluginLogger = createPluginLogger;
+exports.defineAgentMessageType = defineAgentMessageType;
+exports.defineChannelMessageType = defineChannelMessageType;
 exports.downloadRemoteFile = downloadRemoteFile;
 exports.getErrorMessage = getErrorMessage;
+exports.getModelContextSize = getModelContextSize;
+exports.getPermissionOperationMetadata = getPermissionOperationMetadata;
 exports.getPositionList = getPositionList;
 exports.getPositionMap = getPositionMap;
 exports.getRequestContext = getRequestContext;
+exports.getRequiredPermissionOperation = getRequiredPermissionOperation;
 exports.isRemoteFile = isRemoteFile;
+exports.isSandboxBackend = isSandboxBackend;
+exports.isStructuredMessageType = isStructuredMessageType;
 exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
 exports.mergeParentChildChunks = mergeParentChildChunks;
+exports.normalizeContextSize = normalizeContextSize;
 exports.runWithRequestContext = runWithRequestContext;
 exports.sumTokenUsage = sumTokenUsage;