6#include "phosphorscripting_export.h"
11#include <QVariantList>
65 explicit LuauEngine(std::shared_ptr<LuauWatchdog> watchdog =
nullptr,
74 bool init(QString* error =
nullptr);
78 bool runPrelude(
const QString& chunkName,
const QByteArray& source, QString* error =
nullptr);
86 int loadModule(
const QString& chunkName,
const QByteArray& source, QString* error =
nullptr);
93 QVariant
moduleField(
int moduleHandle,
const QString& key)
const;
96 bool hasFunction(
int moduleHandle,
const QString& name)
const;
106 return m_L !=
nullptr;
112 return m_memory.used;
118 return m_memory.peak;
128 static void interruptCallback(lua_State* L,
int gc);
134 static void* allocate(
void* ud,
void* ptr, std::size_t osize, std::size_t nsize);
144 std::size_t used = 0;
145 std::size_t peak = 0;
147 bool enforce =
false;
153 CallStatus guardedPcall(
int nargs,
int nresults,
int timeoutMs, QString* message);
155 lua_State* m_L =
nullptr;
156 std::shared_ptr<LuauWatchdog> m_watchdog;
157 std::shared_ptr<std::atomic<bool>> m_interrupt;
158 MemoryBudget m_memory;
159 bool m_sandboxed =
false;
163 bool m_timedOut =
false;
164 int m_lastTimeoutMs = 0;
std::size_t peakMemoryBytes() const noexcept
High-water mark of memoryUsedBytes over the engine's lifetime.
Definition LuauEngine.h:116
bool init(QString *error=nullptr)
Create the VM, open the (restricted) standard libraries, and wire the interrupt callback.
LuauEngine(const LuauEngine &)=delete
static constexpr std::size_t DefaultMemoryCapBytes
Default per-engine heap ceiling for untrusted script execution.
Definition LuauEngine.h:59
bool hasFunction(int moduleHandle, const QString &name) const
Whether the module exposes a callable field named name.
std::size_t memoryCapBytes() const noexcept
The configured heap ceiling (0 = unlimited).
Definition LuauEngine.h:122
LuauEngine(std::shared_ptr< LuauWatchdog > watchdog=nullptr, std::size_t memoryCapBytes=DefaultMemoryCapBytes)
watchdog may be shared across engines; nullptr disables the timeout safety net (useful for short,...
bool isValid() const noexcept
Definition LuauEngine.h:104
int loadModule(const QString &chunkName, const QByteArray &source, QString *error=nullptr)
Compile + load a module chunk and run it; the chunk is expected to return a table.
bool runPrelude(const QString &chunkName, const QByteArray &source, QString *error=nullptr)
Compile + run a chunk that installs host globals.
CallOutcome callModule(int moduleHandle, const QString &function, const QVariantList &args, int timeoutMs)
Call module[function](args...) under the watchdog, returning a single result.
CallStatus
Definition LuauEngine.h:42
@ Error
Definition LuauEngine.h:45
std::size_t memoryUsedBytes() const noexcept
Live heap bytes currently allocated by the VM (host accounting).
Definition LuauEngine.h:110
void releaseModule(int handle)
Release a module handle from loadModule.
void sandbox()
Freeze the global table and standard libraries.
LuauEngine & operator=(const LuauEngine &)=delete
QVariant moduleField(int moduleHandle, const QString &key) const
Read a (non-function) field from a loaded module as a QVariant.
One supervisor thread that interrupts runaway scripts across many engines.
Definition LuauWatchdog.h:38
Definition LuauEngine.h:19
Definition LuauEngine.h:49
QVariant result
Set when status == Ok (nil → invalid QVariant).
Definition LuauEngine.h:51
QString message
Set when status != Ok.
Definition LuauEngine.h:52
CallStatus status
Definition LuauEngine.h:50