Architecture IA

const tools = [
  {
    name: "search_members",
    description: "Search for members matching criteria. Use this to find candidates for a request.",
    input_schema: {
      type: "object",
      properties: {
        postalCodes: { type: "array", items: { type: "string" } },
        minCapacity: { type: "number" },
        maxBudget: { type: "number" },
        configurations: {
          type: "array",
          items: {
            type: "string",
            enum: ["meeting", "u_shape", "theater", "cabaret", "classroom", "banquet", "cocktail"],
          },
          description: "Configurations Kactus acceptées (plusieurs possibles)",
        },
        dates: { type: "array", items: { type: "string", format: "date" } },
        semanticQuery: { type: "string", description: "Free text describing the desired ambiance, style, or specific needs" },
      },
    },
  },
  {
    name: "add_member_to_results",
    description: "Add a member to the request's result list",
    input_schema: { /* requestId, memberId, stage, position? */ },
  },
  {
    name: "remove_member_from_results",
    input_schema: { /* requestId, memberId */ },
  },
  {
    name: "advance_member_in_pipeline",
    input_schema: { /* requestId, memberId, toStage */ },
  },
  {
    name: "update_request_field",
    description: "Update a field of the current request (budget, dates, formats, etc.)",
    input_schema: { /* requestId, field, value */ },
  },
  {
    name: "get_member_knowledge",
    description: "Retrieve the knowledge base entries for a specific member",
    input_schema: { /* memberId, types?, query? */ },
  },
  {
    name: "find_similar_requests",
    description: "Find past requests similar to the current one. Use to learn from history.",
    input_schema: { /* requestId, limit? */ },
  },
  {
    name: "draft_email",
    description: "Draft an email (qualification, catalog, recommendation, etc.). Returns text, does NOT send.",
    input_schema: { /* requestId, type, recipient, context */ },
  },
  {
    name: "send_email",
    description: "Send an email. REQUIRES user confirmation before execution.",
    input_schema: { /* threadId?, to, subject, body, withWhatsapp? */ },
    requires_confirmation: true,
  },
  {
    name: "compose_catalog",
    description: "Compose a catalog from current results, 4 recommended + 4 compatible",
    input_schema: { /* requestId, recommended[], compatible[] */ },
  },
  {
    name: "list_request_results",
    description: "List the current member candidates for the request",
    input_schema: { /* requestId */ },
  },
];

async function chat(requestId: string, userId: string, userMessage: string) {
  const conversation = await getOrCreateConversation(requestId, userId);
  await appendMessage(conversation.id, "user", userMessage);

  const context = await buildContext(requestId);
  const systemPrompt = buildSystemPrompt(context);
  const messages = await loadMessages(conversation.id);

  let response = await claude.messages.create({
    model: "claude-sonnet-4-5",
    system: systemPrompt,
    messages,
    tools,
  });

  while (response.stop_reason === "tool_use") {
    const toolUses = response.content.filter((c) => c.type === "tool_use");
    const toolResults = [];

    for (const toolUse of toolUses) {
      if (TOOLS_REQUIRING_CONFIRMATION.includes(toolUse.name)) {
        // Persiste la proposition, attend l'utilisateur
        await appendMessage(conversation.id, "assistant", { content: response.content });
        return { needsConfirmation: true, toolUseId: toolUse.id };
      }
      const result = await executeTool(toolUse, { userId, requestId });
      toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: result });
    }

    await appendMessage(conversation.id, "assistant", { content: response.content });
    await appendMessage(conversation.id, "tool", { content: toolResults });

    response = await claude.messages.create({
      model: "claude-sonnet-4-5",
      system: systemPrompt,
      messages: await loadMessages(conversation.id),
      tools,
    });
  }

  await appendMessage(conversation.id, "assistant", { content: response.content });
  return { content: response.content };
}