📜 Mémoire du Foyer de Calcifère ✨

1. Centralisation via MCP Nanobot Gateway

Problème : Les appels directs aux outils système (ls, cat, grep) par chaque agent généraient une surface d'attaque élargie et une consommation excessive de tokens (chaque commande était encapsulée dans un prompt LLM).

# Exemple de configuration dans servers.json
{
  "local_tools": {
    "read_only": ["ls", "cat", "grep", "df"],
    "restricted": {
      "rm": ["calcifere"],
      "mv": ["calcifere"]
    }
  }
}
            

2. Utilisation d'un Socket Unix

Problème : Les ports TCP (ex: 50**) étaient déjà saturés par LiteLLM (40**), llama.cpp (80**), et les APIs des agents (port dédié-port dédié). Ajouter un nouveau service HTTP aurait nécessité une reconfiguration complexe du pare-feu et des règles SSRF.

# Commande de test du socket
echo '{"jsonrpc": "2.0", "method": "ls", "params": {"path": "/home/hauuru"}, "id": 1}' | \
socat - UNIX-CONNECT:/tmp/nanobot_gateway.sock
            

1. Incompatibilité MCP Fédération Gateway

Erreur : Le binaire officiel McpFederationGateway (C#) imposait un protocole HTTP/REST alors que l'architecture existante utilisait stdio (JSON-RPC via socket). Les tests avec netcat échouaient systématiquement avec :

HTTP/1.1 400 Bad Request

Solution : Remplacement par un gateway Python ( nanobot_gateway_simple.py) utilisant subprocess et un socket Unix. Coût : 2 jours de développement, mais gain en stabilité.

2. Permissions MCP Mal Configurées

Erreur : La première version de servers.json autorisait rm -rf pour tous les agents, sans logs. Risque critique identifié lors d'un test :

hinn$ rm -rf dossier utilisateur/Desktop/

3. Fallbacks LiteLLM pour Cerebras

Erreur : La configuration initiale de litellm_config.yaml utilisait cerebras/gpt-oss-120b comme nom de modèle, ce qui provoquait des erreurs :

ProviderNotFoundError: No provider found for cerebras/gpt-oss-120b
                

Solution : Correction du nom du modèle en gpt-oss-120b et ajout explicite du provider cerebras dans la configuration :

providers:
  cerebras:
    api_key: "*****"
    api_base: "https://api.cerebras.ai/v1"
                

1. demarrage_du_chateau_ambulant.sh

Rôle : Script principal pour démarrer l'ensemble des services du Foyer (LiteLLM, agents Nanobot, MCP Gateway).

# Exemple de commande de démarrage
nohup nanobot serve --config ~/.nanobot-calcifere/config.json \
    > "$LOG_DIR/calcifere.log" 2>&1 &
            

2. nanobot_gateway_simple.py

Rôle : Gateway MCP simplifié en Python, remplaçant le binaire C# officiel. Utilise un socket Unix (/tmp/nanobot_gateway.sock) pour communiquer avec les agents Nanobot.

# Exemple de configuration dans servers.json
{
  "local_tools": {
    "read_only": ["ls", "cat", "grep"],
    "restricted": {
      "rm": ["calcifere"],
      "mv": ["calcifere"]
    }
  }
}

# Exemple d'appel via socket
{
  "jsonrpc": "2.0",
  "method": "execute_tool",
  "params": {
    "server_name": "local_tools",
    "tool_name": "ls",
    "arguments": {"path": "dossier utilisateur/Desktop"}
  },
  "id": 1
}
            

Flux de Communication

Utilisateur → Sen (WS port dédié) → Calcifère (API port dédié) → [Sophie|Marco|Hinn]
            

1. Schéma Global

  Utilisateur (Discord/Telegram/WS)
              ↓
  Sen (WS port dédié) — Gardienne du seuil
              ↓ (clarifie, dialogue, puis route)
  Calcifère (API port dédié) — Orchestrateur
              ↓ (route selon la tâche)
  ├─→ Sophie (API port dédié) — Planification, projets, mémoire
  ├─→ Marco (API port dédié) — Code, emails, prompts créatifs
  └─→ Hinn (API port dédié) — Exécution système (shell, SQL, web, MCP Gateway)
            

2. Composants Techniques

# litellm_config.yaml
providers:
  cerebras:
    api_key: "*****"
    api_base: "https://api.cerebras.ai/v1"

model_list:
  - model_name: gpt-oss-120b
    litellm_params:
      model: gpt-oss-120b
      api_key: "*****"
    

# Dans ~/.nanobot-hinn/config.json
{
  "tools": [
    {
      "name": "mcp_ls",
      "exec": {
        "command": [
          "jq -n --arg tool 'execute_tool' --argjson params \
          '{"server_name": "local_tools", "tool_name": "ls", "arguments": {"path": "{path}"}}' \
          '{tool: $tool, parameters: $params}' | \
          socat - UNIX-CONNECT:/tmp/nanobot_gateway.sock"
        ]
      },
      "parameters": {"path": {"type": "string"}}
    }
  ]
}