fix(crm-agent): replace generateText+JSON.parse with generateStructuredData for intent detection

The CRM command agent was always falling back to GENERAL_CHAT and
showing the menu again because LLMs wrap JSON in markdown fences,
breaking JSON.parse. Switch to generateStructuredData with a Zod schema
which guarantees structured output regardless of LLM quirks.

Also exposes generateStructuredData as a public method on AIService.

apps/api/src/routes/ai.ts

@@ -383,20 +383,25 @@ export async function aiRoutes(fastify: FastifyInstance) {
         const { query } = bodySchema.parse(request.body);
         const organizationId = request.headers['x-organization-id'] as string;
 
-        // Step 1: Detect intent using a lightweight prompt
-        const systemPrompt = `You are a CRM Command Interpreter. Your job is to classify the user's intent into one of these:
-        - LIST_CONTACTS: User wants to see their contacts or history.
-        - SHOW_IMPORT: User wants to import data or Excel files.
-        - START_CAMPAIGN: User wants to start or generate a campaign.
-        - GENERAL_CHAT: Any other conversation.
+        // Step 1: Detect intent using structured output (avoids JSON.parse failures on markdown-wrapped responses)
+        const IntentSchema = z.object({
+            intent: z.enum(['LIST_CONTACTS', 'SHOW_IMPORT', 'START_CAMPAIGN', 'GENERAL_CHAT']),
+            reply: z.string().describe("A brief, friendly acknowledgment in French")
+        });
+
+        const intentPrompt = `You are a CRM Command Interpreter. Classify the user's intent:
+- LIST_CONTACTS: User wants to see contacts or history.
+- SHOW_IMPORT: User wants to import data or Excel files.
+- START_CAMPAIGN: User wants to start or generate a campaign.
+- GENERAL_CHAT: Anything else.
 
-        Return ONLY a JSON object: { "intent": "INTENT_NAME", "reply": "A brief, friendly acknowledgment in French" }`;
+User message: "${query.replace(/"/g, "'")}"`
 
-        const { text } = await aiService.generateText(systemPrompt, query, 0.1);
-        let analysis;
+        let analysis: { intent: string; reply: string };
         try {
-            analysis = JSON.parse(text);
-        } catch (e) {
+            const { data } = await aiService.generateStructuredData(intentPrompt, IntentSchema, 0.1);
+            analysis = data;
+        } catch {
             analysis = { intent: 'GENERAL_CHAT', reply: "Je suis à votre écoute. Comment puis-je vous aider ?" };
         }
 

packages/ai-sdk/src/index.ts

@@ -351,9 +351,14 @@ export class AIService {
         throw new Error(`[AI_ERROR] All providers for ${ProviderCapability.TEXT} failed.`);
     }
 
+    async generateStructuredData<T>(prompt: string, schema: z.ZodSchema<T>, temperature?: number, imageUrl?: string): Promise<{ data: T; aiSource: string; usage: TokenUsage }> {
+        const { data, source, usage } = await this.callWithFailover(prompt, schema, temperature, imageUrl);
+        return { data, aiSource: source, usage };
+    }
+
     async handleCrmConversation(
-        phoneNumber: string, 
-        organizationId: string, 
+        phoneNumber: string,
+        organizationId: string,
         userMessage: string
     ): Promise<{ response: string, aiSource: string }> {
         const memoryKey = `crm:chat:${organizationId}:${phoneNumber}`;