Skip to content

Build api enhancements #66

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alexanderoster merged 2 commits into from
Jan 18, 2026
Merged

Build api enhancements #66

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c4eb9a0
Add GetCreatedTimestamp and GetLastExecutionTimestamp to Build interface
krixkrix Oct 23, 2025
e6a8347
Feature: Add GetRecentBuildJobs() API to UIEnvironment
krixkrix Oct 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions ACT/LibMCEnv.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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">

Expand All @@ -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>
Expand Down Expand Up @@ -5729,6 +5743,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." />
Expand Down Expand Up @@ -5900,6 +5918,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." />
Expand Down
Empty file modified ACT/act.linux
100644 → 100755
View file
Open in desktop
Empty file.
93 changes: 93 additions & 0 deletions Framework/HeadersDev/CppDynamic/libmcenv_dynamic.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
**************************************************************************************************************************/
Expand All @@ -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.
*
Expand Down Expand Up @@ -10587,6 +10622,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.
*
Expand Down Expand Up @@ -10929,6 +10974,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.
*
Expand Down Expand Up @@ -11404,8 +11489,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;
Expand Down Expand Up @@ -11997,6 +12085,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;
Expand Down Expand Up @@ -12029,6 +12118,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;
Expand Down
Loading