opsiom-cli 1.5.2__tar.gz → 1.6.0__tar.gz

{opsiom_cli-1.5.2 → opsiom_cli-1.6.0}/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Changelog
 
-## 1.5.2
+## 1.6.0
+
+### Ajouts
+- **Fichiers en contexte** : `/fichier <chemin>` joint un fichier texte à la prochaine question (retiré après envoi). `/fichier` liste, `/fichier effacer` retire. Option `-f/--file` (répétable) en question unique. Taille estimée en tokens affichée.
+- **Recettes réutilisables** : `opsiom recette` liste les recettes intégrées (résumé, correction, reformulation, traduction, explication, idées) ; `opsiom recette <nom> "texte"`, `-f fichier` ou un pipe. Recettes personnelles dans `~/.config/opsiom/recettes/<nom>.md`, qui remplacent une recette intégrée de même nom.
+- **Rendu Markdown en direct** (titres, gras, listes, tableaux, blocs de code colorés) avec l’extra `pretty` (rich). Désactivable avec `OPSIOM_PLAIN=1`.
+- **Complétion** des commandes, des identifiants de modèles (`/model`) et des chemins (`/fichier`), avec historique (extra `pretty`, prompt_toolkit). Sans l’extra, la saisie reste celle de readline.
+- **Jauge de quota** dans l’en-tête et dans `/quota` (orange dès 70 %, rouge dès 90 %).
+- Aide `/help` regroupée par thème.
+
+### Changements
+- `-m/--model` accepte un numéro, un nom partiel ou un identifiant, comme `/model`, et refuse les modèles hors forfait.
+- Installation : `pip install "opsiom-cli[pretty]"` pour le rendu enrichi. Le CLI fonctionne sans cet extra (texte brut, readline).
+
+## 1.5.0
 
 ### Ajouts
 - Sous-commandes `opsiom doctor` (diagnostic), `opsiom paths` (emplacements des fichiers) et `opsiom configure`.
@@ -16,6 +30,8 @@
 - `/save` : le nom de fichier est confiné au dossier des transcriptions (plus de `../` ni de chemin absolu).
 - Fichiers `config.json` et `usage.json` écrits de façon atomique, avec droits 600.
 - Une connexion Octix refusée n’est plus prise pour une réussite lorsque le Space redirige vers `/login`.
+- Connexion Octix : le formulaire `/login` est chargé puis soumis comme dans un navigateur (cookie de session et champs cachés).
+- Les caractères de contrôle insérés par erreur (par exemple par un Ctrl+V sous Windows) sont retirés du mot de passe.
 - Une réponse interrompue avant l’évènement de fin est signalée comme erreur.
 - Après une reconnexion Octix, le message est renvoyé automatiquement.
 - Les réponses conservent leurs retours à la ligne et leur indentation (listes, blocs de code).

{opsiom_cli-1.5.2 → opsiom_cli-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: opsiom-cli
-Version: 1.5.2
+Version: 1.6.0
 Summary: Interface en ligne de commande pour discuter avec Opsiom, l'assistant IA francophone.
 Keywords: chatbot,cli,francophone,ia,opsiom
 Classifier: Environment :: Console
@@ -13,7 +13,12 @@ Classifier: Topic :: Communications :: Chat
 Requires-Python: >=3.9
 Requires-Dist: requests>=2.31
 Provides-Extra: dev
+Requires-Dist: prompt-toolkit>=3; extra == 'dev'
 Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: rich>=13; extra == 'dev'
+Provides-Extra: pretty
+Requires-Dist: prompt-toolkit>=3; extra == 'pretty'
+Requires-Dist: rich>=13; extra == 'pretty'
 Description-Content-Type: text/markdown
 
 # opsiom-cli
@@ -62,7 +67,9 @@ opsiom
 | `opsiom` | Session interactive. |
 | `opsiom -p "Résume ce texte"` | Pose une question, affiche la réponse et quitte. |
 | `cat notes.txt \| opsiom` | Envoie le contenu de l’entrée standard comme question. |
-| `opsiom -m <modèle> …` | Choisit le modèle (identifiant ou nom partiel). |
+| `opsiom -f <fichier> -p "…"` | Joint un fichier texte à la question (répétable avec `-f`). |
+| `opsiom recette` | Liste les recettes. `opsiom recette <nom> "texte"` applique une recette. |
+| `opsiom -m <modèle> …` | Choisit le modèle (numéro, identifiant ou nom partiel). |
 | `opsiom configure` | Reconfigure le serveur et la clé d’accès. |
 | `opsiom doctor` | Vérifie l’URL, le serveur, les modèles et le quota. |
 | `opsiom paths` | Affiche les emplacements des fichiers locaux. |
@@ -81,15 +88,50 @@ Dans une session, tapez `"""` seul sur une ligne, écrivez votre texte, puis ter
 | `/save [nom]` | Exporte la conversation en Markdown dans `~/opsiom-conversations/`. |
 | `/new` | Repart d’une conversation vide. |
 | `/clear` | Efface l’écran. |
+| `/fichier [chemin\|effacer]` | Joint un fichier texte à la prochaine question. Sans argument, liste les fichiers en attente. |
 | `/model [id ou numéro]` | Change de modèle. Sans argument, affiche un menu. |
 | `/models` | Liste les modèles disponibles. |
 | `/status` | Rappelle la connexion, le compte et le quota. |
-| `/quota` | Affiche le quota restant aujourd’hui. |
+| `/quota` | Affiche la jauge et le quota restant aujourd’hui. |
 | `/doctor` | Lance le diagnostic depuis la session. |
 | `/help` | Affiche l’aide. |
 | `/quit` | Quitte (aussi `/exit`, ou Ctrl+D). |
 
-Raccourcis : **Entrée** envoie, **Ctrl+C** annule la saisie ou la réponse en cours, **Ctrl+D** quitte. L’historique des saisies se parcourt avec les flèches.
+Raccourcis : **Entrée** envoie, **Ctrl+C** annule la saisie ou la réponse en cours, **Ctrl+D** quitte. L’historique des saisies se parcourt avec les flèches. **Tab** complète les commandes, les modèles après `/model` et les chemins après `/fichier`.
+
+### Joindre des fichiers
+
+Un fichier texte (UTF-8, 200 Ko au maximum) peut être envoyé avec votre question :
+
+```
+/fichier rapport.md
+Résume les points faibles de ce rapport.
+```
+
+Le fichier est mis en attente, envoyé avec la prochaine question, puis retiré. Une estimation du nombre de tokens est affichée (≈ caractères / 4). Les fichiers binaires, trop volumineux ou non UTF-8 sont refusés avec un message explicite.
+
+En question unique : `opsiom -f rapport.md -p "Résume-le"`. Sans `-p`, la question par défaut est « Résume ce document. ».
+
+### Recettes
+
+Les recettes sont des consignes réutilisables :
+
+| Recette | Effet |
+|---|---|
+| `resume` | Résumé avec les points clés en liste. |
+| `corriger` | Correction de l’orthographe, de la grammaire et de la ponctuation. |
+| `reformuler` | Réécriture claire et professionnelle. |
+| `traduire-en-anglais` | Traduction en anglais, ton conservé. |
+| `expliquer` | Explication simple. |
+| `idees` | Dix idées en lien avec le texte. |
+
+```bash
+opsiom recette resume -f article.md
+cat notes.txt | opsiom recette corriger
+opsiom recette traduire-en-anglais "Bonjour à tous"
+```
+
+Pour ajouter les vôtres, créez un fichier `<nom>.md` dans le dossier affiché par `opsiom paths` (« recettes personnelles »). Un fichier de même nom remplace la recette intégrée.
 
 ## Configuration
 
@@ -111,7 +153,18 @@ Fichiers locaux (`opsiom paths` les affiche) :
 - **historique de saisie** : pour la flèche du haut.
 - **transcriptions** : dossier des exports `/save`.
 
-### Affichage
+### Affichage et extras
+
+Le CLI fonctionne seul. Deux extras enrichissent l’expérience :
+
+```bash
+pip install "opsiom-cli[pretty]"
+```
+
+- **rich** : rendu Markdown en direct dans le terminal.
+- **prompt_toolkit** : complétion des commandes, des modèles et des chemins, historique.
+
+Sans ces paquets, les réponses s’affichent en texte brut et la saisie reste celle du terminal. `OPSIOM_PLAIN=1` désactive le rendu Markdown.
 
 - Les couleurs sont désactivées si `NO_COLOR` est défini, si `TERM=dumb`, ou si la sortie est redirigée vers un fichier ou un pipe.
 - Sur un terminal sans UTF-8, les symboles basculent sur de l’ASCII.
@@ -133,6 +186,9 @@ Le quota se réinitialise chaque jour. Utilisez `/quota` pour voir où vous en
 **« modèle inconnu » ou « hors forfait »**
 Tapez `/models` pour la liste. Un modèle marqué « hors forfait » n’est pas inclus dans votre offre.
 
+**« fichier introuvable », « binaire », « non UTF-8 » ou « trop volumineux »**
+Le fichier joint doit être un texte UTF-8 de 200 Ko au maximum. Convertissez-le ou découpez-le en plusieurs fichiers.
+
 **Les accents ou les couleurs s’affichent mal**
 Utilisez un terminal qui gère l’UTF-8 et les couleurs 256. Sous Windows, préférez Windows Terminal.
 
@@ -160,11 +216,14 @@ Structure :
 
 ```
 src/opsiom_cli/
-├── cli.py       options, configuration, question unique, sous-commandes
+├── cli.py       options, configuration, question unique, recettes, sous-commandes
 ├── chat.py      session interactive, commandes, diagnostic, erreurs
 ├── clients.py   clients serveur API et Space Hugging Face, flux SSE
+├── files.py     fichiers joints : lecture, contrôles, mise en forme
+├── recipes.py   recettes intégrées et personnelles
+├── prompt.py    complétion et historique (prompt_toolkit, optionnel)
 ├── storage.py   chemins, configuration, quota local, transcriptions
-└── ui.py        couleurs, symboles, indicateur d’attente, streaming
+└── ui.py        couleurs, symboles, jauge, indicateur d’attente, rendu Markdown (rich, optionnel)
 tests/           tests unitaires et tests de bout en bout (faux serveur)
 ```
 

{opsiom_cli-1.5.2 → opsiom_cli-1.6.0}/README.md

@@ -44,7 +44,9 @@ opsiom
 | `opsiom` | Session interactive. |
 | `opsiom -p "Résume ce texte"` | Pose une question, affiche la réponse et quitte. |
 | `cat notes.txt \| opsiom` | Envoie le contenu de l’entrée standard comme question. |
-| `opsiom -m <modèle> …` | Choisit le modèle (identifiant ou nom partiel). |
+| `opsiom -f <fichier> -p "…"` | Joint un fichier texte à la question (répétable avec `-f`). |
+| `opsiom recette` | Liste les recettes. `opsiom recette <nom> "texte"` applique une recette. |
+| `opsiom -m <modèle> …` | Choisit le modèle (numéro, identifiant ou nom partiel). |
 | `opsiom configure` | Reconfigure le serveur et la clé d’accès. |
 | `opsiom doctor` | Vérifie l’URL, le serveur, les modèles et le quota. |
 | `opsiom paths` | Affiche les emplacements des fichiers locaux. |
@@ -63,15 +65,50 @@ Dans une session, tapez `"""` seul sur une ligne, écrivez votre texte, puis ter
 | `/save [nom]` | Exporte la conversation en Markdown dans `~/opsiom-conversations/`. |
 | `/new` | Repart d’une conversation vide. |
 | `/clear` | Efface l’écran. |
+| `/fichier [chemin\|effacer]` | Joint un fichier texte à la prochaine question. Sans argument, liste les fichiers en attente. |
 | `/model [id ou numéro]` | Change de modèle. Sans argument, affiche un menu. |
 | `/models` | Liste les modèles disponibles. |
 | `/status` | Rappelle la connexion, le compte et le quota. |
-| `/quota` | Affiche le quota restant aujourd’hui. |
+| `/quota` | Affiche la jauge et le quota restant aujourd’hui. |
 | `/doctor` | Lance le diagnostic depuis la session. |
 | `/help` | Affiche l’aide. |
 | `/quit` | Quitte (aussi `/exit`, ou Ctrl+D). |
 
-Raccourcis : **Entrée** envoie, **Ctrl+C** annule la saisie ou la réponse en cours, **Ctrl+D** quitte. L’historique des saisies se parcourt avec les flèches.
+Raccourcis : **Entrée** envoie, **Ctrl+C** annule la saisie ou la réponse en cours, **Ctrl+D** quitte. L’historique des saisies se parcourt avec les flèches. **Tab** complète les commandes, les modèles après `/model` et les chemins après `/fichier`.
+
+### Joindre des fichiers
+
+Un fichier texte (UTF-8, 200 Ko au maximum) peut être envoyé avec votre question :
+
+```
+/fichier rapport.md
+Résume les points faibles de ce rapport.
+```
+
+Le fichier est mis en attente, envoyé avec la prochaine question, puis retiré. Une estimation du nombre de tokens est affichée (≈ caractères / 4). Les fichiers binaires, trop volumineux ou non UTF-8 sont refusés avec un message explicite.
+
+En question unique : `opsiom -f rapport.md -p "Résume-le"`. Sans `-p`, la question par défaut est « Résume ce document. ».
+
+### Recettes
+
+Les recettes sont des consignes réutilisables :
+
+| Recette | Effet |
+|---|---|
+| `resume` | Résumé avec les points clés en liste. |
+| `corriger` | Correction de l’orthographe, de la grammaire et de la ponctuation. |
+| `reformuler` | Réécriture claire et professionnelle. |
+| `traduire-en-anglais` | Traduction en anglais, ton conservé. |
+| `expliquer` | Explication simple. |
+| `idees` | Dix idées en lien avec le texte. |
+
+```bash
+opsiom recette resume -f article.md
+cat notes.txt | opsiom recette corriger
+opsiom recette traduire-en-anglais "Bonjour à tous"
+```
+
+Pour ajouter les vôtres, créez un fichier `<nom>.md` dans le dossier affiché par `opsiom paths` (« recettes personnelles »). Un fichier de même nom remplace la recette intégrée.
 
 ## Configuration
 
@@ -93,7 +130,18 @@ Fichiers locaux (`opsiom paths` les affiche) :
 - **historique de saisie** : pour la flèche du haut.
 - **transcriptions** : dossier des exports `/save`.
 
-### Affichage
+### Affichage et extras
+
+Le CLI fonctionne seul. Deux extras enrichissent l’expérience :
+
+```bash
+pip install "opsiom-cli[pretty]"
+```
+
+- **rich** : rendu Markdown en direct dans le terminal.
+- **prompt_toolkit** : complétion des commandes, des modèles et des chemins, historique.
+
+Sans ces paquets, les réponses s’affichent en texte brut et la saisie reste celle du terminal. `OPSIOM_PLAIN=1` désactive le rendu Markdown.
 
 - Les couleurs sont désactivées si `NO_COLOR` est défini, si `TERM=dumb`, ou si la sortie est redirigée vers un fichier ou un pipe.
 - Sur un terminal sans UTF-8, les symboles basculent sur de l’ASCII.
@@ -115,6 +163,9 @@ Le quota se réinitialise chaque jour. Utilisez `/quota` pour voir où vous en
 **« modèle inconnu » ou « hors forfait »**
 Tapez `/models` pour la liste. Un modèle marqué « hors forfait » n’est pas inclus dans votre offre.
 
+**« fichier introuvable », « binaire », « non UTF-8 » ou « trop volumineux »**
+Le fichier joint doit être un texte UTF-8 de 200 Ko au maximum. Convertissez-le ou découpez-le en plusieurs fichiers.
+
 **Les accents ou les couleurs s’affichent mal**
 Utilisez un terminal qui gère l’UTF-8 et les couleurs 256. Sous Windows, préférez Windows Terminal.
 
@@ -142,11 +193,14 @@ Structure :
 
 ```
 src/opsiom_cli/
-├── cli.py       options, configuration, question unique, sous-commandes
+├── cli.py       options, configuration, question unique, recettes, sous-commandes
 ├── chat.py      session interactive, commandes, diagnostic, erreurs
 ├── clients.py   clients serveur API et Space Hugging Face, flux SSE
+├── files.py     fichiers joints : lecture, contrôles, mise en forme
+├── recipes.py   recettes intégrées et personnelles
+├── prompt.py    complétion et historique (prompt_toolkit, optionnel)
 ├── storage.py   chemins, configuration, quota local, transcriptions
-└── ui.py        couleurs, symboles, indicateur d’attente, streaming
+└── ui.py        couleurs, symboles, jauge, indicateur d’attente, rendu Markdown (rich, optionnel)
 tests/           tests unitaires et tests de bout en bout (faux serveur)
 ```
 

opsiom_cli-1.6.0/command.txt

@@ -0,0 +1,4 @@
+Remove-Item -Recurse -Force .\dist
+Remove-Item -Recurse -Force .\src\opsiom_cli.egg-info
+python -m build
+python -m twine upload dist/*

{opsiom_cli-1.5.2 → opsiom_cli-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "opsiom-cli"
-version = "1.5.2"
+version = "1.6.0"
 description = "Interface en ligne de commande pour discuter avec Opsiom, l'assistant IA francophone."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -26,7 +26,16 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-dev = ["pytest>=7"]
+# Rendu Markdown dans le terminal et complétion des commandes.
+pretty = [
+    "rich>=13",
+    "prompt_toolkit>=3",
+]
+dev = [
+    "pytest>=7",
+    "rich>=13",
+    "prompt_toolkit>=3",
+]
 
 [project.scripts]
 opsiom = "opsiom_cli.cli:main"

{opsiom_cli-1.5.2 → opsiom_cli-1.6.0}/src/opsiom_cli/chat.py

@@ -13,6 +13,8 @@ import requests
 
 from . import __version__, storage
 from .clients import ServerError, error_detail
+from .files import FileError, build_message, load_text_file
+from .prompt import CommandCompleter, formatted, make_prompt_session
 from .storage import (
     get_quota,
     is_insecure,
@@ -37,12 +39,13 @@ from .ui import (
     print_logo,
     print_ok,
     print_warn,
+    quota_bar,
     sym,
     term_width,
 )
 
 try:
-    import readline  # historique des saisies et édition de ligne
+    import readline  # historique et édition de ligne, sans prompt_toolkit
 except ImportError:  # absent sur certains Windows
     readline = None
 
@@ -56,6 +59,7 @@ HELP_GROUPS = [
     ("Conversation", [
         ("/retry", "", "relance la dernière question"),
         ("/copy", "", "copie la dernière réponse dans le presse-papiers"),
+        ("/fichier", "[chemin|effacer]", "joint un fichier texte à la prochaine question"),
         ("/save", "[nom]", "exporte la conversation en Markdown"),
         ("/new", "", "repart d’une conversation vide"),
         ("/clear", "", "efface l’écran"),
@@ -75,6 +79,10 @@ HELP_GROUPS = [
 ALIASES = {"exit": "quit"}
 
 
+def all_commands():
+    return [command for _title, items in HELP_GROUPS for command in items]
+
+
 # --- Erreurs -----------------------------------------------------------------
 
 def status_of(exc):
@@ -124,6 +132,17 @@ def record_usage(client, final):
         record_quota(client.identity, {"remaining": final["remaining_quota"]})
 
 
+def quota_line(client):
+    """Jauge et détail du quota, ou « non communiqué » si le serveur ne l'a pas donné."""
+    state = get_quota(client.identity)
+    if not state["known"]:
+        return muted("non communiqué par le serveur")
+    if state["unlimited"]:
+        return "illimité"
+    detail = f"{state['used']}/{state['limit']} tokens aujourd’hui"
+    return f"{quota_bar(state['used'], state['limit'])}  {muted(detail)}"
+
+
 # --- Authentification (Space Hugging Face) -----------------------------------
 
 def login_interactive(client, username=None, attempts=3):
@@ -170,7 +189,7 @@ def copy_to_clipboard(text):
     return False
 
 
-# --- Historique et saisie ----------------------------------------------------
+# --- Historique et saisie (readline, si prompt_toolkit est absent) -----------
 
 def rl_safe(text):
     """Entoure les séquences ANSI de \\x01…\\x02 pour que readline calcule
@@ -334,16 +353,18 @@ def _truncate(text, width):
 
 
 class ChatSession:
-    def __init__(self, client, model=None):
+    def __init__(self, client, model=None, attachments=None):
         self.client = client
         self.current_model = model
         self.models_payload = {"models": [], "default": None}
         self.transcript = []
+        self.pending = list(attachments or [])  # fichiers joints à la prochaine question
         self.last_user = None
         self.last_answer = None
         self.connected = False
         self.models_loaded = []
         self.problem = None  # (message, indication) si le serveur pose problème
+        self.prompt_session = None
 
     # -- démarrage -----------------------------------------------------------
 
@@ -377,7 +398,7 @@ class ChatSession:
         if self.problem:
             print_error(*self.problem)
         self.print_header()
-        print_hint('Tapez votre message. /help liste les commandes ; """ ouvre une saisie multiligne.')
+        print_hint('Tapez votre message. Tab complète les commandes ; """ ouvre une saisie multiligne.')
         print()
 
     def print_header(self):
@@ -390,9 +411,7 @@ class ChatSession:
             print(f"  {paint(sym('err'), 'error')} {muted('non connecté à')} {c.base_url}")
         print(f"    {muted('accès'.ljust(8))}{c.auth_label}")
         if c.tracks_quota:
-            state = get_quota(c.identity)
-            text = quota_text(state) if state["known"] else "non communiqué"
-            print(f"    {muted('quota'.ljust(8))}{paint(text, 'error' if quota_exhausted(state) else None)}")
+            print(f"    {muted('quota'.ljust(8))}{quota_line(c)}")
         if self.models_loaded:
             names = " · ".join(self.models_loaded)
             print(f"    {muted('modèles'.ljust(8))}{muted(_truncate(names, term_width() - 14))}")
@@ -404,25 +423,36 @@ class ChatSession:
         label = self.current_model or "opsiom"
         if len(label) > 24:
             label = label[:23] + "…"
-        return rl_safe(f"{muted(label)} {accent(sym('prompt'))} ")
+        return f"{muted(label)} {accent(sym('prompt'))} "
+
+    def _ask(self, text):
+        if self.prompt_session is not None:
+            return self.prompt_session.prompt(formatted(text)).strip()
+        return input(rl_safe(text)).strip()
+
+    def _model_choices(self):
+        return [(m["id"], m.get("label", m["id"])) for m in self.models_payload.get("models", [])]
 
     # -- boucle --------------------------------------------------------------
 
     def read_input(self):
-        text = input(self.prompt()).strip()
+        text = self._ask(self.prompt())
         if text != '"""':
             return text
         print_hint('saisie multiligne : terminez par """ seul sur une ligne')
         rows = []
         while True:
-            row = input(rl_safe(muted("… ")))
+            row = self._ask(muted("… "))
             if row.strip() == '"""':
                 break
             rows.append(row)
         return "\n".join(rows).strip()
 
     def run(self):
-        setup_history()
+        self.prompt_session = make_prompt_session(
+            CommandCompleter(all_commands(), self._model_choices), storage.HISTORY_PATH)
+        if self.prompt_session is None:
+            setup_history()
         try:
             while True:
                 try:
@@ -441,7 +471,8 @@ class ChatSession:
                 else:
                     self.send(line)
         finally:
-            save_history()
+            if self.prompt_session is None:
+                save_history()
         return 0
 
     def dispatch(self, line):
@@ -466,9 +497,9 @@ class ChatSession:
             print_info(bold(title))
             for name, args, desc in items:
                 usage = f"{name} {args}".rstrip()
-                print(f"    {accent(usage.ljust(22))} {muted(desc)}")
+                print(f"    {accent(usage.ljust(26))} {muted(desc)}")
             print()
-        print_hint("Entrée envoie · \"\"\" saisie multiligne · Ctrl+C annule la saisie · Ctrl+D quitte")
+        print_hint("Entrée envoie · \"\"\" saisie multiligne · Tab complète · Ctrl+C annule · Ctrl+D quitte")
 
     def cmd_clear(self, _arg):
         sys.stdout.write("\033[H\033[2J")
@@ -482,23 +513,48 @@ class ChatSession:
         if not self.client.tracks_quota:
             print_hint("pas de quota : aucune clé API configurée.")
             return
-        state = get_quota(self.client.identity)
-        if not state["known"]:
-            print_hint("quota non communiqué par le serveur pour l’instant.")
-        elif state["unlimited"]:
-            print_hint("quota illimité sur ce compte.")
-        else:
-            print_hint(f"{state['used']}/{state['limit']} tokens utilisés aujourd’hui — "
-                       f"{state['remaining']} restants.")
+        print(f"  {quota_line(self.client)}")
 
     def cmd_new(self, _arg):
         self.transcript = []
+        self.pending = []
         self.last_user = self.last_answer = None
         if self.client.new_conversation():
             print_ok("nouvelle conversation (historique du compte réinitialisé côté serveur).")
         else:
             print_ok("nouvelle conversation. Ce serveur ne garde pas d’historique.")
 
+    def cmd_fichier(self, arg):
+        if not arg:
+            if not self.pending:
+                print_hint("aucun fichier joint. Usage : /fichier <chemin>")
+                return
+            for item in self.pending:
+                print_info(f"{item.name}  ≈ {item.tokens} tokens")
+            print_hint("envoyé avec votre prochaine question · /fichier effacer pour retirer")
+            return
+        if arg.lower() in ("effacer", "clear"):
+            self.pending = []
+            print_ok("pièces jointes retirées.")
+            return
+        try:
+            item = load_text_file(arg)
+        except FileError as exc:
+            print_error(str(exc))
+            return
+        self.pending.append(item)
+        print_ok(f"joint : {item.name} (≈ {item.tokens} tokens). Il sera envoyé avec votre prochaine question.")
+
+    def cmd_copy(self, _arg):
+        if not self.last_answer:
+            print_hint("aucune réponse à copier.")
+            return
+        if copy_to_clipboard(self.last_answer):
+            print_ok("réponse copiée dans le presse-papiers.")
+        else:
+            print_warn("aucun outil de presse-papiers détecté.",
+                       "installez xclip, wl-copy ou xsel (Linux), ou utilisez /save.")
+
     def cmd_save(self, arg):
         if not self.transcript:
             print_hint("rien à enregistrer pour l’instant.")
@@ -542,16 +598,6 @@ class ChatSession:
             return
         self.send(self.last_user)
 
-    def cmd_copy(self, _arg):
-        if not self.last_answer:
-            print_hint("aucune réponse à copier.")
-            return
-        if copy_to_clipboard(self.last_answer):
-            print_ok("réponse copiée dans le presse-papiers.")
-        else:
-            print_warn("aucun outil de presse-papiers détecté.",
-                       "installez xclip, wl-copy ou xsel (Linux), ou utilisez /save.")
-
     def cmd_doctor(self, _arg):
         run_doctor(self.client)
 
@@ -567,15 +613,19 @@ class ChatSession:
                         "réessayez demain, ou changez de clé API avec : opsiom configure")
             return
 
-        self.transcript.append({"role": "user", "text": message})
+        names = [item.name for item in self.pending]
+        payload = build_message(message, self.pending)
+        shown = message + (f"  [fichier : {', '.join(names)}]" if names else "")
+        self.transcript.append({"role": "user", "text": shown})
         self.last_user = message
+
         spinner = Spinner("Réflexion", hint="Ctrl+C pour annuler")
         printer = None
         final = {}
         started = time.perf_counter()
         spinner.start()
         try:
-            with closing(self.client.chat_stream(message, model=self.current_model)) as stream:
+            with closing(self.client.chat_stream(payload, model=self.current_model)) as stream:
                 for piece in stream:
                     if isinstance(piece, dict):
                         final = piece
@@ -626,6 +676,7 @@ class ChatSession:
         answer = printer.finish()
         elapsed_ms = int((time.perf_counter() - started) * 1000)
         self.last_answer = answer
+        self.pending = []  # les fichiers joints ont été envoyés
         self.transcript.append({"role": "assistant", "text": answer,
                                 "model": final.get("model") or self.current_model or "?",
                                 "elapsed_ms": elapsed_ms})