feat: bump go and add subdomains when running in server mode

* feat(deps): bump golang from 1.23-alpine to 1.24-alpine

Bumps golang from 1.23-alpine to 1.24-alpine.

---
updated-dependencies:
- dependency-name: golang
  dependency-version: 1.24-alpine
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* feat: update go mod too

* feat: add the ability to set a subdomain in a request when a test is executed

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: xavidop <xavi_tb@hotmail.com>

Author: dependabot[bot]

cloudrun.Dockerfile

@@ -1,5 +1,5 @@
 # Build stage
-FROM golang:1.23-alpine AS builder
+FROM golang:1.24-alpine AS builder
 
 WORKDIR /app
 

docs/docs/server/api-endpoints.md

@@ -14,6 +14,7 @@ Content-Type: application/json
 
 {
   "api_key": "your_api_key (optional)",
+  "voiceflow_subdomain": "your_custom_subdomain (optional)",
   "suite": {
     "name": "Example Suite",
     "description": "Suite used as an example",
@@ -60,6 +61,20 @@ Content-Type: application/json
 
 Executes a test suite asynchronously and returns an execution ID for tracking. The suite configuration and tests are now embedded directly in the request body, making the API more HTTP-friendly and eliminating the need for file system access.
 
+### Request Parameters
+
+- `api_key` (optional): Override the global Voiceflow API key for this specific test execution
+- `voiceflow_subdomain` (optional): Override the global Voiceflow subdomain for this specific test execution. This allows you to test against different Voiceflow environments or custom subdomains without affecting the global configuration
+- `suite`: The test suite configuration containing the test definitions
+
+### Using Custom Subdomains
+
+When you specify a `voiceflow_subdomain`, the API will use that subdomain for all interactions in the test suite. For example:
+
+- If you set `"voiceflow_subdomain": "my-custom-env"`, requests will be sent to `https://general-runtime.my-custom-env.voiceflow.com`
+- If you omit this field, the global subdomain configuration will be used
+- This is particularly useful for testing against staging environments or customer-specific deployments
+
 ## Get Test Status
 ```http
 GET /api/v1/tests/status/{execution_id}

docs/docs/server/introduction.md

@@ -8,6 +8,9 @@ The Voiceflow CLI now includes an HTTP API server that exposes test execution fu
 - **Real-time Logging**: Capture and return test execution logs in API responses
 - **OpenAPI/Swagger**: Auto-generated API documentation at `/swagger/index.html`
 - **Asynchronous Execution**: Non-blocking test execution with status tracking
+- **Custom Subdomains**: Support for per-request Voiceflow subdomain overrides
+- **Multi-Environment Testing**: Concurrent testing against different environments
+- **Thread Safety**: No race conditions when testing multiple subdomains simultaneously
 - **CORS Support**: Enable cross-origin requests for web frontends
 - **Health Checks**: Built-in health check endpoints
 

docs/docs/server/usage-examples.md

@@ -6,7 +6,47 @@
 ```bash
 curl -X POST http://localhost:8080/api/v1/tests/execute \
   -H "Content-Type: application/json" \
-  -d '{"api_key": "your_api_key (optional)","suite": {"name": "Example Suite","description": "Suite used as an example","environment_name": "production","tests": [{"id": "test_1","test": {"name": "Example test","description": "These are some tests","interactions": [{"id": "test_1_1","user": {"type": "text","text": "hi"},"agent": {"validate": [{"type": "contains","value": "hello"}]}}}]}}}]}}'
+  -d '{"api_key": "your_api_key (optional)","voiceflow_subdomain": "your_custom_subdomain (optional)","suite": {"name": "Example Suite","description": "Suite used as an example","environment_name": "production","tests": [{"id": "test_1","test": {"name": "Example test","description": "These are some tests","interactions": [{"id": "test_1_1","user": {"type": "text","text": "hi"},"agent": {"validate": [{"type": "contains","value": "hello"}]}}]}}]}}'
+```
+
+### 1b. Start a test execution with custom subdomain
+```bash
+curl -X POST http://localhost:8080/api/v1/tests/execute \
+  -H "Content-Type: application/json" \
+  -d '{
+    "api_key": "VF.DM.YOUR_API_KEY",
+    "voiceflow_subdomain": "staging-env",
+    "suite": {
+      "name": "Staging Environment Test",
+      "description": "Testing against staging environment",
+      "environment_name": "production",
+      "tests": [
+        {
+          "id": "staging_test_1",
+          "test": {
+            "name": "Basic staging test",
+            "description": "Test against staging subdomain",
+            "interactions": [
+              {
+                "id": "staging_interaction_1",
+                "user": {
+                  "type": "launch"
+                },
+                "agent": {
+                  "validate": [
+                    {
+                      "type": "contains",
+                      "value": "welcome"
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }'
 ```
 
 ### 2. Check test status
@@ -22,14 +62,15 @@ curl http://localhost:8080/health
 ## Using JavaScript/fetch
 
 ```javascript
-// Execute a test suite
+// Execute a test suite with custom subdomain
 const response = await fetch('http://localhost:8080/api/v1/tests/execute', {
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
   },
   body: JSON.stringify({
-    api_key: "your_api_key (optional)",
+    api_key: "VF.DM.YOUR_API_KEY",
+    voiceflow_subdomain: "staging-env", // Optional: use custom subdomain
     suite: {
       name: "Example Suite",
       description: "Suite used as an example",
@@ -72,6 +113,33 @@ const statusResponse = await fetch(`http://localhost:8080/api/v1/tests/status/${
 const status = await statusResponse.json();
 console.log('Status:', status.status);
 console.log('Logs:', status.logs);
+
+// Example with multiple environments
+const environments = [
+  { name: "production", subdomain: "" }, // Use global subdomain
+  { name: "staging", subdomain: "staging-env" },
+  { name: "development", subdomain: "dev-env" }
+];
+
+for (const env of environments) {
+  const envResponse = await fetch('http://localhost:8080/api/v1/tests/execute', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      api_key: "VF.DM.YOUR_API_KEY",
+      voiceflow_subdomain: env.subdomain,
+      suite: {
+        name: `${env.name} Test Suite`,
+        description: `Testing against ${env.name} environment`,
+        environment_name: "production",
+        tests: [/* your tests here */]
+      }
+    })
+  });
+  
+  const envExecution = await envResponse.json();
+  console.log(`${env.name} execution started:`, envExecution.id);
+}
 ```
 
 ## Using Python requests
@@ -80,9 +148,10 @@ console.log('Logs:', status.logs);
 import requests
 import time
 
-# Execute a test suite
+# Execute a test suite with custom subdomain
 response = requests.post('http://localhost:8080/api/v1/tests/execute', json={
-    'api_key': 'your_api_key (optional)',
+    'api_key': 'VF.DM.YOUR_API_KEY',
+    'voiceflow_subdomain': 'staging-env',  # Optional: use custom subdomain
     'suite': {
         'name': 'Example Suite',
         'description': 'Suite used as an example',
@@ -132,4 +201,41 @@ while True:
         break
 
     time.sleep(1)
+
+# Example: Testing multiple environments
+environments = [
+    {"name": "production", "subdomain": ""},  # Use global subdomain
+    {"name": "staging", "subdomain": "staging-env"},
+    {"name": "development", "subdomain": "dev-env"}
+]
+
+execution_ids = []
+
+for env in environments:
+    print(f"\nStarting test for {env['name']} environment...")
+    
+    response = requests.post('http://localhost:8080/api/v1/tests/execute', json={
+        'api_key': 'VF.DM.YOUR_API_KEY',
+        'voiceflow_subdomain': env['subdomain'],
+        'suite': {
+            'name': f"{env['name']} Test Suite",
+            'description': f"Testing against {env['name']} environment",
+            'environment_name': 'production',
+            'tests': [
+                # Your test definitions here
+            ]
+        }
+    })
+    
+    execution = response.json()
+    execution_ids.append((env['name'], execution['id']))
+    print(f"{env['name']} execution started: {execution['id']}")
+
+# Monitor all executions
+print("\nMonitoring all executions...")
+for env_name, execution_id in execution_ids:
+    print(f"\nChecking {env_name} ({execution_id})...")
+    status_response = requests.get(f"http://localhost:8080/api/v1/tests/status/{execution_id}")
+    status = status_response.json()
+    print(f"Status: {status['status']}")
 ```

docs/docs/static/swagger.json

@@ -199,6 +199,10 @@
                 },
                 "suite": {
                     "$ref": "#/definitions/TestSuiteRequest"
+                },
+                "voiceflow_subdomain": {
+                    "description": "Optional subdomain to override global.VoiceflowSubdomain",
+                    "type": "string"
                 }
             }
         },

docs/docs/static/swagger.yaml

@@ -31,6 +31,9 @@ definitions:
         type: string
       suite:
         $ref: '#/definitions/TestSuiteRequest'
+      voiceflow_subdomain:
+        description: Optional subdomain to override global.VoiceflowSubdomain
+        type: string
     required:
     - suite
     type: object

go.mod

@@ -1,8 +1,6 @@
 module github.com/xavidop/voiceflow-cli
 
-go 1.23.0
-
-toolchain go1.23.6
+go 1.24
 
 require (
 	github.com/pkg/errors v0.9.1

pkg/dialog/replay.go

@@ -64,7 +64,7 @@ func Replay(userID, environment, recordFile string) error {
 		time.Sleep(500 * time.Millisecond)
 
 		// Send interaction to Voiceflow
-		responses, err := voiceflow.DialogManagerInteract(environment, userID, testInteraction, "")
+		responses, err := voiceflow.DialogManagerInteract(environment, userID, testInteraction, "", "")
 		if err != nil {
 			return fmt.Errorf("error during dialog: %v", err)
 		}

pkg/dialog/start.go

@@ -90,7 +90,7 @@ func Start(userID, environment, recordFile string, saveTest bool) error {
 		userID = uuid.New().String()
 	}
 
-	responses, err := voiceflow.DialogManagerInteract(environment, userID, launchInteraction, "")
+	responses, err := voiceflow.DialogManagerInteract(environment, userID, launchInteraction, "", "")
 	if err != nil {
 		return fmt.Errorf("error starting dialog: %v", err)
 	}
@@ -150,7 +150,7 @@ func Start(userID, environment, recordFile string, saveTest bool) error {
 		}
 
 		// Send user input to Voiceflow
-		responses, err := voiceflow.DialogManagerInteract(environment, userID, interaction, "")
+		responses, err := voiceflow.DialogManagerInteract(environment, userID, interaction, "", "")
 		if err != nil {
 			return fmt.Errorf("error during dialog: %v", err)
 		}

pkg/test/execute.go

@@ -9,11 +9,12 @@ import (
 
 // HTTPSuiteRequest represents a test suite from HTTP request
 type HTTPSuiteRequest struct {
-	Name            string            `json:"name"`
-	Description     string            `json:"description"`
-	EnvironmentName string            `json:"environment_name"`
-	Tests           []HTTPTestRequest `json:"tests"`
-	ApiKey          string            `json:"api_key,omitempty"` // Optional token to override global.VoiceflowAPIKey
+	Name               string            `json:"name"`
+	Description        string            `json:"description"`
+	EnvironmentName    string            `json:"environment_name"`
+	Tests              []HTTPTestRequest `json:"tests"`
+	ApiKey             string            `json:"api_key,omitempty"`             // Optional token to override global.VoiceflowAPIKey
+	VoiceflowSubdomain string            `json:"voiceflow_subdomain,omitempty"` // Optional subdomain to override global.VoiceflowSubdomain
 }
 
 // HTTPTestRequest represents a test from HTTP request
@@ -62,6 +63,10 @@ func executeHTTPSuite(suiteReq HTTPSuiteRequest, logCollector *LogCollector) err
 	// Define the user ID
 	userID := uuid.New().String()
 
+	if suiteReq.VoiceflowSubdomain != "" {
+		logCollector.AddLog("Using Voiceflow subdomain: " + suiteReq.VoiceflowSubdomain)
+	}
+
 	logCollector.AddLog("Suite: " + suiteReq.Name)
 	logCollector.AddLog("Description: " + suiteReq.Description)
 	logCollector.AddLog("Environment: " + suiteReq.EnvironmentName)
@@ -71,7 +76,7 @@ func executeHTTPSuite(suiteReq HTTPSuiteRequest, logCollector *LogCollector) err
 	// Execute each test directly from the request data
 	for _, testReq := range suiteReq.Tests {
 		logCollector.AddLog("Running Test ID: " + testReq.ID)
-		err := runTest(suiteReq.EnvironmentName, userID, testReq.Test, suiteReq.ApiKey, logCollector)
+		err := runTest(suiteReq.EnvironmentName, userID, testReq.Test, suiteReq.ApiKey, suiteReq.VoiceflowSubdomain, logCollector)
 		if err != nil {
 			errorMsg := "Error running test " + testReq.ID + ": " + err.Error()
 			logCollector.AddLog(errorMsg)
@@ -107,7 +112,7 @@ func ExecuteSuite(suitesPath string) error {
 			}
 			// Create a dummy log collector for the existing file-based execution
 			logCollector := &LogCollector{Logs: []string{}}
-			err = runTest(suite.EnvironmentName, userID, test, "", logCollector) // No token provided, will use global.VoiceflowAPIKey
+			err = runTest(suite.EnvironmentName, userID, test, "", "", logCollector) // No token or subdomain provided, will use global values
 			if err != nil {
 				global.Log.Errorf("Error running test: %v", err)
 				return err