fix: 670 pipedream actor tagging

components/apify/actions/run-actor/run-actor.mjs

@@ -388,12 +388,7 @@ export default {
     }
 
     if (buildTag) {
-      const taggedBuilds = actorDetails.taggedBuilds || {};
-      if (!taggedBuilds[buildTag]) {
-        throw new Error(
-          `Build with tag "${buildTag}" was not found for actor "${actorDetails.title || actorDetails.name}".`,
-        );
-      }
+      await apify.resolveBuildId(actorId, buildTag);
     }
 
     // Prepare input

components/apify/apify.app.mjs

@@ -81,15 +81,25 @@ export default {
     buildTag: {
       type: "string",
       label: "Build",
-      description: "Specifies the Actor build to run. The accepted value is the build tag. If not provided, the default build will be used.",
+      description: "Actor build to run. Pick a tag from the list or enter a build number (e.g. `0.1.2`). Defaults to the Actor's default build.",
       async options({ actorId }) {
-        const { taggedBuilds } = await this.getActor({
+        if (!actorId) {
+          return [];
+        }
+
+        const { taggedBuilds = {} } = await this.getActor({
           actorId,
         });
 
         return Object.entries(taggedBuilds).map(([
-          name,
-        ]) => name);
+          tag,
+          info,
+        ]) => ({
+          label: info?.buildNumber
+            ? `${tag} (${info.buildNumber})`
+            : tag,
+          value: tag,
+        }));
       },
     },
     clean: {
@@ -200,29 +210,43 @@ export default {
       return this._client().actor(actorId)
         .get();
     },
-    async getBuild(actorId, buildTag) {
-      // Get actor details
+    async resolveBuildId(actorId, buildRef) {
       const actor = await this._client().actor(actorId)
         .get();
 
       if (!actor) {
         throw new Error(`Actor ${actorId} not found.`);
       }
 
-      if (!buildTag) {
-        buildTag = actor.defaultRunOptions.build;
+      if (!buildRef) {
+        buildRef = actor.defaultRunOptions.build;
+      }
+
+      const taggedBuilds = actor.taggedBuilds ?? {};
+
+      if (taggedBuilds[buildRef]?.buildId) {
+        return taggedBuilds[buildRef].buildId;
       }
 
-      const { taggedBuilds } = actor;
+      const { items: builds = [] } = await this.listBuilds({
+        actorId,
+        desc: true,
+        limit: LIMIT,
+      });
+      const match = builds.find(({ buildNumber }) => buildNumber === buildRef);
 
-      if (taggedBuilds[buildTag]) {
-        return this._client().build(taggedBuilds[buildTag].buildId)
-          .get();
-      } else {
-        throw new Error(
-          `Actor ${actorId} has no build tagged "${buildTag}". Please build the actor first.`,
-        );
+      if (match) {
+        return match.id;
       }
+
+      throw new Error(
+        `No build with tag or number "${buildRef}" found for actor ${actorId}.`,
+      );
+    },
+    async getBuild(actorId, buildRef) {
+      const buildId = await this.resolveBuildId(actorId, buildRef);
+      return this._client().build(buildId)
+        .get();
     },
     listActors(opts = {}) {
       return this._client().store()
@@ -240,10 +264,12 @@ export default {
       return this._client().tasks()
         .list(opts);
     },
-    listBuilds({ actorId }) {
+    listBuilds({
+      actorId, ...opts
+    }) {
       return this._client().actor(actorId)
         .builds()
-        .list();
+        .list(opts);
     },
     listKeyValueStores(opts = {}) {
       return this._client().keyValueStores()