Build api enhancements (#66)

* Add GetCreatedTimestamp and GetLastExecutionTimestamp to Build interface

* Feature: Add GetRecentBuildJobs() API to UIEnvironment

Add new API method to retrieve recent validated build jobs for
touchscreen UI display.

Changes:
1. **IDL Definition** (ACT/LibMCEnv.xml):
   - Added BuildIterator class following BuildExecutionIterator pattern
   - Added GetRecentBuildJobs(maxCount) method to UIEnvironment

2. **BuildIterator Implementation**:
   - New class CBuildIterator (libmcenv_builditerator.hpp/cpp)
   - Implements GetCurrentBuild() to return IBuild instances
   - Follows standard AMCF iterator pattern

3. **UIEnvironment Implementation** (libmcenv_uienvironment.cpp):
   - GetRecentBuildJobs() queries validated build jobs via DataModel
   - Returns BuildIterator with most recent jobs (newest first)
   - Limited by maxCount parameter

4. **CBuild Factory Methods** (libmcenv_build.cpp/hpp):
   - Added makeFrom() and makeSharedFrom() static methods
   - Enables BuildIterator to wrap existing build job instances

This API enables plugins to access build job data for UI display
without direct DataModel access, maintaining proper abstraction.

---

InterfacesCode: Regenerate interface files from ACT for GetRecentBuildJobs API

Regenerated C++ interface bindings and headers using ACT (Automatic
Component Toolkit) after adding GetRecentBuildJobs() method to
LibMCEnv.xml.

Generated/Updated files:
- Framework/HeadersDev/CppDynamic/libmcenv_dynamic.hpp
- Framework/HeadersDev/CppDynamic/libmcenv_dynamic.h
- Framework/HeadersDev/CppDynamic/libmcenv_types.hpp
- Framework/InterfacesCore/libmcenv_abi.hpp
- Framework/InterfacesCore/libmcenv_interfaces.hpp
- Framework/InterfacesCore/libmcenv_interfacewrapper.cpp
- Framework/InterfacesCore/libmcenv_types.hpp
- ACT/act.linux (binary timestamp update)

These files are auto-generated by running: ./act.linux LibMCEnv.xml

Author: krixkrix

ACT/LibMCEnv.xml

@@ -2591,6 +2591,12 @@
 		</method>
 	</class>
 
+	<class name="BuildIterator" parent="Iterator">
+		<method name="GetCurrentBuild" description="Returns the build the iterator points at.">
+			<param name="BuildInstance" type="handle" class="Build" pass="return" description="returns the Build instance."/>
+		</method>
+	</class>
+
 
 	<class name="Build" parent="Base" description="Build instance to access build files">
 
@@ -2602,6 +2608,14 @@
 			<param name="BuildUUID" type="string" pass="return" description="UUID of the build." />
 		</method>
 
+		<method name="GetCreatedTimestamp" description="Returns creation timestamp of the build in ISO-8601 format.">
+			<param name="Timestamp" type="string" pass="return" description="Creation timestamp in ISO-8601 format (e.g., 2025-10-23T14:30:00.000Z)." />
+		</method>
+
+		<method name="GetLastExecutionTimestamp" description="Returns the most recent execution timestamp in ISO-8601 format. Returns empty string if build has never been executed.">
+			<param name="Timestamp" type="string" pass="return" description="Most recent execution timestamp in ISO-8601 format. Empty string if never executed." />
+		</method>
+
 		<method name="GetStorageUUID" description="Returns storage uuid of the build stream.">
 			<param name="StorageUUID" type="string" pass="return" description="Storage UUID of the build." />
 		</method>
@@ -5742,6 +5756,10 @@
 			<param name="ExecutionUUID" type="string" pass="in" description="UUID of the execution entity." />
 			<param name="ExecutionInstance" type="class" class="BuildExecution" pass="return" description="Build execution instance" />
 		</method>
+	<method name="GetRecentBuildJobs" description="Returns an iterator for recent build jobs, ordered by timestamp (newest first).">
+		<param name="MaxCount" type="uint32" pass="in" description="Maximum number of jobs to return. Must be greater than 0." />
+		<param name="BuildIterator" type="class" class="BuildIterator" pass="return" description="Iterator for build jobs, ordered newest first." />
+	</method>
 
 		<method name="CreateDiscreteField2D" description="Creates an empty discrete field.">
 			<param name="PixelCountX" type="uint32" pass="in" description="Pixel count in X. MUST be positive." />
@@ -5913,6 +5931,26 @@
 			<param name="ReturnValueName" type="string" pass="in" description="The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)" />
 			<param name="ReturnValue" type="string" pass="in" description="Return value." />
 		</method>
+
+	<method name="SetStringResult" description="Sets a string result value for external event return (typed convenience wrapper).">
+		<param name="ReturnValueName" type="string" pass="in" description="The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)" />
+		<param name="ReturnValue" type="string" pass="in" description="Return value." />
+	</method>
+
+	<method name="SetIntegerResult" description="Sets an integer result value for external event return.">
+		<param name="ReturnValueName" type="string" pass="in" description="The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)" />
+		<param name="ReturnValue" type="int64" pass="in" description="Return value." />
+	</method>
+
+	<method name="SetBoolResult" description="Sets a boolean result value for external event return.">
+		<param name="ReturnValueName" type="string" pass="in" description="The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)" />
+		<param name="ReturnValue" type="bool" pass="in" description="Return value." />
+	</method>
+
+	<method name="SetDoubleResult" description="Sets a double result value for external event return.">
+		<param name="ReturnValueName" type="string" pass="in" description="The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)" />
+		<param name="ReturnValue" type="double" pass="in" description="Return value." />
+	</method>
 
 		<method name="GetExternalEventParameters" description="Returns the external event parameters. This JSON Object was passed on from the external API.">
 			<param name="ParameterValue" type="class" class="JSONObject" pass="return" description="Parameter value." />

ACT/act.linux

@@ -4234,6 +4234,19 @@ typedef LibMCEnvResult (*PLibMCEnvBuildExecution_LoadAttachedJournalPtr) (LibMCE
 */
 typedef LibMCEnvResult (*PLibMCEnvBuildExecutionIterator_GetCurrentExecutionPtr) (LibMCEnv_BuildExecutionIterator pBuildExecutionIterator, LibMCEnv_BuildExecution * pBuildExecutionInstance);
 
+/*************************************************************************************************************************
+ Class definition for BuildIterator
+**************************************************************************************************************************/
+
+/**
+* Returns the build the iterator points at.
+*
+* @param[in] pBuildIterator - BuildIterator instance.
+* @param[out] pBuildInstance - returns the Build instance.
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvBuildIterator_GetCurrentBuildPtr) (LibMCEnv_BuildIterator pBuildIterator, LibMCEnv_Build * pBuildInstance);
+
 /*************************************************************************************************************************
  Class definition for Build
 **************************************************************************************************************************/
@@ -4260,6 +4273,28 @@ typedef LibMCEnvResult (*PLibMCEnvBuild_GetNamePtr) (LibMCEnv_Build pBuild, cons
 */
 typedef LibMCEnvResult (*PLibMCEnvBuild_GetBuildUUIDPtr) (LibMCEnv_Build pBuild, const LibMCEnv_uint32 nBuildUUIDBufferSize, LibMCEnv_uint32* pBuildUUIDNeededChars, char * pBuildUUIDBuffer);
 
+/**
+* Returns creation timestamp of the build in ISO-8601 format.
+*
+* @param[in] pBuild - Build instance.
+* @param[in] nTimestampBufferSize - size of the buffer (including trailing 0)
+* @param[out] pTimestampNeededChars - will be filled with the count of the written bytes, or needed buffer size.
+* @param[out] pTimestampBuffer -  buffer of Creation timestamp in ISO-8601 format (e.g., 2025-10-23T14:30:00.000Z)., may be NULL
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvBuild_GetCreatedTimestampPtr) (LibMCEnv_Build pBuild, const LibMCEnv_uint32 nTimestampBufferSize, LibMCEnv_uint32* pTimestampNeededChars, char * pTimestampBuffer);
+
+/**
+* Returns the most recent execution timestamp in ISO-8601 format. Returns empty string if build has never been executed.
+*
+* @param[in] pBuild - Build instance.
+* @param[in] nTimestampBufferSize - size of the buffer (including trailing 0)
+* @param[out] pTimestampNeededChars - will be filled with the count of the written bytes, or needed buffer size.
+* @param[out] pTimestampBuffer -  buffer of Most recent execution timestamp in ISO-8601 format. Empty string if never executed., may be NULL
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvBuild_GetLastExecutionTimestampPtr) (LibMCEnv_Build pBuild, const LibMCEnv_uint32 nTimestampBufferSize, LibMCEnv_uint32* pTimestampNeededChars, char * pTimestampBuffer);
+
 /**
 * Returns storage uuid of the build stream.
 *
@@ -10607,6 +10642,16 @@ typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_HasBuildExecutionPtr) (LibMCEnv_
 */
 typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_GetBuildExecutionPtr) (LibMCEnv_UIEnvironment pUIEnvironment, const char * pExecutionUUID, LibMCEnv_BuildExecution * pExecutionInstance);
 
+/**
+* Returns an iterator for recent build jobs, ordered by timestamp (newest first).
+*
+* @param[in] pUIEnvironment - UIEnvironment instance.
+* @param[in] nMaxCount - Maximum number of jobs to return. Must be greater than 0.
+* @param[out] pBuildIterator - Iterator for build jobs, ordered newest first.
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_GetRecentBuildJobsPtr) (LibMCEnv_UIEnvironment pUIEnvironment, LibMCEnv_uint32 nMaxCount, LibMCEnv_BuildIterator * pBuildIterator);
+
 /**
 * Creates an empty discrete field.
 *
@@ -10949,6 +10994,46 @@ typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_GetExternalEventParameterPtr) (L
 */
 typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_AddExternalEventResultValuePtr) (LibMCEnv_UIEnvironment pUIEnvironment, const char * pReturnValueName, const char * pReturnValue);
 
+/**
+* Sets a string result value for external event return (typed convenience wrapper).
+*
+* @param[in] pUIEnvironment - UIEnvironment instance.
+* @param[in] pReturnValueName - The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)
+* @param[in] pReturnValue - Return value.
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_SetStringResultPtr) (LibMCEnv_UIEnvironment pUIEnvironment, const char * pReturnValueName, const char * pReturnValue);
+
+/**
+* Sets an integer result value for external event return.
+*
+* @param[in] pUIEnvironment - UIEnvironment instance.
+* @param[in] pReturnValueName - The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)
+* @param[in] nReturnValue - Return value.
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_SetIntegerResultPtr) (LibMCEnv_UIEnvironment pUIEnvironment, const char * pReturnValueName, LibMCEnv_int64 nReturnValue);
+
+/**
+* Sets a boolean result value for external event return.
+*
+* @param[in] pUIEnvironment - UIEnvironment instance.
+* @param[in] pReturnValueName - The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)
+* @param[in] bReturnValue - Return value.
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_SetBoolResultPtr) (LibMCEnv_UIEnvironment pUIEnvironment, const char * pReturnValueName, bool bReturnValue);
+
+/**
+* Sets a double result value for external event return.
+*
+* @param[in] pUIEnvironment - UIEnvironment instance.
+* @param[in] pReturnValueName - The name of the return parameter. MUST be an alphanumeric ASCII string (with optional _ and -)
+* @param[in] dReturnValue - Return value.
+* @return error code or 0 (success)
+*/
+typedef LibMCEnvResult (*PLibMCEnvUIEnvironment_SetDoubleResultPtr) (LibMCEnv_UIEnvironment pUIEnvironment, const char * pReturnValueName, LibMCEnv_double dReturnValue);
+
 /**
 * Returns the external event parameters. This JSON Object was passed on from the external API.
 *
@@ -11424,8 +11509,11 @@ typedef struct {
 	PLibMCEnvBuildExecution_GetMetaDataStringPtr m_BuildExecution_GetMetaDataString;
 	PLibMCEnvBuildExecution_LoadAttachedJournalPtr m_BuildExecution_LoadAttachedJournal;
 	PLibMCEnvBuildExecutionIterator_GetCurrentExecutionPtr m_BuildExecutionIterator_GetCurrentExecution;
+	PLibMCEnvBuildIterator_GetCurrentBuildPtr m_BuildIterator_GetCurrentBuild;
 	PLibMCEnvBuild_GetNamePtr m_Build_GetName;
 	PLibMCEnvBuild_GetBuildUUIDPtr m_Build_GetBuildUUID;
+	PLibMCEnvBuild_GetCreatedTimestampPtr m_Build_GetCreatedTimestamp;
+	PLibMCEnvBuild_GetLastExecutionTimestampPtr m_Build_GetLastExecutionTimestamp;
 	PLibMCEnvBuild_GetStorageUUIDPtr m_Build_GetStorageUUID;
 	PLibMCEnvBuild_GetStorageSHA256Ptr m_Build_GetStorageSHA256;
 	PLibMCEnvBuild_EnsureStorageSHA256IsValidPtr m_Build_EnsureStorageSHA256IsValid;
@@ -12019,6 +12107,7 @@ typedef struct {
 	PLibMCEnvUIEnvironment_GetBuildJobPtr m_UIEnvironment_GetBuildJob;
 	PLibMCEnvUIEnvironment_HasBuildExecutionPtr m_UIEnvironment_HasBuildExecution;
 	PLibMCEnvUIEnvironment_GetBuildExecutionPtr m_UIEnvironment_GetBuildExecution;
+	PLibMCEnvUIEnvironment_GetRecentBuildJobsPtr m_UIEnvironment_GetRecentBuildJobs;
 	PLibMCEnvUIEnvironment_CreateDiscreteField2DPtr m_UIEnvironment_CreateDiscreteField2D;
 	PLibMCEnvUIEnvironment_CreateDiscreteField2DFromImagePtr m_UIEnvironment_CreateDiscreteField2DFromImage;
 	PLibMCEnvUIEnvironment_CheckPermissionPtr m_UIEnvironment_CheckPermission;
@@ -12051,6 +12140,10 @@ typedef struct {
 	PLibMCEnvUIEnvironment_HasExternalEventParameterPtr m_UIEnvironment_HasExternalEventParameter;
 	PLibMCEnvUIEnvironment_GetExternalEventParameterPtr m_UIEnvironment_GetExternalEventParameter;
 	PLibMCEnvUIEnvironment_AddExternalEventResultValuePtr m_UIEnvironment_AddExternalEventResultValue;
+	PLibMCEnvUIEnvironment_SetStringResultPtr m_UIEnvironment_SetStringResult;
+	PLibMCEnvUIEnvironment_SetIntegerResultPtr m_UIEnvironment_SetIntegerResult;
+	PLibMCEnvUIEnvironment_SetBoolResultPtr m_UIEnvironment_SetBoolResult;
+	PLibMCEnvUIEnvironment_SetDoubleResultPtr m_UIEnvironment_SetDoubleResult;
 	PLibMCEnvUIEnvironment_GetExternalEventParametersPtr m_UIEnvironment_GetExternalEventParameters;
 	PLibMCEnvUIEnvironment_GetExternalEventResultsPtr m_UIEnvironment_GetExternalEventResults;
 	PLibMCEnvUIEnvironment_CreateMachineConfigurationHandlerPtr m_UIEnvironment_CreateMachineConfigurationHandler;