Add TTDHeapEvent structure and core API implementation

Co-authored-by: xusheng6 <94503187+xusheng6@users.noreply.github.com>

Author: Copilot

.gitignore

@@ -69,4 +69,6 @@ api/python/__pycache__
 # TTD files
 *.run
 *.idx
-*.bndb
+*.bndb
+
+__pycache__/

api/debuggerapi.h

@@ -538,7 +538,7 @@ namespace BinaryNinjaDebuggerAPI {
 		uint64_t size;                 // Size of the module in bytes
 		uint32_t checksum;             // Checksum of the module
 		uint32_t timestamp;            // Timestamp of the module
-		
+
 		TTDModule() : address(0), size(0), checksum(0), timestamp(0) {}
 	};
 
@@ -551,7 +551,7 @@ namespace BinaryNinjaDebuggerAPI {
 		TTDPosition lifetimeEnd;       // Lifetime end position
 		TTDPosition activeTimeStart;   // Active time start position
 		TTDPosition activeTimeEnd;     // Active time end position
-		
+
 		TTDThread() : uniqueId(0), id(0) {}
 	};
 
@@ -571,7 +571,7 @@ namespace BinaryNinjaDebuggerAPI {
 		uint32_t flags;                // Exception flags
 		uint64_t recordAddress;        // Where in memory the exception record is found
 		TTDPosition position;          // Position where exception occurred
-		
+
 		TTDException() : type(TTDExceptionSoftware), programCounter(0), code(0), flags(0), recordAddress(0) {}
 	};
 
@@ -580,16 +580,41 @@ namespace BinaryNinjaDebuggerAPI {
 	{
 		TTDEventType type;             // Type of event
 		TTDPosition position;          // Position where event occurred
-		
+
 		// Optional child objects - existence depends on event type
 		std::optional<TTDModule> module;      // For ModuleLoaded/ModuleUnloaded events
 		std::optional<TTDThread> thread;      // For ThreadCreated/ThreadTerminated events
 		std::optional<TTDException> exception; // For Exception events
-		
+
 		TTDEvent() : type(TTDEventThreadCreated) {}
 		TTDEvent(TTDEventType eventType) : type(eventType) {}
 	};
 
+	struct TTDHeapEvent
+	{
+		std::string eventType;         // Event type (always "Heap" for TTD.Heap objects)
+		std::string action;            // Heap action: Alloc, ReAlloc, Free, Create, Protect, Lock, Unlock, Destroy
+		uint32_t threadId;             // OS thread ID of thread that made the heap call
+		uint32_t uniqueThreadId;       // Unique ID for the thread across the trace
+		uint64_t heap;                 // Handle for the Win32 heap
+		uint64_t address;              // Address of the allocated object (if applicable)
+		uint64_t previousAddress;      // Address before reallocation (for ReAlloc)
+		uint64_t size;                 // Size of allocated object (if applicable)
+		uint64_t baseAddress;          // Base address of allocated object (if applicable)
+		uint64_t flags;                // Heap API flags (meaning depends on API)
+		uint64_t result;               // Result of heap API call (non-zero = success)
+		uint64_t reserveSize;          // Amount of memory to reserve (for Create)
+		uint64_t commitSize;           // Initial committed size (for Create)
+		uint64_t makeReadOnly;         // Non-zero = make heap read-only (for Protect)
+		std::vector<std::string> parameters; // Raw parameters from the heap call
+		TTDPosition timeStart;         // Position when heap operation started
+		TTDPosition timeEnd;           // Position when heap operation ended
+
+		TTDHeapEvent() : threadId(0), uniqueThreadId(0), heap(0), address(0), previousAddress(0),
+		                 size(0), baseAddress(0), flags(0), result(0), reserveSize(0),
+		                 commitSize(0), makeReadOnly(0) {}
+	};
+
 
 	typedef BNDebugAdapterConnectionStatus DebugAdapterConnectionStatus;
 	typedef BNDebugAdapterTargetStatus DebugAdapterTargetStatus;
@@ -764,6 +789,7 @@ namespace BinaryNinjaDebuggerAPI {
 		std::vector<TTDCallEvent> GetTTDCallsForSymbols(const std::string& symbols, uint64_t startReturnAddress = 0, uint64_t endReturnAddress = 0);
 		std::vector<TTDEvent> GetTTDEvents(TTDEventType eventType);
 		std::vector<TTDEvent> GetAllTTDEvents();
+		std::vector<TTDHeapEvent> GetTTDHeapObjects();
 		TTDPosition GetCurrentTTDPosition();
 		bool SetTTDPosition(const TTDPosition& position);