refactor: Address review feedback for agent env var support

- Change configAgentConfig to configAgent for naming consistency
- Handle both JS config objects and JSON strings properly
- Remove separate env var chapter, integrate into existing table
- Add environment variable column to AI Agent configuration table

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: andreafalzetti

Parse-Dashboard/server.js

@@ -39,7 +39,7 @@ module.exports = (options) => {
   const configUserPassword = options.userPassword || process.env.PARSE_DASHBOARD_USER_PASSWORD;
   const configSSLKey = options.sslKey || process.env.PARSE_DASHBOARD_SSL_KEY;
   const configSSLCert = options.sslCert || process.env.PARSE_DASHBOARD_SSL_CERT;
-  const configAgentConfig = options.agentConfig || process.env.PARSE_DASHBOARD_AGENT_CONFIG;
+  const configAgent = options.agent || process.env.PARSE_DASHBOARD_AGENT_CONFIG;
 
   function handleSIGs(server) {
     const signals = {
@@ -85,12 +85,18 @@ module.exports = (options) => {
         ];
       }
       // Add agent configuration from environment variables
-      if (configAgentConfig) {
-        try {
-          configFromCLI.data.agent = JSON.parse(configAgentConfig);
-        } catch (error) {
-          console.error('Failed to parse PARSE_DASHBOARD_AGENT_CONFIG:', error.message);
-          process.exit(1);
+      if (configAgent) {
+        // If it's already an object (from JS config), use it directly
+        if (typeof configAgent === 'object') {
+          configFromCLI.data.agent = configAgent;
+        } else {
+          // Otherwise, try to parse it as JSON
+          try {
+            configFromCLI.data.agent = JSON.parse(configAgent);
+          } catch (error) {
+            console.error('Failed to parse PARSE_DASHBOARD_AGENT_CONFIG:', error.message);
+            process.exit(1);
+          }
         }
       }
     } else if (!configServerURL && !configMasterKey && !configAppName) {

README.md

@@ -1295,28 +1295,22 @@ To configure the AI agent for your dashboard, you need to add the `agent` config
 }
 ```
 
-| Parameter                   | Type   | Required | Description                                                                    |
-|-----------------------------|--------|----------|--------------------------------------------------------------------------------|
-| `agent`                     | Object | Yes      | The AI agent configuration object.                                             |
-| `agent.models`              | Array  | Yes      | Array of AI model configurations available to the agent.                      |
-| `agent.models[*].name`      | String | Yes      | The display name for the model (e.g., `ChatGPT 4.1`).                   |
-| `agent.models[*].provider`  | String | Yes      | The AI provider identifier (e.g., "openai").                     |
-| `agent.models[*].model`     | String | Yes      | The specific model name from the provider (e.g., `gpt-4.1`).   |
-| `agent.models[*].apiKey`    | String | Yes      | The API key for authenticating with the AI provider.                     |
+| Parameter                   | Type   | Required | Description                                                                    | Environment Variable |
+|-----------------------------|--------|----------|--------------------------------------------------------------------------------|-----------------------|
+| `agent`                     | Object | Yes      | The AI agent configuration object.                                             | `PARSE_DASHBOARD_AGENT_CONFIG` |
+| `agent.models`              | Array  | Yes      | Array of AI model configurations available to the agent.                      | - |
+| `agent.models[*].name`      | String | Yes      | The display name for the model (e.g., `ChatGPT 4.1`).                   | - |
+| `agent.models[*].provider`  | String | Yes      | The AI provider identifier (e.g., "openai").                     | - |
+| `agent.models[*].model`     | String | Yes      | The specific model name from the provider (e.g., `gpt-4.1`).   | - |
+| `agent.models[*].apiKey`    | String | Yes      | The API key for authenticating with the AI provider.                     | - |
 
-The agent will use the configured models to process natural language commands and perform database operations using the master key from your app configuration.
-
-### Environment Variables
-
-You can also configure the AI agent using environment variables, which is useful for containerized deployments or when you want to avoid storing API keys in configuration files.
-
-Set the `PARSE_DASHBOARD_AGENT_CONFIG` environment variable with a JSON string containing the full agent configuration:
-
-```
-PARSE_DASHBOARD_AGENT_CONFIG='{"models":[{"name":"ChatGPT 4.1","provider":"openai","model":"gpt-4.1","apiKey":"YOUR_API_KEY"}]}'
-```
+> [!Note]
+> When using the `PARSE_DASHBOARD_AGENT_CONFIG` environment variable, provide the complete agent configuration as a JSON string. For example:
+> ```bash
+> PARSE_DASHBOARD_AGENT_CONFIG='{"models":[{"name":"ChatGPT 4.1","provider":"openai","model":"gpt-4.1","apiKey":"YOUR_API_KEY"}]}'
+> ```
 
-This supports the same multi-model configuration structure as the JSON config file, allowing you to define multiple AI models in the array.
+The agent will use the configured models to process natural language commands and perform database operations using the master key from your app configuration.
 
 ### Providers