From 6b6ce059fe9ced21e7f872801241c6b11e43e7f5 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 13:12:14 +0000
Subject: [PATCH 01/17] Signal workflow API

---
 .../[runId]/(actions)/signal/route.ts         |  18 +++
 .../__tests__/signal-workflow.node.ts         | 127 ++++++++++++++++++
 .../schemas/signal-workflow-input-schema.ts   |  15 +++
 .../signal-workflow-request-body-schema.ts    |   9 ++
 .../signal-workflow/signal-workflow.ts        |  58 ++++++++
 .../signal-workflow/signal-workflow.types.ts  |  14 ++
 6 files changed, 241 insertions(+)
 create mode 100644 src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts
 create mode 100644 src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
 create mode 100644 src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts
 create mode 100644 src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts
 create mode 100644 src/route-handlers/signal-workflow/signal-workflow.ts
 create mode 100644 src/route-handlers/signal-workflow/signal-workflow.types.ts

diff --git a/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts b/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts
new file mode 100644
index 000000000..4fe2d1f5c
--- /dev/null
+++ b/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts
@@ -0,0 +1,18 @@
+import { type NextRequest } from 'next/server';
+
+import { signalWorkflow } from '@/route-handlers/signal-workflow/signal-workflow';
+import { type RequestParams } from '@/route-handlers/signal-workflow/signal-workflow.types';
+import { routeHandlerWithMiddlewares } from '@/utils/route-handlers-middleware';
+import routeHandlersDefaultMiddlewares from '@/utils/route-handlers-middleware/config/route-handlers-default-middlewares.config';
+
+export async function POST(
+  request: NextRequest,
+  options: { params: RequestParams['params'] }
+) {
+  return routeHandlerWithMiddlewares(
+    signalWorkflow,
+    request,
+    options,
+    routeHandlersDefaultMiddlewares
+  );
+} 
\ No newline at end of file
diff --git a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
new file mode 100644
index 000000000..90ebb8456
--- /dev/null
+++ b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
@@ -0,0 +1,127 @@
+import { NextRequest } from 'next/server';
+
+import { GRPCError } from '@/utils/grpc/grpc-error';
+import { mockGrpcClusterMethods } from '@/utils/route-handlers-middleware/middlewares/__mocks__/grpc-cluster-methods';
+
+import { signalWorkflow } from '../signal-workflow';
+import { type Context } from '../signal-workflow.types';
+import { SignalWorkflowSubmissionData } from '@/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types';
+
+const defaultRequestBody = {
+  signalName: 'test-signal',
+  signalInput: { data: 'test-input' },
+};
+
+describe(signalWorkflow.name, () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('calls signalWorkflow and returns valid response', async () => {
+    const { res, mockSignalWorkflow } = await setup({
+      requestBody: JSON.stringify({
+        signalName: 'custom-signal',
+        signalInput: 'custom-input',
+      }),
+    });
+
+    expect(mockSignalWorkflow).toHaveBeenCalledWith({
+      domain: 'mock-domain',
+      workflowExecution: {
+        workflowId: 'mock-wfid',
+        runId: 'mock-runid',
+      },
+      signalName: 'test-signal',
+      signalInput: { data: Buffer.from('test-input') },
+    });
+
+    const responseJson = await res.json();
+    expect(responseJson).toEqual({});
+  });
+
+  it('calls signalWorkflow without signalInput when not provided', async () => {
+    const { mockSignalWorkflow } = await setup({
+      requestBody: JSON.stringify({
+        signalName: 'signal-without-input',
+      }),
+    });
+
+    expect(mockSignalWorkflow).toHaveBeenCalledWith(
+      expect.objectContaining({
+        signalName: 'signal-without-input',
+        signalInput: undefined,
+      })
+    );
+  });
+
+  it('returns an error if something went wrong in the backend', async () => {
+    const { res, mockSignalWorkflow } = await setup({
+      error: true,
+    });
+
+    expect(mockSignalWorkflow).toHaveBeenCalled();
+
+    expect(res.status).toEqual(500);
+    const responseJson = await res.json();
+    expect(responseJson).toEqual(
+      expect.objectContaining({
+        message: 'Could not signal workflow',
+      })
+    );
+  });
+
+  it('returns an error if the signal input has an unexpected format', async () => {
+    const { res, mockSignalWorkflow } = await setup({
+      requestBody: JSON.stringify({
+        signalName: 'test-signal',
+        signalInput: 'not-an-object', // should be an object
+      } satisfies SignalWorkflowSubmissionData),
+    });
+
+    expect(mockSignalWorkflow).not.toHaveBeenCalled();
+
+    const responseJson = await res.json();
+    expect(responseJson).toEqual(
+      expect.objectContaining({
+        message: 'Invalid values provided for workflow signal',
+      })
+    );
+  });
+});
+
+async function setup({
+  requestBody = JSON.stringify(defaultRequestBody),
+  error,
+}: {
+  requestBody?: string;
+  error?: true;
+}) {
+  const mockSignalWorkflow = jest
+    .spyOn(mockGrpcClusterMethods, 'signalWorkflow')
+    .mockImplementationOnce(async () => {
+      if (error) {
+        throw new GRPCError('Could not signal workflow');
+      }
+      return {};
+    });
+
+  const res = await signalWorkflow(
+    new NextRequest('http://localhost', {
+      method: 'POST',
+      body: requestBody ?? '{}',
+    }),
+    {
+      params: {
+        domain: 'mock-domain',
+        cluster: 'mock-cluster',
+        workflowId: 'mock-wfid',
+        runId: 'mock-runid',
+      },
+    },
+    {
+      grpcClusterMethods: mockGrpcClusterMethods,
+    } as Context
+  );
+
+  return { res, mockSignalWorkflow };
+} 
\ No newline at end of file
diff --git a/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts b/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts
new file mode 100644
index 000000000..9c0629714
--- /dev/null
+++ b/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts
@@ -0,0 +1,15 @@
+import losslessJsonParse from "@/utils/lossless-json-parse";
+import { z } from "zod";
+
+const signalWorkflowInputSchema = z.string().superRefine((str, ctx) => {
+  if (!str) return undefined;
+
+  try {
+    return losslessJsonParse(str);
+  } catch {
+    ctx.addIssue({ code: 'custom', message: 'Invalid JSON' });
+    return z.NEVER;
+  }
+});
+
+export default signalWorkflowInputSchema;
diff --git a/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts b/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts
new file mode 100644
index 000000000..0f56f404b
--- /dev/null
+++ b/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import signalWorkflowInputSchema from './signal-workflow-input-schema';
+
+const signalWorkflowRequestBodySchema = z.object({
+  signalName: z.string().min(1),
+  signalInput: signalWorkflowInputSchema.optional(),
+});
+
+export default signalWorkflowRequestBodySchema; 
\ No newline at end of file
diff --git a/src/route-handlers/signal-workflow/signal-workflow.ts b/src/route-handlers/signal-workflow/signal-workflow.ts
new file mode 100644
index 000000000..664ad445b
--- /dev/null
+++ b/src/route-handlers/signal-workflow/signal-workflow.ts
@@ -0,0 +1,58 @@
+import { type NextRequest, NextResponse } from 'next/server';
+
+import decodeUrlParams from '@/utils/decode-url-params';
+import { getHTTPStatusCode, GRPCError } from '@/utils/grpc/grpc-error';
+import logger, { type RouteHandlerErrorPayload } from '@/utils/logger';
+
+import { type Context, type RequestParams } from './signal-workflow.types';
+import signalWorkflowRequestBodySchema from './schemas/signal-workflow-request-body-schema';
+
+export async function signalWorkflow(
+  request: NextRequest,
+  requestParams: RequestParams,
+  ctx: Context
+) {
+  const requestBody = await request.json();
+  const { data, error } = signalWorkflowRequestBodySchema.safeParse(requestBody);
+
+  if (error) {
+    return NextResponse.json(
+      {
+        message: 'Invalid values provided for workflow signal',
+        validationErrors: error.errors,
+      },
+      { status: 400 }
+    );
+  }
+
+  const decodedParams = decodeUrlParams(requestParams.params);
+
+  try {
+    const response = await ctx.grpcClusterMethods.signalWorkflow({
+      domain: decodedParams.domain,
+      workflowExecution: {
+        workflowId: decodedParams.workflowId,
+        runId: decodedParams.runId,
+      },
+      signalName: data.signalName,
+      signalInput: data.signalInput ? { data: Buffer.from(data.signalInput) } : undefined,
+      // TODO: add user identity
+    });
+
+    return NextResponse.json(response);
+  } catch (e) {
+    logger.error<RouteHandlerErrorPayload>(
+      { requestParams: decodedParams, error: e },
+      'Error signaling workflow'
+    );
+
+    return NextResponse.json(
+      {
+        message:
+          e instanceof GRPCError ? e.message : 'Error signaling workflow',
+        cause: e,
+      },
+      { status: getHTTPStatusCode(e) }
+    );
+  }
+} 
\ No newline at end of file
diff --git a/src/route-handlers/signal-workflow/signal-workflow.types.ts b/src/route-handlers/signal-workflow/signal-workflow.types.ts
new file mode 100644
index 000000000..51e58e258
--- /dev/null
+++ b/src/route-handlers/signal-workflow/signal-workflow.types.ts
@@ -0,0 +1,14 @@
+import { type GRPCClusterMethods } from '@/utils/grpc/grpc-client';
+
+export type RequestParams = {
+  params: {
+    domain: string;
+    cluster: string;
+    workflowId: string;
+    runId: string;
+  };
+};
+
+export type Context = {
+  grpcClusterMethods: GRPCClusterMethods;
+}; 
\ No newline at end of file

From 509ae9d28b528540b69d058850e7019678a3595e Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 13:18:42 +0000
Subject: [PATCH 02/17] fix node test

---
 .../signal-workflow/__tests__/signal-workflow.node.ts | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
index 90ebb8456..d44df94cf 100644
--- a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
+++ b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
@@ -9,8 +9,8 @@ import { SignalWorkflowSubmissionData } from '@/views/workflow-actions/workflow-
 
 const defaultRequestBody = {
   signalName: 'test-signal',
-  signalInput: { data: 'test-input' },
-};
+  signalInput: 'test-input' ,
+} satisfies SignalWorkflowSubmissionData;
 
 describe(signalWorkflow.name, () => {
   beforeEach(() => {
@@ -18,12 +18,7 @@ describe(signalWorkflow.name, () => {
   });
 
   it('calls signalWorkflow and returns valid response', async () => {
-    const { res, mockSignalWorkflow } = await setup({
-      requestBody: JSON.stringify({
-        signalName: 'custom-signal',
-        signalInput: 'custom-input',
-      }),
-    });
+    const { res, mockSignalWorkflow } = await setup({});
 
     expect(mockSignalWorkflow).toHaveBeenCalledWith({
       domain: 'mock-domain',

From 06edf6c7d26b7632673bdaccf47eda371ab93ecf Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 13:24:13 +0000
Subject: [PATCH 03/17] fix lint

---
 .../signal-workflow/__tests__/signal-workflow.node.ts |  6 +++---
 .../schemas/signal-workflow-input-schema.ts           |  5 +++--
 .../schemas/signal-workflow-request-body-schema.ts    |  3 ++-
 src/route-handlers/signal-workflow/signal-workflow.ts | 11 +++++++----
 .../signal-workflow/signal-workflow.types.ts          |  2 +-
 5 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
index d44df94cf..8fb3d6bdc 100644
--- a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
+++ b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
@@ -2,14 +2,14 @@ import { NextRequest } from 'next/server';
 
 import { GRPCError } from '@/utils/grpc/grpc-error';
 import { mockGrpcClusterMethods } from '@/utils/route-handlers-middleware/middlewares/__mocks__/grpc-cluster-methods';
+import { type SignalWorkflowSubmissionData } from '@/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types';
 
 import { signalWorkflow } from '../signal-workflow';
 import { type Context } from '../signal-workflow.types';
-import { SignalWorkflowSubmissionData } from '@/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types';
 
 const defaultRequestBody = {
   signalName: 'test-signal',
-  signalInput: 'test-input' ,
+  signalInput: 'test-input',
 } satisfies SignalWorkflowSubmissionData;
 
 describe(signalWorkflow.name, () => {
@@ -119,4 +119,4 @@ async function setup({
   );
 
   return { res, mockSignalWorkflow };
-} 
\ No newline at end of file
+}
diff --git a/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts b/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts
index 9c0629714..dd7b5bdce 100644
--- a/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts
+++ b/src/route-handlers/signal-workflow/schemas/signal-workflow-input-schema.ts
@@ -1,5 +1,6 @@
-import losslessJsonParse from "@/utils/lossless-json-parse";
-import { z } from "zod";
+import { z } from 'zod';
+
+import losslessJsonParse from '@/utils/lossless-json-parse';
 
 const signalWorkflowInputSchema = z.string().superRefine((str, ctx) => {
   if (!str) return undefined;
diff --git a/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts b/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts
index 0f56f404b..35618dc93 100644
--- a/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts
+++ b/src/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema.ts
@@ -1,4 +1,5 @@
 import { z } from 'zod';
+
 import signalWorkflowInputSchema from './signal-workflow-input-schema';
 
 const signalWorkflowRequestBodySchema = z.object({
@@ -6,4 +7,4 @@ const signalWorkflowRequestBodySchema = z.object({
   signalInput: signalWorkflowInputSchema.optional(),
 });
 
-export default signalWorkflowRequestBodySchema; 
\ No newline at end of file
+export default signalWorkflowRequestBodySchema;
diff --git a/src/route-handlers/signal-workflow/signal-workflow.ts b/src/route-handlers/signal-workflow/signal-workflow.ts
index 664ad445b..68e1d172e 100644
--- a/src/route-handlers/signal-workflow/signal-workflow.ts
+++ b/src/route-handlers/signal-workflow/signal-workflow.ts
@@ -4,8 +4,8 @@ import decodeUrlParams from '@/utils/decode-url-params';
 import { getHTTPStatusCode, GRPCError } from '@/utils/grpc/grpc-error';
 import logger, { type RouteHandlerErrorPayload } from '@/utils/logger';
 
-import { type Context, type RequestParams } from './signal-workflow.types';
 import signalWorkflowRequestBodySchema from './schemas/signal-workflow-request-body-schema';
+import { type Context, type RequestParams } from './signal-workflow.types';
 
 export async function signalWorkflow(
   request: NextRequest,
@@ -13,7 +13,8 @@ export async function signalWorkflow(
   ctx: Context
 ) {
   const requestBody = await request.json();
-  const { data, error } = signalWorkflowRequestBodySchema.safeParse(requestBody);
+  const { data, error } =
+    signalWorkflowRequestBodySchema.safeParse(requestBody);
 
   if (error) {
     return NextResponse.json(
@@ -35,7 +36,9 @@ export async function signalWorkflow(
         runId: decodedParams.runId,
       },
       signalName: data.signalName,
-      signalInput: data.signalInput ? { data: Buffer.from(data.signalInput) } : undefined,
+      signalInput: data.signalInput
+        ? { data: Buffer.from(data.signalInput) }
+        : undefined,
       // TODO: add user identity
     });
 
@@ -55,4 +58,4 @@ export async function signalWorkflow(
       { status: getHTTPStatusCode(e) }
     );
   }
-} 
\ No newline at end of file
+}
diff --git a/src/route-handlers/signal-workflow/signal-workflow.types.ts b/src/route-handlers/signal-workflow/signal-workflow.types.ts
index 51e58e258..9b2ed29b6 100644
--- a/src/route-handlers/signal-workflow/signal-workflow.types.ts
+++ b/src/route-handlers/signal-workflow/signal-workflow.types.ts
@@ -11,4 +11,4 @@ export type RequestParams = {
 
 export type Context = {
   grpcClusterMethods: GRPCClusterMethods;
-}; 
\ No newline at end of file
+};

From ceec9e6c4fe5344cb118bd7171e6bec2e2d8dcf0 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 14:01:42 +0000
Subject: [PATCH 04/17] add new line

---
 .../workflows/[workflowId]/[runId]/(actions)/signal/route.ts    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts b/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts
index 4fe2d1f5c..4c6ae710e 100644
--- a/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts
+++ b/src/app/api/domains/[domain]/[cluster]/workflows/[workflowId]/[runId]/(actions)/signal/route.ts
@@ -15,4 +15,4 @@ export async function POST(
     options,
     routeHandlersDefaultMiddlewares
   );
-} 
\ No newline at end of file
+}

From b08d6b0038a556aafe9f4abed490e6013ccd3f13 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 14:07:28 +0000
Subject: [PATCH 05/17] add type for SignalWorkflowRequestBody

---
 .../signal-workflow/__tests__/signal-workflow.node.ts     | 8 +++++---
 .../signal-workflow/signal-workflow.types.ts              | 8 ++++++++
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
index 8fb3d6bdc..4377d63c7 100644
--- a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
+++ b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
@@ -2,15 +2,17 @@ import { NextRequest } from 'next/server';
 
 import { GRPCError } from '@/utils/grpc/grpc-error';
 import { mockGrpcClusterMethods } from '@/utils/route-handlers-middleware/middlewares/__mocks__/grpc-cluster-methods';
-import { type SignalWorkflowSubmissionData } from '@/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types';
 
 import { signalWorkflow } from '../signal-workflow';
-import { type Context } from '../signal-workflow.types';
+import {
+  type SignalWorkflowRequestBody,
+  type Context,
+} from '../signal-workflow.types';
 
 const defaultRequestBody = {
   signalName: 'test-signal',
   signalInput: 'test-input',
-} satisfies SignalWorkflowSubmissionData;
+} satisfies SignalWorkflowRequestBody;
 
 describe(signalWorkflow.name, () => {
   beforeEach(() => {
diff --git a/src/route-handlers/signal-workflow/signal-workflow.types.ts b/src/route-handlers/signal-workflow/signal-workflow.types.ts
index 9b2ed29b6..487bb5b30 100644
--- a/src/route-handlers/signal-workflow/signal-workflow.types.ts
+++ b/src/route-handlers/signal-workflow/signal-workflow.types.ts
@@ -1,5 +1,9 @@
+import { type z } from 'zod';
+
 import { type GRPCClusterMethods } from '@/utils/grpc/grpc-client';
 
+import type signalWorkflowRequestBodySchema from './schemas/signal-workflow-request-body-schema';
+
 export type RequestParams = {
   params: {
     domain: string;
@@ -9,6 +13,10 @@ export type RequestParams = {
   };
 };
 
+export type SignalWorkflowRequestBody = z.infer<
+  typeof signalWorkflowRequestBodySchema
+>;
+
 export type Context = {
   grpcClusterMethods: GRPCClusterMethods;
 };

From 12ec77a42ac242e272a2ddc305a8c41409fc6696 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 14:14:17 +0000
Subject: [PATCH 06/17] fix typecheck

---
 .../signal-workflow/__tests__/signal-workflow.node.ts           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
index 4377d63c7..564fb9a1b 100644
--- a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
+++ b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
@@ -72,7 +72,7 @@ describe(signalWorkflow.name, () => {
       requestBody: JSON.stringify({
         signalName: 'test-signal',
         signalInput: 'not-an-object', // should be an object
-      } satisfies SignalWorkflowSubmissionData),
+      } satisfies SignalWorkflowRequestBody),
     });
 
     expect(mockSignalWorkflow).not.toHaveBeenCalled();

From 9f6b690ac0d170aae2412d4bb6e0e06d0f616336 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 14:45:52 +0000
Subject: [PATCH 07/17] fix test cases

---
 .../signal-workflow/__tests__/signal-workflow.node.ts         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
index 564fb9a1b..cc0d1df93 100644
--- a/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
+++ b/src/route-handlers/signal-workflow/__tests__/signal-workflow.node.ts
@@ -11,7 +11,7 @@ import {
 
 const defaultRequestBody = {
   signalName: 'test-signal',
-  signalInput: 'test-input',
+  signalInput: '"test-input"',
 } satisfies SignalWorkflowRequestBody;
 
 describe(signalWorkflow.name, () => {
@@ -29,7 +29,7 @@ describe(signalWorkflow.name, () => {
         runId: 'mock-runid',
       },
       signalName: 'test-signal',
-      signalInput: { data: Buffer.from('test-input') },
+      signalInput: { data: Buffer.from('"test-input"') },
     });
 
     const responseJson = await res.json();

From 8dba2478450d71c74788721b8ac1e0c5b3556d9b Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 15:53:49 +0000
Subject: [PATCH 08/17] Signal workflow form

---
 ...kflow-action-new-run-success-msg.types.tsx |   1 -
 .../workflow-action-signal-form.test.tsx      | 111 ++++++++++++++++++
 .../schemas/signal-workflow-form-schema.ts    |   8 ++
 .../workflow-action-signal-form.tsx           |  66 +++++++++++
 .../workflow-action-signal-form.types.ts      |  15 +++
 5 files changed, 200 insertions(+), 1 deletion(-)
 create mode 100644 src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
 create mode 100644 src/views/workflow-actions/workflow-action-signal-form/schemas/signal-workflow-form-schema.ts
 create mode 100644 src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
 create mode 100644 src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types.ts

diff --git a/src/views/workflow-actions/workflow-action-new-run-success-msg/workflow-action-new-run-success-msg.types.tsx b/src/views/workflow-actions/workflow-action-new-run-success-msg/workflow-action-new-run-success-msg.types.tsx
index d11dcd289..b8f034647 100644
--- a/src/views/workflow-actions/workflow-action-new-run-success-msg/workflow-action-new-run-success-msg.types.tsx
+++ b/src/views/workflow-actions/workflow-action-new-run-success-msg/workflow-action-new-run-success-msg.types.tsx
@@ -5,5 +5,4 @@ export type Props = WorkflowActionSuccessMessageProps<
   { runId: string }
 > & {
   successMessage: string;
-  onDismissMessage: () => void;
 };
diff --git a/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx b/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
new file mode 100644
index 000000000..64da8767f
--- /dev/null
+++ b/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
@@ -0,0 +1,111 @@
+import React from 'react';
+
+import { type FieldErrors, useForm } from 'react-hook-form';
+
+import { render, screen, fireEvent } from '@/test-utils/rtl';
+
+import WorkflowActionSignalForm from '../workflow-action-signal-form';
+import { type SignalWorkflowFormData } from '../workflow-action-signal-form.types';
+
+describe('WorkflowActionSignalForm', () => {
+  it('renders all form fields correctly', async () => {
+    await setup({});
+
+    expect(
+      screen.getByPlaceholderText('Enter signal name')
+    ).toBeInTheDocument();
+    expect(
+      screen.getByPlaceholderText('Enter valid JSON input')
+    ).toBeInTheDocument();
+  });
+
+  it('displays error when form has errors', async () => {
+    const formErrors = {
+      signalName: {
+        message: 'Signal name is required',
+        type: 'required',
+      },
+      signalInput: {
+        message: 'Invalid JSON format',
+        type: 'invalid',
+      },
+    };
+
+    await setup({ formErrors });
+
+    const signalNameInput = screen.getByPlaceholderText('Enter signal name');
+    expect(signalNameInput).toHaveAttribute('aria-invalid', 'true');
+
+    const signalInputTextarea = screen.getByPlaceholderText(
+      'Enter valid JSON input'
+    );
+    expect(signalInputTextarea).toHaveAttribute('aria-invalid', 'true');
+  });
+
+  it('handles input changes correctly', async () => {
+    await setup({});
+
+    const signalNameInput = screen.getByPlaceholderText('Enter signal name');
+    fireEvent.change(signalNameInput, { target: { value: 'test-signal' } });
+    expect(signalNameInput).toHaveValue('test-signal');
+
+    const signalInputTextarea = screen.getByPlaceholderText(
+      'Enter valid JSON input'
+    );
+    fireEvent.change(signalInputTextarea, {
+      target: { value: '{"key": "value"}' },
+    });
+    expect(signalInputTextarea).toHaveValue('{"key": "value"}');
+  });
+
+  it('renders with default values', async () => {
+    await setup({
+      formData: {
+        signalName: 'test-signal',
+        signalInput: '{"key": "value"}',
+      },
+    });
+
+    const signalNameInput = screen.getByPlaceholderText('Enter signal name');
+    expect(signalNameInput).toHaveValue('test-signal');
+
+    const signalInputTextarea = screen.getByPlaceholderText(
+      'Enter valid JSON input'
+    );
+    expect(signalInputTextarea).toHaveValue('{"key": "value"}');
+  });
+});
+
+type TestProps = {
+  formErrors: FieldErrors<SignalWorkflowFormData>;
+  formData: SignalWorkflowFormData;
+};
+
+function TestWrapper({ formErrors, formData }: TestProps) {
+  const methods = useForm<SignalWorkflowFormData>({
+    defaultValues: formData,
+  });
+
+  return (
+    <WorkflowActionSignalForm
+      control={methods.control}
+      clearErrors={methods.clearErrors}
+      fieldErrors={formErrors}
+      formData={formData}
+      cluster="test-cluster"
+      domain="test-domain"
+      workflowId="test-workflow-id"
+      runId="test-run-id"
+    />
+  );
+}
+
+async function setup({
+  formErrors = {},
+  formData = {
+    signalName: '',
+    signalInput: '',
+  },
+}: Partial<TestProps>) {
+  render(<TestWrapper formErrors={formErrors} formData={formData} />);
+}
diff --git a/src/views/workflow-actions/workflow-action-signal-form/schemas/signal-workflow-form-schema.ts b/src/views/workflow-actions/workflow-action-signal-form/schemas/signal-workflow-form-schema.ts
new file mode 100644
index 000000000..8d5c7afbf
--- /dev/null
+++ b/src/views/workflow-actions/workflow-action-signal-form/schemas/signal-workflow-form-schema.ts
@@ -0,0 +1,8 @@
+import { z } from 'zod';
+
+import signalWorkflowInputSchema from '@/route-handlers/signal-workflow/schemas/signal-workflow-input-schema';
+
+export const signalWorkflowFormSchema = z.object({
+  signalName: z.string().min(1),
+  signalInput: signalWorkflowInputSchema.optional(),
+});
diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
new file mode 100644
index 000000000..c8b2b5b73
--- /dev/null
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
@@ -0,0 +1,66 @@
+import { FormControl } from 'baseui/form-control';
+import { Input } from 'baseui/input';
+import { Textarea } from 'baseui/textarea';
+import { Controller } from 'react-hook-form';
+
+import { type WorkflowActionFormProps } from '../workflow-actions.types';
+
+import { type SignalWorkflowFormData } from './workflow-action-signal-form.types';
+
+export default function WorkflowActionSignalForm({
+  fieldErrors,
+  control,
+  formData,
+}: WorkflowActionFormProps<SignalWorkflowFormData>) {
+  const getErrorMessage = (field: string) => {
+    return field in fieldErrors
+      ? fieldErrors[field as keyof typeof fieldErrors]?.message
+      : undefined;
+  };
+
+  return (
+    <div>
+      <FormControl label="Signal Name">
+        <Controller
+          name="signalName"
+          control={control}
+          defaultValue=""
+          render={({ field: { ref, ...field } }) => (
+            <Input
+              {...field}
+              // @ts-expect-error - inputRef expects ref object while ref is a callback. It should support both.
+              inputRef={ref}
+              onChange={(e) => {
+                field.onChange(e.target.value);
+              }}
+              onBlur={field.onBlur}
+              error={Boolean(getErrorMessage('signalName'))}
+              placeholder="Enter signal name"
+            />
+          )}
+        />
+      </FormControl>
+
+      <FormControl label="JSON Input (optional)">
+        <Controller
+          name="signalInput"
+          control={control}
+          defaultValue=""
+          render={({ field: { ref, ...field } }) => (
+            <Textarea
+              {...field}
+              // @ts-expect-error - inputRef expects ref object while ref is a callback. It should support both.
+              inputRef={ref}
+              onChange={(e) => {
+                field.onChange(e.target.value);
+              }}
+              onBlur={field.onBlur}
+              error={Boolean(getErrorMessage('signalInput'))}
+              placeholder="Enter valid JSON input"
+            />
+          )}
+        />
+      </FormControl>
+    </div>
+  );
+}
diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types.ts b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types.ts
new file mode 100644
index 000000000..f8da1f90f
--- /dev/null
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.types.ts
@@ -0,0 +1,15 @@
+import { type z } from 'zod';
+
+import type signalWorkflowRequestBodySchema from '@/route-handlers/signal-workflow/schemas/signal-workflow-request-body-schema';
+
+import { type WorkflowActionFormProps } from '../workflow-actions.types';
+
+import { type signalWorkflowFormSchema } from './schemas/signal-workflow-form-schema';
+
+export type SignalWorkflowFormData = z.infer<typeof signalWorkflowFormSchema>;
+
+export type Props = WorkflowActionFormProps<SignalWorkflowFormData>;
+
+export type SignalWorkflowSubmissionData = z.infer<
+  typeof signalWorkflowRequestBodySchema
+>;

From 1efc8dcb921ce73267a02c459f85652d7edbb6f0 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 15:54:36 +0000
Subject: [PATCH 09/17] remove unused value

---
 .../workflow-action-signal-form/workflow-action-signal-form.tsx  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
index c8b2b5b73..b9f819b53 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
@@ -10,7 +10,6 @@ import { type SignalWorkflowFormData } from './workflow-action-signal-form.types
 export default function WorkflowActionSignalForm({
   fieldErrors,
   control,
-  formData,
 }: WorkflowActionFormProps<SignalWorkflowFormData>) {
   const getErrorMessage = (field: string) => {
     return field in fieldErrors

From 3f0a2bfd3717ef514e806ebbdf4070ba3223e04a Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 15:57:05 +0000
Subject: [PATCH 10/17] update JSON field placeholder message

---
 .../workflow-action-signal-form/workflow-action-signal-form.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
index b9f819b53..540e65357 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
@@ -55,7 +55,7 @@ export default function WorkflowActionSignalForm({
               }}
               onBlur={field.onBlur}
               error={Boolean(getErrorMessage('signalInput'))}
-              placeholder="Enter valid JSON input"
+              placeholder="Enter JSON input"
             />
           )}
         />

From 7e9c8fc90db54dcd0238a5b228cca63fd9f596d8 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 16:02:23 +0000
Subject: [PATCH 11/17] Add signal workflow to workflow actions

---
 .../resolvers/schemas/resolver-schemas.ts     |  1 +
 .../resolvers/workflow-actions-enabled.ts     |  1 +
 .../workflow-actions-enabled.types.ts         |  7 +++-
 .../__fixtures__/resolved-config-values.ts    |  1 +
 .../config/workflow-actions.config.ts         | 39 +++++++++++++++++++
 .../__tests__/workflow-actions-menu.test.tsx  |  1 +
 6 files changed, 49 insertions(+), 1 deletion(-)

diff --git a/src/config/dynamic/resolvers/schemas/resolver-schemas.ts b/src/config/dynamic/resolvers/schemas/resolver-schemas.ts
index 0245c76ad..136acd3da 100644
--- a/src/config/dynamic/resolvers/schemas/resolver-schemas.ts
+++ b/src/config/dynamic/resolvers/schemas/resolver-schemas.ts
@@ -38,6 +38,7 @@ const resolverSchemas: ResolverSchemas = {
     returnType: z.object({
       cancel: workflowActionsEnabledValueSchema,
       terminate: workflowActionsEnabledValueSchema,
+      signal: workflowActionsEnabledValueSchema,
       restart: workflowActionsEnabledValueSchema,
       reset: workflowActionsEnabledValueSchema,
     }),
diff --git a/src/config/dynamic/resolvers/workflow-actions-enabled.ts b/src/config/dynamic/resolvers/workflow-actions-enabled.ts
index c2d62485a..1bc58cc19 100644
--- a/src/config/dynamic/resolvers/workflow-actions-enabled.ts
+++ b/src/config/dynamic/resolvers/workflow-actions-enabled.ts
@@ -15,5 +15,6 @@ export default async function workflowActionsEnabled(
     cancel: 'ENABLED',
     restart: 'ENABLED',
     reset: 'ENABLED',
+    signal: 'ENABLED',
   };
 }
diff --git a/src/config/dynamic/resolvers/workflow-actions-enabled.types.ts b/src/config/dynamic/resolvers/workflow-actions-enabled.types.ts
index c3290ae5b..da3ae646a 100644
--- a/src/config/dynamic/resolvers/workflow-actions-enabled.types.ts
+++ b/src/config/dynamic/resolvers/workflow-actions-enabled.types.ts
@@ -1,6 +1,11 @@
 import type WORKFLOW_ACTIONS_DISABLED_VALUES_CONFIG from './workflow-actions-disabled-values.config';
 
-export type WorkflowActionID = 'cancel' | 'terminate' | 'restart' | 'reset';
+export type WorkflowActionID =
+  | 'cancel'
+  | 'terminate'
+  | 'restart'
+  | 'reset'
+  | 'signal';
 
 export type WorkflowActionsEnabledResolverParams = {
   domain: string;
diff --git a/src/utils/config/__fixtures__/resolved-config-values.ts b/src/utils/config/__fixtures__/resolved-config-values.ts
index 0cdd18ea7..537b48436 100644
--- a/src/utils/config/__fixtures__/resolved-config-values.ts
+++ b/src/utils/config/__fixtures__/resolved-config-values.ts
@@ -30,6 +30,7 @@ const mockResolvedConfigValues: LoadedConfigResolvedValues = {
   WORKFLOW_ACTIONS_ENABLED: {
     terminate: 'ENABLED',
     cancel: 'ENABLED',
+    signal: 'ENABLED',
     restart: 'ENABLED',
     reset: 'ENABLED',
   },
diff --git a/src/views/workflow-actions/config/workflow-actions.config.ts b/src/views/workflow-actions/config/workflow-actions.config.ts
index 294202785..8a331201c 100644
--- a/src/views/workflow-actions/config/workflow-actions.config.ts
+++ b/src/views/workflow-actions/config/workflow-actions.config.ts
@@ -5,6 +5,7 @@ import {
   MdPowerSettingsNew,
   MdOutlineRestartAlt,
   MdRefresh,
+  MdOutlineWifiTethering,
 } from 'react-icons/md';
 
 import { type CancelWorkflowResponse } from '@/route-handlers/cancel-workflow/cancel-workflow.types';
@@ -20,6 +21,12 @@ import {
   type ResetWorkflowSubmissionData,
   type ResetWorkflowFormData,
 } from '../workflow-action-reset-form/workflow-action-reset-form.types';
+import { signalWorkflowFormSchema } from '../workflow-action-signal-form/schemas/signal-workflow-form-schema';
+import WorkflowActionSignalForm from '../workflow-action-signal-form/workflow-action-signal-form';
+import {
+  type SignalWorkflowSubmissionData,
+  type SignalWorkflowFormData,
+} from '../workflow-action-signal-form/workflow-action-signal-form.types';
 import { type WorkflowAction } from '../workflow-actions.types';
 
 const cancelWorkflowActionConfig: WorkflowAction<CancelWorkflowResponse> = {
@@ -69,6 +76,37 @@ const terminateWorkflowActionConfig: WorkflowAction<TerminateWorkflowResponse> =
     renderSuccessMessage: () => 'Workflow has been terminated.',
   };
 
+const signalWorkflowActionConfig: WorkflowAction<
+  unknown,
+  SignalWorkflowFormData,
+  SignalWorkflowSubmissionData
+> = {
+  id: 'signal',
+  label: 'Signal',
+  subtitle: 'Send a signal to the workflow',
+  modal: {
+    text: 'Provide data to running workflows using signals',
+    docsLink: {
+      text: 'Learn more about signals',
+      href: 'https://cadenceworkflow.io/docs/go-client/signals',
+    },
+    withForm: true,
+    form: WorkflowActionSignalForm,
+    formSchema: signalWorkflowFormSchema,
+    transformFormDataToSubmission: (formData) => formData,
+  },
+  icon: MdOutlineWifiTethering,
+  getRunnableStatus: (workflow) =>
+    getWorkflowIsCompleted(
+      workflow.workflowExecutionInfo?.closeEvent?.attributes ?? ''
+    )
+      ? 'NOT_RUNNABLE_WORKFLOW_CLOSED'
+      : 'RUNNABLE',
+  apiRoute: 'signal',
+  renderSuccessMessage: ({ inputParams }) =>
+    `Successfully sent signal "${inputParams.submissionData.signalName}"`,
+};
+
 const restartWorkflowActionConfig: WorkflowAction<RestartWorkflowResponse> = {
   id: 'restart',
   label: 'Restart',
@@ -136,6 +174,7 @@ export const resetWorkflowActionConfig: WorkflowAction<
 const workflowActionsConfig = [
   cancelWorkflowActionConfig,
   terminateWorkflowActionConfig,
+  signalWorkflowActionConfig,
   restartWorkflowActionConfig,
   resetWorkflowActionConfig,
 ] as const satisfies WorkflowAction<any, any, any>[];
diff --git a/src/views/workflow-actions/workflow-actions-menu/__tests__/workflow-actions-menu.test.tsx b/src/views/workflow-actions/workflow-actions-menu/__tests__/workflow-actions-menu.test.tsx
index d832d0bd8..edf836b77 100644
--- a/src/views/workflow-actions/workflow-actions-menu/__tests__/workflow-actions-menu.test.tsx
+++ b/src/views/workflow-actions/workflow-actions-menu/__tests__/workflow-actions-menu.test.tsx
@@ -63,6 +63,7 @@ describe(WorkflowActionsMenu.name, () => {
       actionsEnabledConfig: {
         cancel: 'DISABLED_DEFAULT',
         terminate: 'DISABLED_DEFAULT',
+        signal: 'DISABLED_DEFAULT',
         restart: 'ENABLED',
         reset: 'ENABLED',
       },

From b0264f035855f0e7520850a386d9d52a0b438c4a Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 16:19:46 +0000
Subject: [PATCH 12/17] fix test case

---
 .../__tests__/workflow-action-signal-form.test.tsx        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx b/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
index 64da8767f..a6a6c757e 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
@@ -15,7 +15,7 @@ describe('WorkflowActionSignalForm', () => {
       screen.getByPlaceholderText('Enter signal name')
     ).toBeInTheDocument();
     expect(
-      screen.getByPlaceholderText('Enter valid JSON input')
+      screen.getByPlaceholderText('Enter JSON input')
     ).toBeInTheDocument();
   });
 
@@ -37,7 +37,7 @@ describe('WorkflowActionSignalForm', () => {
     expect(signalNameInput).toHaveAttribute('aria-invalid', 'true');
 
     const signalInputTextarea = screen.getByPlaceholderText(
-      'Enter valid JSON input'
+      'Enter JSON input'
     );
     expect(signalInputTextarea).toHaveAttribute('aria-invalid', 'true');
   });
@@ -50,7 +50,7 @@ describe('WorkflowActionSignalForm', () => {
     expect(signalNameInput).toHaveValue('test-signal');
 
     const signalInputTextarea = screen.getByPlaceholderText(
-      'Enter valid JSON input'
+      'Enter JSON input'
     );
     fireEvent.change(signalInputTextarea, {
       target: { value: '{"key": "value"}' },
@@ -70,7 +70,7 @@ describe('WorkflowActionSignalForm', () => {
     expect(signalNameInput).toHaveValue('test-signal');
 
     const signalInputTextarea = screen.getByPlaceholderText(
-      'Enter valid JSON input'
+      'Enter JSON input'
     );
     expect(signalInputTextarea).toHaveValue('{"key": "value"}');
   });

From 116ed3c065a42e64927051b61387a6463ed31b8d Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Wed, 14 May 2025 16:23:17 +0000
Subject: [PATCH 13/17] fix lint

---
 .../workflow-action-signal-form.test.tsx         | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx b/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
index a6a6c757e..fe7bef9ef 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/__tests__/workflow-action-signal-form.test.tsx
@@ -14,9 +14,7 @@ describe('WorkflowActionSignalForm', () => {
     expect(
       screen.getByPlaceholderText('Enter signal name')
     ).toBeInTheDocument();
-    expect(
-      screen.getByPlaceholderText('Enter JSON input')
-    ).toBeInTheDocument();
+    expect(screen.getByPlaceholderText('Enter JSON input')).toBeInTheDocument();
   });
 
   it('displays error when form has errors', async () => {
@@ -36,9 +34,7 @@ describe('WorkflowActionSignalForm', () => {
     const signalNameInput = screen.getByPlaceholderText('Enter signal name');
     expect(signalNameInput).toHaveAttribute('aria-invalid', 'true');
 
-    const signalInputTextarea = screen.getByPlaceholderText(
-      'Enter JSON input'
-    );
+    const signalInputTextarea = screen.getByPlaceholderText('Enter JSON input');
     expect(signalInputTextarea).toHaveAttribute('aria-invalid', 'true');
   });
 
@@ -49,9 +45,7 @@ describe('WorkflowActionSignalForm', () => {
     fireEvent.change(signalNameInput, { target: { value: 'test-signal' } });
     expect(signalNameInput).toHaveValue('test-signal');
 
-    const signalInputTextarea = screen.getByPlaceholderText(
-      'Enter JSON input'
-    );
+    const signalInputTextarea = screen.getByPlaceholderText('Enter JSON input');
     fireEvent.change(signalInputTextarea, {
       target: { value: '{"key": "value"}' },
     });
@@ -69,9 +63,7 @@ describe('WorkflowActionSignalForm', () => {
     const signalNameInput = screen.getByPlaceholderText('Enter signal name');
     expect(signalNameInput).toHaveValue('test-signal');
 
-    const signalInputTextarea = screen.getByPlaceholderText(
-      'Enter JSON input'
-    );
+    const signalInputTextarea = screen.getByPlaceholderText('Enter JSON input');
     expect(signalInputTextarea).toHaveValue('{"key": "value"}');
   });
 });

From 92bc896ec4f45f4ee423af6effa2f6fc78049cfe Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Fri, 16 May 2025 07:44:29 +0000
Subject: [PATCH 14/17] update json input styles to monospace

---
 .../workflow-action-signal-form.styles.ts           | 13 +++++++++++++
 .../workflow-action-signal-form.tsx                 |  3 ++-
 2 files changed, 15 insertions(+), 1 deletion(-)
 create mode 100644 src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts

diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts
new file mode 100644
index 000000000..35f23ec39
--- /dev/null
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts
@@ -0,0 +1,13 @@
+import { type Theme } from 'baseui';
+import { type TextareaOverrides } from 'baseui/textarea';
+import { type StyleObject } from 'styletron-react';
+
+export const overrides = {
+  jsonInput: {
+    Input: {
+      style: ({ $theme }: { $theme: Theme }): StyleObject => ({
+        ...$theme.typography.MonoParagraphXSmall,
+      }),
+    },
+  } satisfies TextareaOverrides,
+};
diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
index 540e65357..77f286cdf 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
@@ -6,6 +6,7 @@ import { Controller } from 'react-hook-form';
 import { type WorkflowActionFormProps } from '../workflow-actions.types';
 
 import { type SignalWorkflowFormData } from './workflow-action-signal-form.types';
+import { overrides } from './workflow-action-signal-form.styles';
 
 export default function WorkflowActionSignalForm({
   fieldErrors,
@@ -39,7 +40,6 @@ export default function WorkflowActionSignalForm({
           )}
         />
       </FormControl>
-
       <FormControl label="JSON Input (optional)">
         <Controller
           name="signalInput"
@@ -48,6 +48,7 @@ export default function WorkflowActionSignalForm({
           render={({ field: { ref, ...field } }) => (
             <Textarea
               {...field}
+              overrides={overrides.jsonInput}
               // @ts-expect-error - inputRef expects ref object while ref is a callback. It should support both.
               inputRef={ref}
               onChange={(e) => {

From 62ae97007a2f8b0ae3a9edb7cb94ebba4ce0ee59 Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Fri, 16 May 2025 07:58:57 +0000
Subject: [PATCH 15/17] add styles for placeholder

---
 .../workflow-action-signal-form.styles.ts                    | 5 ++++-
 .../workflow-action-signal-form.tsx                          | 2 ++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts
index 35f23ec39..7a2678e77 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.styles.ts
@@ -6,7 +6,10 @@ export const overrides = {
   jsonInput: {
     Input: {
       style: ({ $theme }: { $theme: Theme }): StyleObject => ({
-        ...$theme.typography.MonoParagraphXSmall,
+        ...$theme.typography.MonoParagraphSmall,
+        '::placeholder': {
+          ...$theme.typography.ParagraphSmall,
+        },
       }),
     },
   } satisfies TextareaOverrides,
diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
index 77f286cdf..2ea693895 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
@@ -33,6 +33,7 @@ export default function WorkflowActionSignalForm({
               onChange={(e) => {
                 field.onChange(e.target.value);
               }}
+              size='compact'
               onBlur={field.onBlur}
               error={Boolean(getErrorMessage('signalName'))}
               placeholder="Enter signal name"
@@ -54,6 +55,7 @@ export default function WorkflowActionSignalForm({
               onChange={(e) => {
                 field.onChange(e.target.value);
               }}
+              size='compact'
               onBlur={field.onBlur}
               error={Boolean(getErrorMessage('signalInput'))}
               placeholder="Enter JSON input"

From 66eaba394d5d9eed700d55373bed5c434072b2b4 Mon Sep 17 00:00:00 2001
From: Adhitya Mamallan <adhitya.mamallan@uber.com>
Date: Thu, 15 May 2025 14:19:01 +0200
Subject: [PATCH 16/17] Add Help button to Domain Page (#899)

- Add Help button to Domain Page, with useful links
- Gate it behind the Extended Domain Info feature flag for now
- Fix typo in CLI commands modal
- Set default border radius for popovers to 12px
---
 src/config/theme/theme-light.config.ts        |   1 +
 .../domain-page-help-menu-config.ts           |  40 ++++++
 .../config/domain-page-help-menu.config.ts    |  50 +++++++
 .../domain-page-help-item-button.test.tsx     |  58 ++++++++
 .../domain-page-help-item-button.styles.ts    |  25 ++++
 .../domain-page-help-item-button.tsx          |  56 ++++++++
 .../domain-page-help-item-button.types.ts     |  33 +++++
 .../__tests__/domain-page-help.test.tsx       | 124 ++++++++++++++++++
 .../domain-page-help.styles.ts                |  38 ++++++
 .../domain-page-help/domain-page-help.tsx     |  48 +++++++
 .../domain-page-help.types.ts                 |   8 ++
 .../__tests__/domain-page-tabs.test.tsx       |  11 ++
 .../domain-page-tabs/domain-page-tabs.tsx     |   2 +
 .../workflow-page-cli-commands-modal.test.tsx |   2 +-
 .../workflow-page-cli-commands-modal.tsx      |   5 +-
 15 files changed, 498 insertions(+), 3 deletions(-)
 create mode 100644 src/views/domain-page/__fixtures__/domain-page-help-menu-config.ts
 create mode 100644 src/views/domain-page/config/domain-page-help-menu.config.ts
 create mode 100644 src/views/domain-page/domain-page-help-item-button/__tests__/domain-page-help-item-button.test.tsx
 create mode 100644 src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.styles.ts
 create mode 100644 src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.tsx
 create mode 100644 src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.types.ts
 create mode 100644 src/views/domain-page/domain-page-help/__tests__/domain-page-help.test.tsx
 create mode 100644 src/views/domain-page/domain-page-help/domain-page-help.styles.ts
 create mode 100644 src/views/domain-page/domain-page-help/domain-page-help.tsx
 create mode 100644 src/views/domain-page/domain-page-help/domain-page-help.types.ts

diff --git a/src/config/theme/theme-light.config.ts b/src/config/theme/theme-light.config.ts
index 3cf18e461..b9c736193 100644
--- a/src/config/theme/theme-light.config.ts
+++ b/src/config/theme/theme-light.config.ts
@@ -18,6 +18,7 @@ const themeLight = {
   },
   borders: {
     buttonBorderRadiusMini: '8px',
+    popoverBorderRadius: '12px',
   },
 } satisfies DeepPartial<MakeExtendable<Theme>>;
 
diff --git a/src/views/domain-page/__fixtures__/domain-page-help-menu-config.ts b/src/views/domain-page/__fixtures__/domain-page-help-menu-config.ts
new file mode 100644
index 000000000..87ce3122d
--- /dev/null
+++ b/src/views/domain-page/__fixtures__/domain-page-help-menu-config.ts
@@ -0,0 +1,40 @@
+import { createElement } from 'react';
+
+import { type DomainPageHelpMenuConfig } from '../domain-page-help/domain-page-help.types';
+
+export const mockDomainPageHelpMenuConfig = [
+  {
+    title: 'Documentation',
+    items: [
+      {
+        kind: 'link',
+        text: 'Get started (docs)',
+        icon: () => createElement('span', {}, 'Docs Icon'),
+        href: 'https://mock.docs.link',
+      },
+    ],
+  },
+  {
+    title: 'Commands',
+    items: [
+      {
+        kind: 'modal',
+        text: 'Domain commands',
+        icon: () => createElement('span', {}, 'Cmds Icon'),
+        modal: ({ isOpen }) =>
+          createElement('div', {}, isOpen ? 'Open modal' : 'Closed modal'),
+      },
+    ],
+  },
+  {
+    title: 'Actions',
+    items: [
+      {
+        kind: 'other',
+        text: 'Custom action',
+        icon: () => createElement('span', {}, 'Other Icon'),
+        onClick: jest.fn(),
+      },
+    ],
+  },
+] as const satisfies DomainPageHelpMenuConfig;
diff --git a/src/views/domain-page/config/domain-page-help-menu.config.ts b/src/views/domain-page/config/domain-page-help-menu.config.ts
new file mode 100644
index 000000000..95cad970e
--- /dev/null
+++ b/src/views/domain-page/config/domain-page-help-menu.config.ts
@@ -0,0 +1,50 @@
+import { FaSlack } from 'react-icons/fa';
+import { MdArticle, MdTerminal } from 'react-icons/md';
+
+import WorkflowPageCliCommandsModal from '@/views/workflow-page/workflow-page-cli-commands-modal/workflow-page-cli-commands-modal';
+
+import { type DomainPageHelpMenuConfig } from '../domain-page-help/domain-page-help.types';
+
+const domainPageHelpMenuConfig = [
+  {
+    title: 'Getting started',
+    items: [
+      {
+        kind: 'link',
+        text: 'Get started (docs)',
+        icon: MdArticle,
+        href: 'https://cadenceworkflow.io/docs/get-started',
+      },
+    ],
+  },
+  {
+    title: 'CLI Commands',
+    items: [
+      {
+        kind: 'modal',
+        text: 'Domain commands',
+        icon: MdTerminal,
+        modal: WorkflowPageCliCommandsModal,
+      },
+    ],
+  },
+  {
+    title: 'Other',
+    items: [
+      {
+        kind: 'link',
+        text: 'Cadence Docs',
+        icon: MdArticle,
+        href: 'https://cadenceworkflow.io/docs/concepts',
+      },
+      {
+        kind: 'link',
+        text: 'Cadence on Slack',
+        icon: FaSlack,
+        href: 'http://t.uber.com/cadence-slack',
+      },
+    ],
+  },
+] as const satisfies DomainPageHelpMenuConfig;
+
+export default domainPageHelpMenuConfig;
diff --git a/src/views/domain-page/domain-page-help-item-button/__tests__/domain-page-help-item-button.test.tsx b/src/views/domain-page/domain-page-help-item-button/__tests__/domain-page-help-item-button.test.tsx
new file mode 100644
index 000000000..c52ef1a30
--- /dev/null
+++ b/src/views/domain-page/domain-page-help-item-button/__tests__/domain-page-help-item-button.test.tsx
@@ -0,0 +1,58 @@
+import { render, screen, userEvent } from '@/test-utils/rtl';
+
+import { mockDomainPageHelpMenuConfig } from '../../__fixtures__/domain-page-help-menu-config';
+import DomainPageHelpItemButton from '../domain-page-help-item-button';
+
+const linkItem = mockDomainPageHelpMenuConfig[0].items[0];
+const modalItem = mockDomainPageHelpMenuConfig[1].items[0];
+const otherItem = mockDomainPageHelpMenuConfig[2].items[0];
+
+describe(DomainPageHelpItemButton.name, () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('renders a link button correctly', () => {
+    render(<DomainPageHelpItemButton {...linkItem} />);
+
+    const linkItemButton = screen.getByRole('link');
+    expect(linkItemButton).toBeInTheDocument();
+
+    expect(linkItemButton).toHaveTextContent('Get started (docs)');
+    expect(linkItemButton).toHaveAttribute('target', '_blank');
+    expect(linkItemButton).toHaveAttribute('rel', 'noreferrer');
+    expect(linkItemButton).toHaveAttribute('href', 'https://mock.docs.link');
+
+    expect(screen.getByText('Docs Icon')).toBeInTheDocument();
+  });
+
+  it('renders a modal button correctly and opens the modal on click', async () => {
+    const user = userEvent.setup();
+    render(<DomainPageHelpItemButton {...modalItem} />);
+
+    const buttonElement = screen.getByText('Domain commands');
+    expect(buttonElement).toBeInTheDocument();
+
+    expect(screen.getByText('Cmds Icon')).toBeInTheDocument();
+
+    expect(screen.getByText('Closed modal')).toBeInTheDocument();
+
+    await user.click(buttonElement);
+
+    expect(await screen.findByText('Open modal')).toBeInTheDocument();
+  });
+
+  it('renders an action button correctly and calls onClick handler', async () => {
+    const user = userEvent.setup();
+    render(<DomainPageHelpItemButton {...otherItem} />);
+
+    const button = screen.getByText('Custom action');
+    expect(button).toBeInTheDocument();
+
+    expect(screen.getByText('Other Icon')).toBeInTheDocument();
+
+    await user.click(button);
+
+    expect(otherItem.onClick).toHaveBeenCalledTimes(1);
+  });
+});
diff --git a/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.styles.ts b/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.styles.ts
new file mode 100644
index 000000000..71cddc1c8
--- /dev/null
+++ b/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.styles.ts
@@ -0,0 +1,25 @@
+import { type Theme, styled as createStyled } from 'baseui';
+import { type ButtonOverrides } from 'baseui/button';
+import type { StyleObject } from 'styletron-react';
+
+export const overrides = {
+  button: {
+    BaseButton: {
+      style: ({ $theme }: { $theme: Theme }): StyleObject => ({
+        ...$theme.typography.LabelSmall,
+        justifyContent: 'flex-start',
+        whiteSpace: 'nowrap',
+      }),
+    },
+  } satisfies ButtonOverrides,
+};
+
+export const styled = {
+  ExternalLinkButtonContent: createStyled('div', ({ $theme }) => ({
+    display: 'flex',
+    gap: $theme.sizing.scale500,
+    justifyContent: 'space-between',
+    alignItems: 'center',
+    flexGrow: 1,
+  })),
+};
diff --git a/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.tsx b/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.tsx
new file mode 100644
index 000000000..7c0800b16
--- /dev/null
+++ b/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.tsx
@@ -0,0 +1,56 @@
+import { useState } from 'react';
+
+import { Button, type ButtonProps } from 'baseui/button';
+import Link from 'next/link';
+import { MdOpenInNew } from 'react-icons/md';
+
+import { overrides, styled } from './domain-page-help-item-button.styles';
+import { type DomainPageHelpItem } from './domain-page-help-item-button.types';
+
+export default function DomainPageHelpItemButton(item: DomainPageHelpItem) {
+  const [isModalOpen, setIsModalOpen] = useState(false);
+
+  const baseButtonProps: ButtonProps = {
+    kind: 'tertiary',
+    size: 'compact',
+    overrides: overrides.button,
+    startEnhancer: item.icon,
+  };
+
+  if (item.kind === 'link') {
+    return (
+      <Button
+        {...baseButtonProps}
+        $as={Link}
+        target="_blank"
+        rel="noreferrer"
+        href={item.href}
+      >
+        <styled.ExternalLinkButtonContent>
+          {item.text}
+          <MdOpenInNew />
+        </styled.ExternalLinkButtonContent>
+      </Button>
+    );
+  }
+
+  if (item.kind === 'modal') {
+    return (
+      <>
+        <Button {...baseButtonProps} onClick={() => setIsModalOpen(true)}>
+          {item.text}
+        </Button>
+        <item.modal
+          isOpen={isModalOpen}
+          onClose={() => setIsModalOpen(false)}
+        />
+      </>
+    );
+  }
+
+  return (
+    <Button {...baseButtonProps} onClick={item.onClick}>
+      {item.text}
+    </Button>
+  );
+}
diff --git a/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.types.ts b/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.types.ts
new file mode 100644
index 000000000..620e54afd
--- /dev/null
+++ b/src/views/domain-page/domain-page-help-item-button/domain-page-help-item-button.types.ts
@@ -0,0 +1,33 @@
+import { type IconProps } from 'baseui/icon';
+
+interface DomainPageHelpBaseItem {
+  kind: 'link' | 'modal' | 'other';
+  text: string;
+  icon: React.ComponentType<{
+    size: IconProps['size'];
+    color: IconProps['color'];
+  }>;
+}
+
+interface DomainPageHelpLinkItem extends DomainPageHelpBaseItem {
+  kind: 'link';
+  href: string;
+}
+
+interface DomainPageHelpModalItem extends DomainPageHelpBaseItem {
+  kind: 'modal';
+  modal: React.ComponentType<{
+    isOpen: boolean;
+    onClose: () => void;
+  }>;
+}
+
+interface DomainPageHelpOtherItem extends DomainPageHelpBaseItem {
+  kind: 'other';
+  onClick: () => void;
+}
+
+export type DomainPageHelpItem =
+  | DomainPageHelpLinkItem
+  | DomainPageHelpModalItem
+  | DomainPageHelpOtherItem;
diff --git a/src/views/domain-page/domain-page-help/__tests__/domain-page-help.test.tsx b/src/views/domain-page/domain-page-help/__tests__/domain-page-help.test.tsx
new file mode 100644
index 000000000..ee3e97e17
--- /dev/null
+++ b/src/views/domain-page/domain-page-help/__tests__/domain-page-help.test.tsx
@@ -0,0 +1,124 @@
+import { Suspense, useState } from 'react';
+
+import { type StatefulPopoverProps } from 'baseui/popover';
+import { HttpResponse } from 'msw';
+import { ErrorBoundary } from 'react-error-boundary';
+
+import { render, screen, userEvent } from '@/test-utils/rtl';
+
+import { type GetConfigResponse } from '@/route-handlers/get-config/get-config.types';
+
+import { mockDomainPageHelpMenuConfig } from '../../__fixtures__/domain-page-help-menu-config';
+import DomainPageHelp from '../domain-page-help';
+
+jest.mock(
+  '../../config/domain-page-help-menu.config',
+  () => mockDomainPageHelpMenuConfig
+);
+
+jest.mock('baseui/popover', () => {
+  const originalModule = jest.requireActual('baseui/popover');
+  return {
+    ...originalModule,
+    StatefulPopover: ({ content, children }: StatefulPopoverProps) => {
+      const [isShown, setIsShown] = useState(false);
+
+      return (
+        <div data-testid="popover" onClick={() => setIsShown(true)}>
+          {children}
+          {isShown ? (
+            <div data-testid="popover-content">
+              {typeof content !== 'function' && content}
+            </div>
+          ) : null}
+        </div>
+      );
+    },
+  };
+});
+
+jest.mock(
+  '../../domain-page-help-item-button/domain-page-help-item-button',
+  () => jest.fn(({ text }) => <div data-testid="help-item">{text}</div>)
+);
+
+describe(DomainPageHelp.name, () => {
+  it('renders the help button and popover when feature flag is enabled', async () => {
+    const { user } = await setup({ isExtendedMetadataEnabled: true });
+
+    const helpButton = await screen.findByText('Help');
+    expect(helpButton).toBeInTheDocument();
+
+    expect(screen.queryByTestId('popover-content')).not.toBeInTheDocument();
+
+    await user.click(screen.getByTestId('popover'));
+
+    expect(screen.getByTestId('popover-content')).toBeInTheDocument();
+
+    const helpItems = screen.getAllByTestId('help-item');
+    expect(helpItems).toHaveLength(3);
+
+    expect(screen.getByText('Get started (docs)')).toBeInTheDocument();
+    expect(screen.getByText('Domain commands')).toBeInTheDocument();
+    expect(screen.getByText('Custom action')).toBeInTheDocument();
+  });
+
+  it('does not render when feature flag is disabled', async () => {
+    await setup({ isExtendedMetadataEnabled: false });
+
+    expect(screen.queryByText('Help')).not.toBeInTheDocument();
+    expect(screen.queryByTestId('popover')).not.toBeInTheDocument();
+  });
+
+  it('handles API error gracefully', async () => {
+    await setup({ error: true });
+
+    expect(
+      await screen.findByText('Error loading help menu')
+    ).toBeInTheDocument();
+    expect(screen.queryByText('Help')).not.toBeInTheDocument();
+    expect(screen.queryByTestId('popover')).not.toBeInTheDocument();
+  });
+});
+
+async function setup({
+  isExtendedMetadataEnabled = false,
+  error = false,
+}: {
+  isExtendedMetadataEnabled?: boolean;
+  error?: boolean;
+}) {
+  const user = userEvent.setup();
+
+  const result = render(
+    <ErrorBoundary fallback={<div>Error loading help menu</div>}>
+      <Suspense fallback={<div>Loading...</div>}>
+        <DomainPageHelp />
+      </Suspense>
+    </ErrorBoundary>,
+    {
+      endpointsMocks: [
+        {
+          path: '/api/config',
+          httpMethod: 'GET',
+          mockOnce: false,
+          httpResolver: async () => {
+            if (error) {
+              return HttpResponse.json(
+                { message: 'Failed to fetch feature flag' },
+                { status: 500 }
+              );
+            }
+
+            return HttpResponse.json({
+              metadata: isExtendedMetadataEnabled,
+              issues: false,
+            } satisfies GetConfigResponse<'EXTENDED_DOMAIN_INFO_ENABLED'>);
+          },
+        },
+      ],
+    }
+  );
+
+  return { user, ...result };
+}
diff --git a/src/views/domain-page/domain-page-help/domain-page-help.styles.ts b/src/views/domain-page/domain-page-help/domain-page-help.styles.ts
new file mode 100644
index 000000000..319260d7c
--- /dev/null
+++ b/src/views/domain-page/domain-page-help/domain-page-help.styles.ts
@@ -0,0 +1,38 @@
+import { styled as createStyled, type Theme } from 'baseui';
+import { type PopoverOverrides } from 'baseui/popover';
+import type { StyleObject } from 'styletron-react';
+
+export const styled = {
+  HelpMenuGroup: createStyled('div', ({ $theme }) => ({
+    ':not(:first-child)': {
+      paddingTop: $theme.sizing.scale100,
+    },
+    ':not(:last-child)': {
+      borderBottom: `1px solid ${$theme.colors.borderOpaque}`,
+      paddingBottom: $theme.sizing.scale100,
+    },
+    display: 'flex',
+    flexDirection: 'column',
+  })),
+  HelpMenuGroupTitle: createStyled('div', ({ $theme }) => ({
+    ...$theme.typography.LabelXSmall,
+    color: $theme.colors.contentInverseTertiary,
+    paddingTop: $theme.sizing.scale300,
+    paddingBottom: $theme.sizing.scale100,
+    paddingLeft: $theme.sizing.scale300,
+    paddingRight: $theme.sizing.scale300,
+  })),
+};
+
+export const overrides = {
+  popover: {
+    Inner: {
+      style: ({ $theme }: { $theme: Theme }): StyleObject => ({
+        minWidth: '250px',
+        ...$theme.typography.LabelSmall,
+        backgroundColor: $theme.colors.backgroundPrimary,
+        padding: $theme.sizing.scale200,
+      }),
+    },
+  } satisfies PopoverOverrides,
+};
diff --git a/src/views/domain-page/domain-page-help/domain-page-help.tsx b/src/views/domain-page/domain-page-help/domain-page-help.tsx
new file mode 100644
index 000000000..f7ce350ef
--- /dev/null
+++ b/src/views/domain-page/domain-page-help/domain-page-help.tsx
@@ -0,0 +1,48 @@
+import { Button } from 'baseui/button';
+import { StatefulPopover } from 'baseui/popover';
+import { MdArrowDropDown, MdSupport } from 'react-icons/md';
+
+import domainPageHelpMenuConfig from '../config/domain-page-help-menu.config';
+import DomainPageHelpItemButton from '../domain-page-help-item-button/domain-page-help-item-button';
+import useSuspenseIsExtendedMetadataEnabled from '../hooks/use-is-extended-metadata-enabled/use-suspense-is-extended-metadata-enabled';
+
+import { overrides, styled } from './domain-page-help.styles';
+import { type DomainPageHelpGroup } from './domain-page-help.types';
+
+export default function DomainPageHelp() {
+  const {
+    data: { metadata: isExtendedMetadataEnabled },
+  } = useSuspenseIsExtendedMetadataEnabled();
+
+  if (!isExtendedMetadataEnabled) return null;
+
+  return (
+    <StatefulPopover
+      placement="bottomRight"
+      overrides={overrides.popover}
+      content={
+        <>
+          {domainPageHelpMenuConfig.map((group: DomainPageHelpGroup) => (
+            <styled.HelpMenuGroup key={group.title}>
+              <styled.HelpMenuGroupTitle>
+                {group.title}
+              </styled.HelpMenuGroupTitle>
+              {group.items.map((item) => (
+                <DomainPageHelpItemButton key={item.text} {...item} />
+              ))}
+            </styled.HelpMenuGroup>
+          ))}
+        </>
+      }
+    >
+      <Button
+        size="compact"
+        kind="secondary"
+        startEnhancer={<MdSupport size={20} />}
+        endEnhancer={<MdArrowDropDown size={20} />}
+      >
+        Help
+      </Button>
+    </StatefulPopover>
+  );
+}
diff --git a/src/views/domain-page/domain-page-help/domain-page-help.types.ts b/src/views/domain-page/domain-page-help/domain-page-help.types.ts
new file mode 100644
index 000000000..1f029a4f7
--- /dev/null
+++ b/src/views/domain-page/domain-page-help/domain-page-help.types.ts
@@ -0,0 +1,8 @@
+import { type DomainPageHelpItem } from '../domain-page-help-item-button/domain-page-help-item-button.types';
+
+export type DomainPageHelpGroup = {
+  title: string;
+  items: Array<DomainPageHelpItem>;
+};
+
+export type DomainPageHelpMenuConfig = Array<DomainPageHelpGroup>;
diff --git a/src/views/domain-page/domain-page-tabs/__tests__/domain-page-tabs.test.tsx b/src/views/domain-page/domain-page-tabs/__tests__/domain-page-tabs.test.tsx
index 070443eee..2d15dfd76 100644
--- a/src/views/domain-page/domain-page-tabs/__tests__/domain-page-tabs.test.tsx
+++ b/src/views/domain-page/domain-page-tabs/__tests__/domain-page-tabs.test.tsx
@@ -33,6 +33,10 @@ jest.mock('../../config/domain-page-tabs.config', () => ({
   },
 }));
 
+jest.mock('../../domain-page-help/domain-page-help', () =>
+  jest.fn(() => <button data-testid="domain-page-help">Help Button</button>)
+);
+
 describe('DomainPageTabs', () => {
   afterEach(() => {
     jest.clearAllMocks();
@@ -93,4 +97,11 @@ describe('DomainPageTabs', () => {
         expect(screen.queryByTestId(`${key}-artwork`)).not.toBeInTheDocument();
     });
   });
+
+  it('renders the help button as endEnhancer', () => {
+    render(<DomainPageTabs />);
+
+    expect(screen.getByTestId('domain-page-help')).toBeInTheDocument();
+    expect(screen.getByText('Help Button')).toBeInTheDocument();
+  });
 });
diff --git a/src/views/domain-page/domain-page-tabs/domain-page-tabs.tsx b/src/views/domain-page/domain-page-tabs/domain-page-tabs.tsx
index 29c5cfe65..39485a443 100644
--- a/src/views/domain-page/domain-page-tabs/domain-page-tabs.tsx
+++ b/src/views/domain-page/domain-page-tabs/domain-page-tabs.tsx
@@ -7,6 +7,7 @@ import PageTabs from '@/components/page-tabs/page-tabs';
 import decodeUrlParams from '@/utils/decode-url-params';
 
 import domainPageTabsConfig from '../config/domain-page-tabs.config';
+import DomainPageHelp from '../domain-page-help/domain-page-help';
 
 import { styled } from './domain-page-tabs.styles';
 import type { DomainPageTabsParams } from './domain-page-tabs.types';
@@ -32,6 +33,7 @@ export default function DomainPageTabs() {
             `${encodeURIComponent(newTab.toString())}${window.location.search}`
           );
         }}
+        endEnhancer={<DomainPageHelp />}
       />
     </styled.PageTabsContainer>
   );
diff --git a/src/views/workflow-page/workflow-page-cli-commands-modal/__tests__/workflow-page-cli-commands-modal.test.tsx b/src/views/workflow-page/workflow-page-cli-commands-modal/__tests__/workflow-page-cli-commands-modal.test.tsx
index 7c7d1f997..39901c871 100644
--- a/src/views/workflow-page/workflow-page-cli-commands-modal/__tests__/workflow-page-cli-commands-modal.test.tsx
+++ b/src/views/workflow-page/workflow-page-cli-commands-modal/__tests__/workflow-page-cli-commands-modal.test.tsx
@@ -60,7 +60,7 @@ describe('WorkflowPageCliCommandsModal', () => {
     expect(screen.getByText('CLI commands')).toBeInTheDocument();
     expect(
       screen.getByText(
-        'Here are a some useful common CLI commands to get started with Cadence.'
+        'Here are some useful common CLI commands to get started with Cadence.'
       )
     ).toBeInTheDocument();
     expect(screen.getByText('Close')).toBeInTheDocument();
diff --git a/src/views/workflow-page/workflow-page-cli-commands-modal/workflow-page-cli-commands-modal.tsx b/src/views/workflow-page/workflow-page-cli-commands-modal/workflow-page-cli-commands-modal.tsx
index dc66fbe87..eaf94e001 100644
--- a/src/views/workflow-page/workflow-page-cli-commands-modal/workflow-page-cli-commands-modal.tsx
+++ b/src/views/workflow-page/workflow-page-cli-commands-modal/workflow-page-cli-commands-modal.tsx
@@ -29,6 +29,7 @@ export default function WorkflowPageCliCommandsModal({
   onClose,
 }: Props) {
   const { cls, theme } = useStyletronClasses(cssStyles);
+
   const [selectedTab, setSelectedTab] = useState<CliCommandGroups>(
     workflowPageCliCommandsGroupsConfig[0].name
   );
@@ -37,13 +38,13 @@ export default function WorkflowPageCliCommandsModal({
       ({ group }) => group === selectedTab
     );
   }, [selectedTab]);
+
   return (
     <Modal size={SIZE.auto} isOpen={isOpen} onClose={onClose} closeable>
       <ModalHeader>
         CLI commands
         <ParagraphXSmall color={theme.colors.contentSecondary}>
-          Here are a some useful common CLI commands to get started with
-          Cadence.
+          Here are some useful common CLI commands to get started with Cadence.
         </ParagraphXSmall>
       </ModalHeader>
       <ModalBody>

From 01bbcab0ed617c6e2f5733f57c5a4d412d8a776b Mon Sep 17 00:00:00 2001
From: Assem Hafez <assem.hafez@uber.com>
Date: Fri, 16 May 2025 08:10:54 +0000
Subject: [PATCH 17/17] fix lint

---
 .../workflow-action-signal-form.tsx                         | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
index 2ea693895..f27695869 100644
--- a/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
+++ b/src/views/workflow-actions/workflow-action-signal-form/workflow-action-signal-form.tsx
@@ -5,8 +5,8 @@ import { Controller } from 'react-hook-form';
 
 import { type WorkflowActionFormProps } from '../workflow-actions.types';
 
-import { type SignalWorkflowFormData } from './workflow-action-signal-form.types';
 import { overrides } from './workflow-action-signal-form.styles';
+import { type SignalWorkflowFormData } from './workflow-action-signal-form.types';
 
 export default function WorkflowActionSignalForm({
   fieldErrors,
@@ -33,7 +33,7 @@ export default function WorkflowActionSignalForm({
               onChange={(e) => {
                 field.onChange(e.target.value);
               }}
-              size='compact'
+              size="compact"
               onBlur={field.onBlur}
               error={Boolean(getErrorMessage('signalName'))}
               placeholder="Enter signal name"
@@ -55,7 +55,7 @@ export default function WorkflowActionSignalForm({
               onChange={(e) => {
                 field.onChange(e.target.value);
               }}
-              size='compact'
+              size="compact"
               onBlur={field.onBlur}
               error={Boolean(getErrorMessage('signalInput'))}
               placeholder="Enter JSON input"