feat: planner-aware profile routing, execution timeline metadata, and Discord /chat model switching (with Ollama support)

.env.example

@@ -1,10 +1,14 @@
 # Discord bot credentials (required)
 DISCORD_TOKEN= # Discord bot token
 DISCORD_CLIENT_ID= # Discord application client ID
-DISCORD_GUILD_ID= # Discord server (guild) ID
+DISCORD_GUILD_IDS= # Preferred: comma-separated Discord server (guild) IDs for slash-command deployment
+DISCORD_GUILD_ID= # Legacy fallback: single Discord server (guild) ID
 DISCORD_USER_ID= # Discord user ID granted privileged access (owner-only actions, rate-limit bypass)
 DISCORD_SUPERUSER_IDS= # Optional comma-separated Discord user IDs allowed to review incidents; falls back to DISCORD_USER_ID when unset
-OPENAI_API_KEY=
+OPENAI_API_KEY= # Optional when using only Ollama-backed text profiles
+OLLAMA_BASE_URL= # Optional Ollama endpoint (local daemon or cloud URL)
+OLLAMA_API_KEY= # Optional for Ollama cloud endpoints that require auth
+OLLAMA_LOCAL_INFERENCE_ENABLED=false # Set true to allow localhost/loopback Ollama targets
 # Optional VoltOps tracing for VoltAgent runtime observability
 # Enable by setting both keys together; leave both empty to keep tracing disabled.
 # Get these from VoltOps project settings (console.voltagent.dev -> Settings -> Projects -> <project>).

docs/api/openapi.yaml

@@ -4,6 +4,7 @@ openapi: 3.1.0
 # Quick Map
 # - POST /api/chat: Chat (public; Turnstile + rate limits when configured)
 # - OPTIONS /api/chat: CORS preflight
+# - GET /api/chat/profiles: Enabled chat profile options (public)
 # - POST /api/internal/text: Trusted internal text task execution
 # - POST /api/internal/image: Trusted internal image task execution
 # - POST /api/internal/voice/tts: Trusted internal voice TTS execution
@@ -138,6 +139,29 @@ paths:
                 '204':
                     $ref: '#/components/responses/PreflightAccepted'
 
+    /api/chat/profiles:
+        get:
+            operationId: getChatProfiles
+            x-codeRefs:
+                - packages/backend/src/handlers/chatProfiles.ts#createChatProfilesHandler
+                - packages/api-client/src/chat.ts#createChatApi
+                - packages/contracts/src/web/types.ts#GetChatProfilesResponse
+            summary: List enabled chat profile options
+            description: |
+                Returns enabled chat profile ids for model/profile switching UX.
+                This endpoint is public-safe and excludes provider secrets/internal config.
+            tags:
+                - Chat
+            responses:
+                '200':
+                    description: Enabled chat profile options.
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ChatProfilesResponse'
+                '405':
+                    $ref: '#/components/responses/MethodNotAllowed'
+
     /api/internal/text:
         post:
             operationId: postInternalTextTask
@@ -1371,6 +1395,16 @@ components:
                     type: string
                     pattern: '^[a-z0-9][a-z0-9-]{0,31}$'
                     description: Optional profile selector resolved by backend prompt composition.
+                generation:
+                    type: object
+                    properties:
+                        reasoningEffort:
+                            type: string
+                            enum: [minimal, low, medium, high]
+                        verbosity:
+                            type: string
+                            enum: [low, medium, high]
+                    additionalProperties: false
                 trigger:
                     type: object
                     properties:
@@ -1428,6 +1462,31 @@ components:
                 - conversation
             additionalProperties: false
 
+        ChatProfileOption:
+            type: object
+            properties:
+                id:
+                    type: string
+                    minLength: 1
+                description:
+                    type: string
+                    minLength: 1
+            required:
+                - id
+            additionalProperties: false
+
+        ChatProfilesResponse:
+            type: object
+            properties:
+                profiles:
+                    type: array
+                    maxItems: 100
+                    items:
+                        $ref: '#/components/schemas/ChatProfileOption'
+            required:
+                - profiles
+            additionalProperties: false
+
         ChatResponse:
             discriminator:
                 propertyName: action