feat(core): emit deploy run results to Garden Cloud (#7781)

With this change we include the results with the
ACTION_RUN_COMPLETED event if the action kind is Deploy.

This enables us display links to ingresses in the Garden Cloud UI.

The plan was also to include kind specific state such as whether a Test
action was cached in team or local cache but that's a bigger lift and
will need be handled in a separate PR.

The protobuf schema already accounts for those fields as well though.

Author: eysi09

core/package.json

@@ -26,7 +26,7 @@
   "types": "build/src/index.d.ts",
   "dependencies": {
     "@bufbuild/protobuf": "2.8.0",
-    "@buf/garden_grow-platform.bufbuild_es": "2.8.0-20250916142245-2420a337ce6a.1",
+    "@buf/garden_grow-platform.bufbuild_es": "2.8.0-20251027135652-778164cdd988.1",
     "@codenamize/codenamize": "^1.1.1",
     "@connectrpc/connect": "2.1.0",
     "@connectrpc/connect-node": "2.0.4",
@@ -279,4 +279,4 @@
     "fsevents": "^2.3.3"
   },
   "gitHead": "b0647221a4d2ff06952bae58000b104215aed922"
-}
+}

core/src/cloud/api/grpc-event-converter.ts

@@ -34,6 +34,7 @@ import {
   GardenCommandExecutionStartedSchema,
 } from "@buf/garden_grow-platform.bufbuild_es/garden/public/events/v1/garden_command_pb.js"
 import { timestampFromDate } from "@bufbuild/protobuf/wkt"
+import type { DeployRunResult } from "@buf/garden_grow-platform.bufbuild_es/garden/public/events/v1/garden_action_pb.js"
 import {
   GardenActionGetStatusCompletedSchema,
   GardenActionGetStatusStartedSchema,
@@ -43,7 +44,10 @@ import {
   GardenActionRunCompletedSchema,
   GardenActionRunStartedSchema,
   GardenActionScannedSchema,
+  ServiceIngressSchema,
+  DeployRunResultSchema,
 } from "@buf/garden_grow-platform.bufbuild_es/garden/public/events/v1/garden_action_pb.js"
+import type { DeployStatusForEventPayload } from "../../types/service.js"
 
 const nextEventUlid = monotonicFactory()
 
@@ -233,13 +237,44 @@ export class GrpcEventConverter {
             }),
           ]
         } else if (payload.operation === "process") {
+          const actionKind = payload.actionKind
+
+          let deployRunResult: DeployRunResult | undefined = undefined
+
+          if (actionKind === "deploy" && "status" in payload && payload.status) {
+            const deployStatus = payload.status as DeployStatusForEventPayload
+
+            deployRunResult = create(DeployRunResultSchema, {
+              createdAt: deployStatus.createdAt,
+              mode: deployStatus.mode,
+              externalId: deployStatus.externalId,
+              externalVersion: deployStatus.externalVersion,
+              ingresses:
+                deployStatus.ingresses?.map((ingress) =>
+                  create(ServiceIngressSchema, {
+                    hostname: ingress.hostname,
+                    linkUrl: ingress.linkUrl,
+                    path: ingress.path || "/",
+                    port: ingress.port,
+                    protocol: ingress.protocol,
+                  })
+                ) || [],
+              lastMessage: deployStatus.lastMessage,
+              lastError: deployStatus.lastError,
+              runningReplicas: deployStatus.runningReplicas,
+              updatedAt: deployStatus.updatedAt,
+            })
+          }
+
           return [
             createGardenCliEvent(context, GardenCliEventType.ACTION_RUN_COMPLETED, {
               case: "actionRunCompleted",
               value: create(GardenActionRunCompletedSchema, {
                 actionUlid: this.mapToUlid(payload.actionUid, "actionUid", "actionUlid"),
                 completedAt: timestampFromDate(new Date()),
                 success: !["not-ready", "failed", "unknown"].includes(payload.state),
+                // This is undefined for non-Deploy actions
+                deployRunResult,
               }),
             }),
           ]

core/src/events/action-status-events.ts

@@ -6,6 +6,7 @@
  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
  */
 
+import type { ActionKind } from "../actions/types.js"
 import { actionStates } from "../actions/types.js"
 import type { BuildState } from "../plugin/handlers/Build/get-status.js"
 import type { ActionRuntime, RunState } from "../plugin/plugin.js"
@@ -94,7 +95,7 @@ interface ActionStatusPayloadBase {
    * should've been actionKind.
    */
   actionType: string
-  actionKind: string
+  actionKind: Lowercase<ActionKind>
   actionVersion: string
   actionUid: string
   /**

core/src/events/util.ts

@@ -78,7 +78,7 @@ export function makeActionStatusPayloadBase({
     actionName: action.name,
     actionVersion: action.versionString(log),
     // NOTE: The type/kind needs to be lower case in the event payload
-    actionKind: action.kind.toLowerCase(),
+    actionKind: action.kind.toLowerCase() as Lowercase<ActionKind>,
     actionType: action.type,
     actionUid: action.uid,
     moduleName: action.moduleName(),

core/test/unit/src/cloud/grpc-event-stream.ts

@@ -20,6 +20,7 @@ import type { Log } from "../../../../src/logger/log-entry.js"
 import { getRootLogger } from "../../../../src/logger/logger.js"
 import { makeTestGardenA } from "../../../helpers.js"
 import { sleep } from "../../../../src/util/util.js"
+import type { GardenActionRunCompleted } from "@buf/garden_grow-platform.bufbuild_es/garden/public/events/v1/garden_action_pb.js"
 
 const receivedEvents = new Array<Event>()
 // if this is true, the mock backend will simulate failures.
@@ -187,6 +188,76 @@ describe("GrpcEventStream", () => {
     expect(event.eventData.value).to.be.an("object")
   })
 
+  it("should include Deploy process result when applicable", async () => {
+    garden.events.emit("deployStatus", {
+      startedAt: new Date().toISOString(),
+      completedAt: new Date().toISOString(),
+      state: "ready",
+      status: {
+        createdAt: new Date().toISOString(),
+        mode: "sync",
+        externalId: "fake-external-id",
+        externalVersion: "fake-external-version",
+        forwardablePorts: [],
+        ingresses: [
+          {
+            hostname: "fake-hostname",
+            linkUrl: "fake-link-url",
+            path: "/",
+            port: 443,
+            protocol: "https",
+          },
+        ],
+        lastMessage: "hello",
+        lastError: "goodbye",
+        outputs: {},
+        runningReplicas: 3,
+        state: "ready",
+        updatedAt: new Date().toISOString(),
+      },
+      actionName: "api",
+      actionKind: "deploy",
+      actionType: "kubernetes",
+      actionUid: "fake-action-uid",
+      sessionId: "fake-session-id",
+      operation: "process",
+      force: false,
+      actionVersion: "foobar",
+      moduleName: null,
+      runtime: undefined,
+    })
+    await bufferedEventStream.close()
+    expect(receivedEvents.length).to.equal(1)
+    const event = receivedEvents[0]
+
+    const eventPayload = event.eventData.value?.eventData.value as GardenActionRunCompleted
+
+    expect(event.eventUlid).to.be.a("string")
+    expect(event.eventData).to.be.an("object")
+    expect(eventPayload.deployRunResult).to.be.an("object")
+    expect(eventPayload.deployRunResult).to.eql({
+      $typeName: eventPayload.deployRunResult?.$typeName,
+      ingresses: [
+        {
+          $typeName: eventPayload.deployRunResult?.ingresses[0].$typeName,
+          hostname: "fake-hostname",
+          linkUrl: "fake-link-url",
+          path: "/",
+          port: 443,
+          protocol: "https",
+        },
+      ],
+      createdAt: eventPayload.deployRunResult?.createdAt,
+      mode: "sync",
+      externalId: "fake-external-id",
+      externalVersion: "fake-external-version",
+      lastMessage: "hello",
+      lastError: "goodbye",
+      runningReplicas: 3,
+      updatedAt: eventPayload.deployRunResult?.updatedAt,
+    })
+  })
+
   it("should send events in the correct order even when facing transient failures", async () => {
     // Simulate unreliable backend
     simulateUnreliableBackend = true