@cheatron/nthread 1.0.0

package/dist/nthread.js

@@ -0,0 +1,421 @@
+import * as Native from '@cheatron/native';
+import { getRandomSleepAddress, getRandomPushretAddress, } from './globals.js';
+import { log } from './logger';
+import { ProxyThread } from './thread/proxy-thread.js';
+import { CapturedThread } from './thread/captured-thread.js';
+import { crt } from './crt.js';
+import { NoSleepAddressError, NoPushretAddressError, InjectTimeoutError, CallTooManyArgsError, CallRipMismatchError, CallTimeoutError, CallThreadDiedError, } from './errors.js';
+import { findOverlappingRegion, getOverlapInfo, updateSnapshot, } from './memory/romem.js';
+export { STACK_ADD } from './thread/captured-thread.js';
+const nthreadLog = log.child('');
+/**
+ * NThread: Orchestrates non-invasive thread hijacking.
+ *
+ * It works by suspending a target thread, redirecting its Rip to a 'pushreg/ret' gadget,
+ * setting a 'sleep' address as the target, and waiting for the thread to 'land'
+ * at said sleep address. Once landed, the thread is effectively seized without
+ * stopping the underlying process or requiring complex debugging APIs.
+ *
+ * The actual thread state (context cache, suspend tracking, proxy) is managed by
+ * the contained CapturedThread instance, created during inject().
+ */
+export class NThread {
+    /** Optional process ID for diagnostics and logging */
+    processId;
+    /** Address of an infinite loop gadget ('jmp .') used to hold the thread */
+    sleepAddress;
+    /** Address of a pivot gadget ('push reg; ret') used to redirect execution */
+    pushretAddress;
+    /** The register key (e.g., 'Rbx') used for the pushret pivot */
+    regKey;
+    /**
+     * Creates an NThread instance and prepares redirect gadgets.
+     * @param processId Optional process ID for diagnostics and logging.
+     * @param sleepAddress Optional explicit sleep gadget.
+     * @param pushretAddress Optional explicit pushret gadget.
+     * @param regKey Optional register preference for the pushret gadget.
+     */
+    constructor(processId, sleepAddress, pushretAddress, regKey) {
+        this.processId = processId;
+        // 1. Resolve Sleep Address
+        if (sleepAddress) {
+            this.sleepAddress = sleepAddress;
+        }
+        else {
+            const randomSleepAddress = getRandomSleepAddress();
+            if (!randomSleepAddress) {
+                throw new NoSleepAddressError();
+            }
+            this.sleepAddress = randomSleepAddress;
+        }
+        // 2. Resolve PushRet Address and Key
+        if (pushretAddress !== undefined) {
+            this.pushretAddress = pushretAddress;
+            this.regKey = regKey ?? 'Rbp';
+        }
+        else {
+            const randomPushret = getRandomPushretAddress(regKey);
+            if (!randomPushret) {
+                throw new NoPushretAddressError();
+            }
+            this.pushretAddress = randomPushret.address;
+            this.regKey = randomPushret.regKey;
+        }
+    }
+    /**
+     * Executes the hijacking flow:
+     * 1. Create a CapturedThread from the given thread parameter.
+     * 2. Suspend the thread.
+     * 3. Capture and save current register state.
+     * 4. Redirect Rip to PushRet gadget.
+     * 5. Point the chosen register (RegKey) to the Sleep gadget.
+     * 6. Adjust stack (Rsp) to a safe scratch area.
+     * 7. Resume and wait for the thread to 'trap' itself in the loop.
+     *
+     * @param thread Thread object or Thread ID to hijack.
+     */
+    async inject(thread) {
+        const captured = new CapturedThread(thread, this.regKey, this.sleepAddress, this.processId);
+        captured.suspend();
+        captured.fetchContext();
+        captured.savedContext = captured.getContext();
+        // Preserve original values to restore them later
+        const targetReg = captured.savedContext[this.regKey];
+        const rip = captured.savedContext.Rip;
+        const rsp = captured.savedContext.Rsp;
+        // Hijack:
+        // RIP -> [push reg; ret]  (The pivot)
+        // REG -> [jmp .]          (The final destination)
+        // pushret will 'push sleep; ret' → sleep addr lands at [stackBegin - 8]
+        // call() later sets RSP to that same address so 'ret' pops sleep again.
+        const stackBegin = captured.calcStackBegin(BigInt(rsp));
+        captured.callRsp = stackBegin - 8n;
+        captured.setRIP(this.pushretAddress.address);
+        captured.setRSP(stackBegin);
+        captured.setTargetReg(this.sleepAddress.address);
+        captured.applyContext();
+        captured.resume();
+        nthreadLog.info(`Waiting for thread ${captured.tid} to reach ${this.sleepAddress}...`);
+        // Poll until Rip matches our infinite loop address
+        const res = await captured.wait(5000);
+        if (res != Native.WaitReturn.OBJECT_0) {
+            throw new InjectTimeoutError(res);
+        }
+        // Refresh context now that we are stably 'parked' at sleepAddress
+        captured.savedContext = captured.getContext();
+        // Restore original state into our local copy so we can resume naturally later
+        captured.savedContext[this.regKey] = targetReg;
+        captured.savedContext.Rip = rip;
+        captured.savedContext.Rsp = rsp;
+        // Ensure we capture integer and control registers for maximum control
+        captured.latestContext.ContextFlags =
+            Native.ContextFlags.INTEGER | Native.ContextFlags.CONTROL;
+        const proxy = new ProxyThread((_proxy, suicide) => this.threadClose(_proxy, captured, suicide));
+        /*proxy.setReader((_proxy, address, size) =>
+          Promise.resolve(Native.currentProcess.memory.read(address, size)),
+        );*/
+        proxy.setCaller((_proxy, address, ...proxyArgs) => this.threadCall(captured, address, [...proxyArgs]));
+        proxy.setWriter((_proxy, address, data, size) => this.threadWrite(_proxy, address, data, size));
+        proxy.setAllocer((_proxy, size, opts) => this.threadAlloc(_proxy, size, opts));
+        proxy.setFreer((_proxy, ptr) => this.threadFree(_proxy, ptr));
+        nthreadLog.info(`Successfully injected into thread ${captured.tid}`);
+        return [proxy, captured];
+    }
+    /** Writes data to the target process; dispatches NativePointer vs Buffer. */
+    async threadWrite(proxy, address, data, size) {
+        if (data instanceof Native.NativePointer) {
+            if (!size) {
+                throw new Error('Size must be specified when writing a pointer.');
+            }
+            await this.writeMemoryWithPointer(proxy, address, data, size);
+            return size;
+        }
+        const buf = data instanceof Buffer ? data : Buffer.from(data);
+        const writeSize = size ?? buf.length;
+        await this.writeMemory(proxy, address, buf.subarray(0, writeSize));
+        return writeSize;
+    }
+    /**
+     * Hook: called to release the proxy and captured thread.
+     * Subclasses can override to perform cleanup (e.g. destroy a heap pool)
+     * before closing. Default: terminate (if suicide) then close the handle.
+     */
+    async threadClose(_proxy, captured, suicide) {
+        if (suicide !== undefined)
+            captured.terminate(suicide);
+        captured.close();
+    }
+    /**
+     * Hook: allocates memory in the target process.
+     * Default: `malloc` / `calloc` / `malloc+memset` depending on `opts.fill`;
+     * delegates to `msvcrt!realloc` when `opts.address` is provided.
+     * Subclasses can override to use a pre-allocated heap instead.
+     */
+    async threadAlloc(proxy, size, opts) {
+        if (opts?.address) {
+            const ptr = await proxy.realloc(opts.address.address, BigInt(size));
+            if (ptr.address === 0n)
+                throw new Error(`realloc(0x${opts.address.address.toString(16)}, ${size}) returned NULL`);
+            return ptr;
+        }
+        const fill = opts?.fill;
+        if (fill === undefined) {
+            return proxy.malloc(BigInt(size));
+        }
+        else if (fill === 0) {
+            return proxy.calloc(1n, BigInt(size));
+        }
+        else {
+            const ptr = await proxy.malloc(BigInt(size));
+            await proxy.memset(ptr.address, BigInt(fill & 0xff), BigInt(size));
+            return ptr;
+        }
+    }
+    /**
+     * Hook: frees a pointer in the target process.
+     * Default: `msvcrt!free`.
+     * Subclasses can override to return the block to a managed heap instead.
+     */
+    async threadFree(proxy, ptr) {
+        await proxy.call(crt.free, ptr.address);
+    }
+    /**
+     * Allocates memory for a string and writes it into the remote process via the captured thread.
+     * Null-terminates automatically.
+     *
+     * @param proxy The proxy for the captured thread.
+     * @param str String to encode and write.
+     * @param encoding Buffer encoding — defaults to `'utf16le'` (Windows wide string).
+     * @param opts Optional alloc options forwarded to `proxy.alloc()`.
+     */
+    async allocString(proxy, str, encoding = 'utf16le', opts) {
+        const encoded = Buffer.from(str, encoding);
+        const nullBytes = encoding === 'utf16le' || encoding === 'ucs2' ? 2 : 1;
+        const buf = Buffer.alloc(encoded.length + nullBytes);
+        encoded.copy(buf);
+        const ptr = await proxy.alloc(buf.length, opts);
+        await proxy.write(ptr, buf);
+        return ptr;
+    }
+    /**
+     * Executes a function call on a captured thread using the Windows x64 calling convention.
+     * The thread must be parked at the sleep address (after inject()).
+     *
+     * Supports up to 4 parameters mapped to RCX, RDX, R8, R9.
+     * Returns the value from RAX after the function completes.
+     *
+     * @param thread The captured thread to execute on.
+     * @param target Address of the function to call.
+     * @param args Up to 4 arguments (RCX, RDX, R8, R9).
+     * @param timeoutMs Timeout in ms for waiting on the function return (default: 5000).
+     * @returns RAX value as NativePointer.
+     */
+    async threadCall(thread, target, args = [], timeoutMs = 5000) {
+        if (args.length > 4) {
+            throw new CallTooManyArgsError(args.length);
+        }
+        const toBigInt = (v) => {
+            if (v instanceof Native.NativePointer)
+                return v.address;
+            return BigInt(v);
+        };
+        const targetAddr = target instanceof Native.NativePointer ? target.address : BigInt(target);
+        // 1. Suspend the thread (should be parked at sleep 'jmp .')
+        thread.suspend();
+        thread.fetchContext();
+        // Safety check: verify thread is actually at the sleep address
+        const currentRip = BigInt(thread.getContext().Rip);
+        if (currentRip !== this.sleepAddress.address) {
+            thread.resume();
+            throw new CallRipMismatchError(targetAddr, currentRip, this.sleepAddress.address);
+        }
+        // 2. Map arguments to x64 calling convention registers
+        const ctx = thread.getContext();
+        if (args.length > 0)
+            ctx.Rcx = toBigInt(args[0]);
+        if (args.length > 1)
+            ctx.Rdx = toBigInt(args[1]);
+        if (args.length > 2)
+            ctx.R8 = toBigInt(args[2]);
+        if (args.length > 3)
+            ctx.R9 = toBigInt(args[3]);
+        // 3. Redirect execution to target function
+        //    callRsp points to the pre-written return address (sleep gadget), set once in inject()
+        ctx.Rip = targetAddr;
+        ctx.Rsp = thread.callRsp;
+        thread.setContext(ctx);
+        thread.applyContext();
+        thread.resume();
+        nthreadLog.debug(`Calling 0x${targetAddr.toString(16)} with ${args.length} arg(s)...`);
+        // 6. Wait for the function to return (RIP lands back at sleep address)
+        const res = await thread.wait(timeoutMs);
+        if (res === Native.WaitReturn.FAILED) {
+            throw new CallThreadDiedError(targetAddr);
+        }
+        if (res !== Native.WaitReturn.OBJECT_0) {
+            throw new CallTimeoutError(targetAddr, res);
+        }
+        // 7. Return value is in RAX
+        const rax = new Native.NativePointer(thread.getContext().Rax);
+        nthreadLog.debug(`Call returned: 0x${rax.toString()}`);
+        return rax;
+    }
+    /**
+     * Writes arbitrary data to the target process memory using hijacked memset calls.
+     * Decomposes the source buffer into runs of equal bytes and issues one
+     * `msvcrt!memset(dest + offset, value, runLength)` call per run.
+     *
+     * If the write range overlaps a registered read-only memory region, the
+     * overlapping portion is routed through writeMemorySafeBuffer (skips unchanged
+     * bytes) and the non-overlapping parts are written normally via recursive calls.
+     *
+     * @param dest Target address to write to.
+     * @param source The data to write.
+     */
+    async writeMemory(proxy, dest, source) {
+        const destAddr = dest instanceof Native.NativePointer ? dest.address : dest;
+        const data = source instanceof Buffer ? source : Buffer.from(source);
+        const length = data.length;
+        if (length === 0)
+            return 0;
+        // Check if the write overlaps a read-only memory region
+        const romem = findOverlappingRegion(destAddr, length);
+        if (romem) {
+            const { writeOffset, overlapLen, snapshot } = getOverlapInfo(destAddr, length, romem);
+            let written = 0;
+            // Part before the overlap — plain writeMemory
+            if (writeOffset > 0) {
+                written += await this.writeMemory(proxy, destAddr, data.subarray(0, writeOffset));
+            }
+            // Overlapping part — safe write using the snapshot
+            const overlapDest = new Native.NativePointer(destAddr + BigInt(writeOffset));
+            const overlapData = data.subarray(writeOffset, writeOffset + overlapLen);
+            written += await this.writeMemorySafeBuffer(proxy, overlapDest, overlapData, snapshot);
+            updateSnapshot(romem, overlapData, overlapDest.address);
+            // Part after the overlap — plain writeMemory
+            const afterOffset = writeOffset + overlapLen;
+            if (afterOffset < length) {
+                written += await this.writeMemory(proxy, destAddr + BigInt(afterOffset), data.subarray(afterOffset));
+            }
+            return written;
+        }
+        // No overlap — standard decomposed memset
+        let i = 0;
+        while (i < length) {
+            const value = data[i];
+            let j = i + 1;
+            while (j < length && data[j] === value) {
+                j++;
+            }
+            const runLen = j - i;
+            const addr = await proxy.call(crt.memset, destAddr + BigInt(i), value, runLen);
+            if (addr.address === 0n)
+                return i;
+            i = j;
+        }
+        return length;
+    }
+    /**
+     * Writes data from a NativePointer source to the target process memory
+     * using hijacked memset calls. Reads the source pointer byte-by-byte into
+     * a local buffer first, then delegates to the standard decomposed memset.
+     *
+     * Does NOT check read-only memory regions — this is intended for writing
+     * data we don't already know the contents of.
+     *
+     * @param thread The captured thread to execute on.
+     * @param dest Target address to write to.
+     * @param source Source pointer to read from (in our process).
+     * @param size Number of bytes to write.
+     */
+    async writeMemoryWithPointer(proxy, dest, source, size) {
+        const destAddr = dest instanceof Native.NativePointer ? dest.address : dest;
+        const buf = Native.currentProcess.memory.read(source, size);
+        if (buf.length === 0)
+            return 0;
+        // Standard decomposed memset — no romem check
+        let i = 0;
+        while (i < buf.length) {
+            const value = buf[i];
+            let j = i + 1;
+            while (j < buf.length && buf[j] === value) {
+                j++;
+            }
+            const runLen = j - i;
+            const addr = await proxy.call(crt.memset, destAddr + BigInt(i), value, runLen);
+            if (addr.address === 0n)
+                return i;
+            i = j;
+        }
+        return buf.length;
+    }
+    /**
+     * Safe write dispatcher: routes to the optimized variant based on `lastDest` type.
+     *
+     * @param dest Target address to write to.
+     * @param source The data to write.
+     * @param lastDest Either a snapshot Buffer of the previous state, or a single byte value
+     *                 representing a uniform fill (e.g. 0 means the region is all zeroes).
+     */
+    async writeMemorySafe(proxy, dest, source, lastDest) {
+        if (typeof lastDest === 'number') {
+            return this.writeMemorySafeUniform(proxy, dest, source, lastDest);
+        }
+        return this.writeMemorySafeBuffer(proxy, dest, source, lastDest);
+    }
+    /**
+     * Safe write against a uniform fill value.
+     * Skips bytes that already equal `fillByte`.
+     */
+    async writeMemorySafeUniform(proxy, dest, source, fillByte) {
+        const destAddr = dest.address;
+        const length = source.length;
+        if (length === 0)
+            return 0;
+        let i = 0;
+        while (i < length) {
+            while (i < length && source[i] === fillByte)
+                i++;
+            if (i >= length)
+                break;
+            const value = source[i];
+            let j = i + 1;
+            while (j < length && source[j] === value)
+                j++;
+            const runLen = j - i;
+            const addr = await proxy.call(crt.memset, destAddr + BigInt(i), value, runLen);
+            if (addr.address === 0n)
+                return i;
+            i = j;
+        }
+        return length;
+    }
+    /**
+     * Safe write against a snapshot Buffer.
+     * Skips bytes that match the corresponding byte in `last`.
+     */
+    async writeMemorySafeBuffer(proxy, dest, source, last) {
+        const destAddr = dest.address;
+        const length = source.length;
+        if (length === 0)
+            return 0;
+        let i = 0;
+        while (i < length) {
+            while (i < length && source[i] === last[i])
+                i++;
+            if (i >= length)
+                break;
+            const value = source[i];
+            let j = i + 1;
+            while (j < length && source[j] === value)
+                j++;
+            const runLen = j - i;
+            const addr = await proxy.call(crt.memset, destAddr + BigInt(i), value, runLen);
+            if (addr.address === 0n)
+                return i;
+            i = j;
+        }
+        return length;
+    }
+}
+//# sourceMappingURL=nthread.js.map

package/dist/nthread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nthread.js","sourceRoot":"","sources":["../src/nthread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AASxD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,OAAO;IAClB,sDAAsD;IAC/C,SAAS,CAAU;IAE1B,2EAA2E;IACpE,YAAY,CAAuB;IAE1C,6EAA6E;IACtE,cAAc,CAAuB;IAE5C,gEAAgE;IACzD,MAAM,CAAqB;IAElC;;;;;;OAMG;IACH,YACE,SAAkB,EAClB,YAAmC,EACnC,cAAqC,EACrC,MAA2B;QAE3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,2BAA2B;QAC3B,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,kBAAkB,GAAG,qBAAqB,EAAE,CAAC;YACnD,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACxB,MAAM,IAAI,mBAAmB,EAAE,CAAC;YAClC,CAAC;YACD,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC;QACzC,CAAC;QAED,qCAAqC;QACrC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;YACrC,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,qBAAqB,EAAE,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC,OAAO,CAAC;YAC5C,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,CACV,MAA8B;QAE9B,MAAM,QAAQ,GAAG,IAAI,cAAc,CACjC,MAAM,EACN,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEnB,QAAQ,CAAC,YAAY,EAAE,CAAC;QACxB,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;QAE9C,iDAAiD;QACjD,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC;QACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC;QAEtC,UAAU;QACV,sCAAsC;QACtC,kDAAkD;QAClD,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,QAAQ,CAAC,OAAO,GAAG,UAAU,GAAG,EAAE,CAAC;QAEnC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEjD,QAAQ,CAAC,YAAY,EAAE,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,CAAC;QAElB,UAAU,CAAC,IAAI,CACb,sBAAsB,QAAQ,CAAC,GAAG,aAAa,IAAI,CAAC,YAAY,KAAK,CACtE,CAAC;QAEF,mDAAmD;QACnD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,kEAAkE;QAClE,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;QAE9C,8EAA8E;QAC9E,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QAC/C,QAAQ,CAAC,YAAY,CAAC,GAAG,GAAG,GAAG,CAAC;QAChC,QAAQ,CAAC,YAAY,CAAC,GAAG,GAAG,GAAG,CAAC;QAEhC,sEAAsE;QACtE,QAAQ,CAAC,aAAa,CAAC,YAAY;YACjC,MAAM,CAAC,YAAY,CAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;QAE5D,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAChD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAC5C,CAAC;QACF;;YAEI;QACJ,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CACnD,CAAC;QACF,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAC9C,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAC9C,CAAC;QACF,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CACtC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CACrC,CAAC;QACF,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QAE9D,UAAU,CAAC,IAAI,CAAC,qCAAqC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAErE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,6EAA6E;IACrE,KAAK,CAAC,WAAW,CACvB,KAAkB,EAClB,OAA6B,EAC7B,IAAmC,EACnC,IAAa;QAEb,IAAI,IAAI,YAAY,MAAM,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,YAAY,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;QACrC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,WAAW,CACzB,MAAmB,EACnB,QAAwB,EACxB,OAAgB;QAEhB,IAAI,OAAO,KAAK,SAAS;YAAE,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvD,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,WAAW,CACzB,KAAkB,EAClB,IAAY,EACZ,IAAmB;QAEnB,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACpE,IAAI,GAAG,CAAC,OAAO,KAAK,EAAE;gBACpB,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,IAAI,iBAAiB,CACzE,CAAC;YACJ,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;QACxB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACnE,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,UAAU,CACxB,KAAkB,EAClB,GAAyB;QAEzB,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CACf,KAAkB,EAClB,GAAW,EACX,WAA2B,SAAS,EACpC,IAAmB;QAEnB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,UAAU,CACd,MAAsB,EACtB,MAAqC,EACrC,OAAc,EAAE,EAChB,YAAoB,IAAI;QAExB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,CAAM,EAAU,EAAE;YAClC,IAAI,CAAC,YAAY,MAAM,CAAC,aAAa;gBAAE,OAAO,CAAC,CAAC,OAAO,CAAC;YACxD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,UAAU,GACd,MAAM,YAAY,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3E,4DAA4D;QAC5D,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,YAAY,EAAE,CAAC;QAEtB,+DAA+D;QAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,UAAU,KAAK,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,oBAAoB,CAC5B,UAAU,EACV,UAAU,EACV,IAAI,CAAC,YAAY,CAAC,OAAO,CAC1B,CAAC;QACJ,CAAC;QAED,uDAAuD;QACvD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QAEjD,2CAA2C;QAC3C,2FAA2F;QAC3F,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC;QACrB,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;QAEzB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,CAAC,MAAM,EAAE,CAAC;QAEhB,UAAU,CAAC,KAAK,CACd,aAAa,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,MAAM,YAAY,CACrE,CAAC;QAEF,uEAAuE;QACvE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,GAAG,KAAK,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;QAED,4BAA4B;QAC5B,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAC9D,UAAU,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,WAAW,CACf,KAAkB,EAClB,IAAmC,EACnC,MAA2B;QAE3B,MAAM,QAAQ,GAAG,IAAI,YAAY,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,MAAM,IAAI,GAAG,MAAM,YAAY,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAE3B,wDAAwD;QACxD,MAAM,KAAK,GAAG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,cAAc,CAC1D,QAAQ,EACR,MAAM,EACN,KAAK,CACN,CAAC;YAEF,IAAI,OAAO,GAAG,CAAC,CAAC;YAEhB,8CAA8C;YAC9C,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,IAAI,MAAM,IAAI,CAAC,WAAW,CAC/B,KAAK,EACL,QAAQ,EACR,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC,CAC9B,CAAC;YACJ,CAAC;YAED,mDAAmD;YACnD,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,aAAa,CAC1C,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAC/B,CAAC;YACF,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAC/B,WAAW,EACX,WAAW,GAAG,UAAU,CACf,CAAC;YACZ,OAAO,IAAI,MAAM,IAAI,CAAC,qBAAqB,CACzC,KAAK,EACL,WAAW,EACX,WAAW,EACX,QAAQ,CACT,CAAC;YACF,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;YAExD,6CAA6C;YAC7C,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;YAC7C,IAAI,WAAW,GAAG,MAAM,EAAE,CAAC;gBACzB,OAAO,IAAI,MAAM,IAAI,CAAC,WAAW,CAC/B,KAAK,EACL,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,EAC9B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC3B,CAAC;YACJ,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBACvC,CAAC,EAAE,CAAC;YACN,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAC3B,GAAG,CAAC,MAAM,EACV,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EACpB,KAAK,EACL,MAAM,CACP,CAAC;YACF,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO,CAAC,CAAC;YAElC,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,sBAAsB,CAC1B,KAAkB,EAClB,IAAmC,EACnC,MAA4B,EAC5B,IAAY;QAEZ,MAAM,QAAQ,GAAG,IAAI,YAAY,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAE/B,8CAA8C;QAC9C,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC1C,CAAC,EAAE,CAAC;YACN,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAC3B,GAAG,CAAC,MAAM,EACV,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EACpB,KAAK,EACL,MAAM,CACP,CAAC;YACF,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO,CAAC,CAAC;YAElC,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;QAED,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,KAAkB,EAClB,IAA0B,EAC1B,MAAc,EACd,QAAyB;QAEzB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,sBAAsB,CAClC,KAAkB,EAClB,IAA0B,EAC1B,MAAc,EACd,QAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAE3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAAE,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,MAAM;gBAAE,MAAM;YAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK;gBAAE,CAAC,EAAE,CAAC;YAE9C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAC3B,GAAG,CAAC,MAAM,EACV,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EACpB,KAAK,EACL,MAAM,CACP,CAAC;YACF,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO,CAAC,CAAC;YAElC,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB,CACjC,KAAkB,EAClB,IAA0B,EAC1B,MAAc,EACd,IAAY;QAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAE3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;gBAAE,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,IAAI,MAAM;gBAAE,MAAM;YAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK;gBAAE,CAAC,EAAE,CAAC;YAE9C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAC3B,GAAG,CAAC,MAAM,EACV,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EACpB,KAAK,EACL,MAAM,CACP,CAAC;YACF,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO,CAAC,CAAC;YAElC,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/thread/captured-thread.d.ts

@@ -0,0 +1,68 @@
+import * as Native from '@cheatron/native';
+import type { GeneralPurposeRegs } from '../globals.js';
+export declare const STACK_ADD = -8192n;
+/**
+ * CapturedThread: A specialized Thread wrapper that manages the low-level state
+ * of a captured thread, including context caching, suspend/resume tracking,
+ * and register manipulation.
+ *
+ * It extends Native.Thread. A ProxyThread holds the reference back to this instance.
+ */
+export declare class CapturedThread extends Native.Thread {
+    /** Count of active suspensions to ensure balanced resume calls on close */
+    protected suspendCount: number;
+    /** The register context captured immediately before hijacking */
+    savedContext: Native.ThreadContext;
+    /** The current live or modified context of the thread */
+    latestContext: Native.ThreadContext;
+    /** Pre-computed RSP value used for call() — set once during inject() */
+    callRsp: bigint;
+    /** Address of an infinite loop gadget ('jmp .') used to hold the thread */
+    sleepAddress: Native.NativePointer;
+    /** The register key (e.g., 'Rbx') used for the pushret pivot */
+    regKey: GeneralPurposeRegs;
+    /**
+     * Creates a CapturedThread instance.
+     * @param thread Thread object or Thread ID to attach to.
+     * @param regKey The register key used for the pushret pivot.
+     * @param sleepAddress The sleep gadget address for parking the thread.
+     * @param processId Optional process ID for diagnostics and logging.
+     */
+    constructor(thread: Native.Thread | number, regKey: GeneralPurposeRegs, sleepAddress: Native.NativePointer, processId?: number);
+    /** Calculates a new stack pointer offset from the current RSP */
+    calcStackBegin(baseRsp?: bigint): bigint;
+    /** Gets the value of the pivot register */
+    getTargetReg(): Native.UINT64;
+    /** Sets the value of the pivot register */
+    setTargetReg(reg: Native.UINT64): void;
+    /** Helper to get RSP */
+    getRSP(): Native.UINT64;
+    /** Helper to set RSP */
+    setRSP(rsp: Native.UINT64): void;
+    /** Helper to get RIP */
+    getRIP(): Native.UINT64;
+    /** Helper to set RIP */
+    setRIP(rip: Native.UINT64): void;
+    /** Returns the last fetched/modified context cache */
+    getContext(): Native.ThreadContext;
+    /** Updates the context cache (does not apply to hardware yet) */
+    setContext(ctx: Native.ThreadContext): void;
+    /** Explicitly fetches context from the hardware into the cache */
+    fetchContext(): void;
+    /** Explicitly applies the cached context to the hardware */
+    applyContext(): void;
+    /** Suspends the thread and increments internal counter */
+    suspend(): number;
+    /** Resumes the thread and decrements internal counter */
+    resume(): number;
+    /** Restores the saved context and resumes the thread (without closing the handle) */
+    release(): void;
+    /** Closes the handle and ensures the thread is resumed if it was suspended by us */
+    close(): void;
+    /**
+     * Custom wait that polls the thread's RIP to see if it landed at the sleepAddress.
+     * If the thread dies or crashes during wait, it returns FAILED.
+     */
+    wait(timeoutMs?: number): Promise<Native.WaitReturn>;
+}
+//# sourceMappingURL=captured-thread.d.ts.map

package/dist/thread/captured-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captured-thread.d.ts","sourceRoot":"","sources":["../../src/thread/captured-thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,MAAM,CAAC,MAAM;IAC/C,2EAA2E;IAC3E,SAAS,CAAC,YAAY,SAAK;IAE3B,iEAAiE;IAC1D,YAAY,EAAG,MAAM,CAAC,aAAa,CAAC;IAE3C,yDAAyD;IAClD,aAAa,EAAG,MAAM,CAAC,aAAa,CAAC;IAE5C,wEAAwE;IACjE,OAAO,EAAE,MAAM,CAAM;IAE5B,2EAA2E;IACpE,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IAE1C,gEAAgE;IACzD,MAAM,EAAE,kBAAkB,CAAC;IAElC;;;;;;OAMG;gBAED,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,CAAC,aAAa,EAClC,SAAS,CAAC,EAAE,MAAM;IAkBpB,iEAAiE;IACjE,cAAc,CAAC,OAAO,GAAE,MAAsC,GAAG,MAAM;IAIvE,2CAA2C;IAC3C,YAAY,IAAI,MAAM,CAAC,MAAM;IAI7B,2CAA2C;IAC3C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI;IAMtC,wBAAwB;IACxB,MAAM,IAAI,MAAM,CAAC,MAAM;IAIvB,wBAAwB;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI;IAMhC,wBAAwB;IACxB,MAAM,IAAI,MAAM,CAAC,MAAM;IAIvB,wBAAwB;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI;IAMhC,sDAAsD;IAC7C,UAAU,IAAI,MAAM,CAAC,aAAa;IAO3C,iEAAiE;IACxD,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,aAAa,GAAG,IAAI;IAIpD,kEAAkE;IAClE,YAAY,IAAI,IAAI;IAIpB,4DAA4D;IAC5D,YAAY,IAAI,IAAI;IAIpB,0DAA0D;IACjD,OAAO,IAAI,MAAM;IAQ1B,yDAAyD;IAChD,MAAM,IAAI,MAAM;IAQzB,qFAAqF;IACrF,OAAO,IAAI,IAAI;IAOf,oFAAoF;IAC3E,KAAK;IAiBd;;;OAGG;IACY,IAAI,CACjB,SAAS,GAAE,MAAwB,GAClC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;CAwB9B"}