tramamind 0.5.0__tar.gz

tramamind-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bitfarmy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tramamind-0.5.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: tramamind
+Version: 0.5.0
+Summary: Local proxy that caps chat context, keeps recent turns and code verbatim, and prints the tokens it did not send.
+Author: bitfarmy
+License: MIT
+Project-URL: Homepage, https://github.com/bitfarmy/tramamind
+Project-URL: Repository, https://github.com/bitfarmy/tramamind
+Project-URL: Issues, https://github.com/bitfarmy/tramamind/issues
+Keywords: ollama,llm,context,tokens,proxy
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.5
+Requires-Dist: keyring>=24.3
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Dynamic: license-file
+
+# TramaMind
+
+Local proxy and chat that shows how many tokens it left out. Recent turns stay word for word, however long they are. From older turns it keeps up to four verbatim excerpts — a code block, a unified diff, a traceback, or a tool result — each at most 1500 characters, and only while they fit. One cloud call, and only when the local answer is empty, a short refusal, or you ask to redo it.
+
+```bash
+pipx install "git+https://github.com/bitfarmy/tramamind"
+tramamind demo
+tramamind pack session.json
+```
+
+`demo` needs no model. On the sample chat it prints:
+
+```
+full history ~10273 · packet ~1211 · −88%
+code kept verbatim: def add(a, b)
+last user message kept: What does add return?
+```
+
+The old turns in that sample are the same sentence repeated, which is why the gap is wide. `def add` comes from those old turns and is still in the packet. The last question is the original message. A long source file in the latest turns is sent whole, and the percentage gets smaller. The figure is this estimate (about 3.5 characters per token), on this chat.
+
+`pack` runs the same packet on your own transcript. The file is a JSON array of messages, or an object with a `messages` key. The line is the one the proxy prints (`storia intera`, `inviati`, the percentage), then the blocks that stayed. `--out packet.json` writes the messages that would be forwarded. Nothing is sent to a model.
+
+## In front of Cursor, Continue, or any OpenAI client
+
+```bash
+tramamind proxy
+```
+
+OpenAI base URL: `http://127.0.0.1:8788/v1`
+
+Default upstream: Ollama at `http://127.0.0.1:11434/v1`. OmniRoute, if you use it, is `--upstream http://127.0.0.1:20128/v1`. The chat page stays on port 8787.
+
+```yaml
+# Continue
+name: TramaMind
+provider: openai
+model: qwen2.5-coder:7b
+apiBase: http://127.0.0.1:8788/v1
+apiKey: ollama
+```
+
+Each request prints a line on stderr, and the response carries `X-Tramamind-Raw-Tokens`, `X-Tramamind-Sent-Tokens`, and `X-Tramamind-Saved-Pct`. When the upstream sends `prompt_tokens`, the same line gains `· api N` and the response gains `X-Tramamind-Api-Prompt-Tokens`. The summary is an excerpt, so the model already loaded for the client stays loaded. Your system message stays as it arrived. The log stores the counts.
+
+`--budget` defaults to 2500 estimated tokens and `--verbatim` to the last 6 messages. With a profile, those two values come from `~/.config/tramamind/profile.yaml`.
+
+## Chat on this machine
+
+```bash
+./scripts/install.sh
+.venv/bin/tramamind setup
+.venv/bin/tramamind pull
+.venv/bin/tramamind chat
+```
+
+`tramamind ui` serves http://127.0.0.1:8787. That page sets the token budget, chooses Ollama or OmniRoute, starts the proxy, and shows the last savings line.
+
+## In italiano
+
+Assistente personale sul tuo PC. Il modello di default è locale, via Ollama. La chat ricorda le sessioni e, quando la storia si allunga, ne manda un riassunto più gli ultimi turni, non la trascrizione intera. Se la risposta locale è vuota, è una scusa, o chiedi di rifarla, parte **una** chiamata cloud.
+
+OmniRoute, se lo installi, resta il tubo verso più provider. TramaMind non è un secondo router: decide cosa entra nel prompt e quale modello locale usare.
+
+```
+tramamind chat
+      │
+      ▼
+pacchetto con tetto ──► Ollama
+      │
+      └─ solo se serve ──► Groq diretto, oppure OmniRoute
+```
+
+Ollama da solo non tiene un tetto sulla storia e non cambia modello in base alla domanda. OmniRoute da solo non sceglie i modelli per la tua RAM e non distingue una risposta scarsa da un errore HTTP. TramaMind fa quelle due cose e lascia il resto a loro.
+
+`tramamind proxy` mette lo stesso pacchetto davanti a Cursor, Continue o a qualsiasi client compatibile con OpenAI. `tramamind demo` mostra il conto senza scaricare un modello. `tramamind pack sessione.json` fa lo stesso conto sulla tua trascrizione.
+
+Claude Pro non passa di qui. Per il codice serio resta Claude Code, diretto.
+
+```bash
+./scripts/install.sh
+.venv/bin/tramamind setup          # preset in base alla RAM, chiavi opzionali
+.venv/bin/tramamind pull           # scarica i tag del preset
+.venv/bin/tramamind chat
+```
+
+Pagina locale, solo su questa macchina: `tramamind ui` poi http://127.0.0.1:8787. Da lì partono anche tetto, upstream e il proxy su `http://127.0.0.1:8788/v1`.
+
+Corsie: `tramamind chat --code "…"`, `--think`, `--fast`. In chat: `/new`, `/sessions`, `/resume`, `/use code`, `/clear`.
+
+Sotto ogni risposta c'è il conto: token inviati, stima della storia intera, e la percentuale tolta dal pacchetto quando c'è stato un riassunto. `tramamind stats` aggrega quei conti, senza il testo.
+
+`tramamind doctor` dice cosa manca. Se Ollama non risponde, il comando fallisce: non stampa "attivo" lo stesso.
+
+### Preset
+
+| Preset | Quando | Generale | Codice | Ragionamento |
+|---|---|---|---|---|
+| `cpu16` | portatile, 16 GB | `gemma3:4b` | `qwen2.5-coder:3b` | `deepseek-r1:1.5b` |
+| `gpu12` | GPU ~12 GB | `qwen3:8b` | `qwen2.5-coder:7b` | `deepseek-r1:8b` |
+| `gpu24` | GPU 24 GB | `qwen3:32b` | `qwen2.5-coder:14b` | `deepseek-r1:14b` |
+
+Il tag `summary` del profilo è `gemma3:4b`. Viene chiamato solo se è già il modello della risposta (è il caso di `cpu16`). Sugli altri preset il riassunto è estrattivo, per non ricaricare un modello a ogni messaggio. Il proxy è sempre estrattivo. I tag sono quelli di [docs/local-models.md](docs/local-models.md).
+
+### Chiavi
+
+`tramamind keys add groq` le mette nel keyring (oppure in un file age, oppure in `~/.config/tramamind/.env` con permessi `0600`). Con una chiave Groq l'escalation funziona anche senza OmniRoute. `tramamind sync` spinge le chiavi nel CLI di OmniRoute, se c'è.
+
+Il modello cloud di default nel profilo è `openai/gpt-oss-120b`. Se quel catalogo cambia, lo sostituisci in `~/.config/tramamind/profile.yaml`.
+
+### Cosa non fa
+
+Il risparmio è il pacchetto: ultimi turni interi, e dai turni vecchi un estratto più fino a quattro pezzi parola per parola (codice, diff, traceback, risultato di un tool) se ci stanno. Ogni pezzo vecchio è al massimo 1500 caratteri. La compressione di OmniRoute, se la accendi dalla sua dashboard, è un'altra cosa e può tagliare proprio il pezzo che serviva. Il numero di cui mi fido è quello stampato da `tramamind chat`, da `tramamind demo`, da `tramamind pack` e dal proxy. Quando il provider manda `prompt_tokens`, la riga del proxy lo affianca alla stima.
+
+OpenHands e OpenClaw sono extra, spenti. L'app desktop e il nodo Oracle non fanno parte del flusso: gli appunti sono in [docs/future/](docs/future/).
+
+Licenza MIT. Uso personale delle API gratuite: [docs/legal.md](docs/legal.md).

tramamind-0.5.0/README.md

@@ -0,0 +1,115 @@
+# TramaMind
+
+Local proxy and chat that shows how many tokens it left out. Recent turns stay word for word, however long they are. From older turns it keeps up to four verbatim excerpts — a code block, a unified diff, a traceback, or a tool result — each at most 1500 characters, and only while they fit. One cloud call, and only when the local answer is empty, a short refusal, or you ask to redo it.
+
+```bash
+pipx install "git+https://github.com/bitfarmy/tramamind"
+tramamind demo
+tramamind pack session.json
+```
+
+`demo` needs no model. On the sample chat it prints:
+
+```
+full history ~10273 · packet ~1211 · −88%
+code kept verbatim: def add(a, b)
+last user message kept: What does add return?
+```
+
+The old turns in that sample are the same sentence repeated, which is why the gap is wide. `def add` comes from those old turns and is still in the packet. The last question is the original message. A long source file in the latest turns is sent whole, and the percentage gets smaller. The figure is this estimate (about 3.5 characters per token), on this chat.
+
+`pack` runs the same packet on your own transcript. The file is a JSON array of messages, or an object with a `messages` key. The line is the one the proxy prints (`storia intera`, `inviati`, the percentage), then the blocks that stayed. `--out packet.json` writes the messages that would be forwarded. Nothing is sent to a model.
+
+## In front of Cursor, Continue, or any OpenAI client
+
+```bash
+tramamind proxy
+```
+
+OpenAI base URL: `http://127.0.0.1:8788/v1`
+
+Default upstream: Ollama at `http://127.0.0.1:11434/v1`. OmniRoute, if you use it, is `--upstream http://127.0.0.1:20128/v1`. The chat page stays on port 8787.
+
+```yaml
+# Continue
+name: TramaMind
+provider: openai
+model: qwen2.5-coder:7b
+apiBase: http://127.0.0.1:8788/v1
+apiKey: ollama
+```
+
+Each request prints a line on stderr, and the response carries `X-Tramamind-Raw-Tokens`, `X-Tramamind-Sent-Tokens`, and `X-Tramamind-Saved-Pct`. When the upstream sends `prompt_tokens`, the same line gains `· api N` and the response gains `X-Tramamind-Api-Prompt-Tokens`. The summary is an excerpt, so the model already loaded for the client stays loaded. Your system message stays as it arrived. The log stores the counts.
+
+`--budget` defaults to 2500 estimated tokens and `--verbatim` to the last 6 messages. With a profile, those two values come from `~/.config/tramamind/profile.yaml`.
+
+## Chat on this machine
+
+```bash
+./scripts/install.sh
+.venv/bin/tramamind setup
+.venv/bin/tramamind pull
+.venv/bin/tramamind chat
+```
+
+`tramamind ui` serves http://127.0.0.1:8787. That page sets the token budget, chooses Ollama or OmniRoute, starts the proxy, and shows the last savings line.
+
+## In italiano
+
+Assistente personale sul tuo PC. Il modello di default è locale, via Ollama. La chat ricorda le sessioni e, quando la storia si allunga, ne manda un riassunto più gli ultimi turni, non la trascrizione intera. Se la risposta locale è vuota, è una scusa, o chiedi di rifarla, parte **una** chiamata cloud.
+
+OmniRoute, se lo installi, resta il tubo verso più provider. TramaMind non è un secondo router: decide cosa entra nel prompt e quale modello locale usare.
+
+```
+tramamind chat
+      │
+      ▼
+pacchetto con tetto ──► Ollama
+      │
+      └─ solo se serve ──► Groq diretto, oppure OmniRoute
+```
+
+Ollama da solo non tiene un tetto sulla storia e non cambia modello in base alla domanda. OmniRoute da solo non sceglie i modelli per la tua RAM e non distingue una risposta scarsa da un errore HTTP. TramaMind fa quelle due cose e lascia il resto a loro.
+
+`tramamind proxy` mette lo stesso pacchetto davanti a Cursor, Continue o a qualsiasi client compatibile con OpenAI. `tramamind demo` mostra il conto senza scaricare un modello. `tramamind pack sessione.json` fa lo stesso conto sulla tua trascrizione.
+
+Claude Pro non passa di qui. Per il codice serio resta Claude Code, diretto.
+
+```bash
+./scripts/install.sh
+.venv/bin/tramamind setup          # preset in base alla RAM, chiavi opzionali
+.venv/bin/tramamind pull           # scarica i tag del preset
+.venv/bin/tramamind chat
+```
+
+Pagina locale, solo su questa macchina: `tramamind ui` poi http://127.0.0.1:8787. Da lì partono anche tetto, upstream e il proxy su `http://127.0.0.1:8788/v1`.
+
+Corsie: `tramamind chat --code "…"`, `--think`, `--fast`. In chat: `/new`, `/sessions`, `/resume`, `/use code`, `/clear`.
+
+Sotto ogni risposta c'è il conto: token inviati, stima della storia intera, e la percentuale tolta dal pacchetto quando c'è stato un riassunto. `tramamind stats` aggrega quei conti, senza il testo.
+
+`tramamind doctor` dice cosa manca. Se Ollama non risponde, il comando fallisce: non stampa "attivo" lo stesso.
+
+### Preset
+
+| Preset | Quando | Generale | Codice | Ragionamento |
+|---|---|---|---|---|
+| `cpu16` | portatile, 16 GB | `gemma3:4b` | `qwen2.5-coder:3b` | `deepseek-r1:1.5b` |
+| `gpu12` | GPU ~12 GB | `qwen3:8b` | `qwen2.5-coder:7b` | `deepseek-r1:8b` |
+| `gpu24` | GPU 24 GB | `qwen3:32b` | `qwen2.5-coder:14b` | `deepseek-r1:14b` |
+
+Il tag `summary` del profilo è `gemma3:4b`. Viene chiamato solo se è già il modello della risposta (è il caso di `cpu16`). Sugli altri preset il riassunto è estrattivo, per non ricaricare un modello a ogni messaggio. Il proxy è sempre estrattivo. I tag sono quelli di [docs/local-models.md](docs/local-models.md).
+
+### Chiavi
+
+`tramamind keys add groq` le mette nel keyring (oppure in un file age, oppure in `~/.config/tramamind/.env` con permessi `0600`). Con una chiave Groq l'escalation funziona anche senza OmniRoute. `tramamind sync` spinge le chiavi nel CLI di OmniRoute, se c'è.
+
+Il modello cloud di default nel profilo è `openai/gpt-oss-120b`. Se quel catalogo cambia, lo sostituisci in `~/.config/tramamind/profile.yaml`.
+
+### Cosa non fa
+
+Il risparmio è il pacchetto: ultimi turni interi, e dai turni vecchi un estratto più fino a quattro pezzi parola per parola (codice, diff, traceback, risultato di un tool) se ci stanno. Ogni pezzo vecchio è al massimo 1500 caratteri. La compressione di OmniRoute, se la accendi dalla sua dashboard, è un'altra cosa e può tagliare proprio il pezzo che serviva. Il numero di cui mi fido è quello stampato da `tramamind chat`, da `tramamind demo`, da `tramamind pack` e dal proxy. Quando il provider manda `prompt_tokens`, la riga del proxy lo affianca alla stima.
+
+OpenHands e OpenClaw sono extra, spenti. L'app desktop e il nodo Oracle non fanno parte del flusso: gli appunti sono in [docs/future/](docs/future/).
+
+Licenza MIT. Uso personale delle API gratuite: [docs/legal.md](docs/legal.md).

tramamind-0.5.0/cli/__init__.py

@@ -0,0 +1 @@
+"""TramaMind CLI."""

tramamind-0.5.0/cli/__main__.py

@@ -0,0 +1,4 @@
+from cli.main import main
+import sys
+
+sys.exit(main())

tramamind-0.5.0/cli/assets/index.html

@@ -0,0 +1,243 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>TramaMind</title>
+<style>
+  :root { color-scheme: dark; }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0; min-height: 100vh;
+    background: #161410; color: #f4efe6;
+    font: 16px/1.45 ui-sans-serif, system-ui, sans-serif;
+  }
+  header, main { max-width: 980px; margin: 0 auto; padding: 1.2rem 1.2rem 0; }
+  h1 { font-size: 1.35rem; font-weight: 600; margin: 0 0 .2rem; }
+  p.lead { margin: 0; color: #b7ab9a; }
+  .grid { display: grid; grid-template-columns: 280px 1fr; gap: 1.2rem; padding: 1.2rem; max-width: 980px; margin: 0 auto; }
+  .grid > div { min-width: 0; }
+  section { border-top: 1px solid #3a342c; padding-top: .8rem; }
+  h2 { font-size: .78rem; letter-spacing: .06em; text-transform: uppercase; color: #b7ab9a; margin: 0 0 .6rem; }
+  button, select, textarea, input {
+    font: inherit; color: inherit; background: #221e19; border: 1px solid #4a4338; border-radius: 6px;
+  }
+  button { padding: .35rem .7rem; cursor: pointer; }
+  button.primary { background: #e6a15c; color: #1b140c; border-color: #e6a15c; }
+  button:disabled { opacity: .5; cursor: wait; }
+  .presets { display: flex; flex-wrap: wrap; gap: .4rem; }
+  .check { display: flex; gap: .4rem; margin: .2rem 0; }
+  .ok { color: #b7d3a8; } .warn { color: #e6c15c; } .fail { color: #e58b7a; }
+  #log { min-height: 240px; white-space: pre-wrap; }
+  .bubble { margin: 0 0 .9rem; }
+  .who { color: #b7ab9a; font-size: .85rem; }
+  .stats { color: #8d8274; font-size: .85rem; margin-top: .25rem; }
+  form.chat { display: flex; gap: .5rem; margin-top: .6rem; }
+  form.chat textarea { flex: 1; min-height: 3.2rem; padding: .5rem; resize: vertical; }
+  label { display: block; margin: .45rem 0 .2rem; color: #b7ab9a; font-size: .85rem; }
+  input[type="password"], input[type="number"], select, textarea.card { width: 100%; max-width: 100%; min-width: 0; padding: .4rem; }
+  .row { display: flex; flex-wrap: wrap; gap: .4rem; margin-top: .6rem; }
+  section.proxy { max-width: 28rem; }
+  textarea.card { min-height: 7rem; }
+  @media (max-width: 800px) { .grid { grid-template-columns: 1fr; } }
+</style>
+</head>
+<body>
+<header>
+  <h1>TramaMind</h1>
+  <p class="lead">Modello sul tuo PC. Il cloud parte solo se la risposta locale non basta.</p>
+</header>
+<main class="grid">
+  <div>
+    <section class="proxy">
+      <h2>Proxy</h2>
+      <label for="budget">Tetto</label>
+      <input id="budget" type="number" min="1" step="1" inputmode="numeric">
+      <label for="verbatim">Turni interi</label>
+      <input id="verbatim" type="number" min="1" step="1" inputmode="numeric">
+      <label for="upstream">Upstream</label>
+      <select id="upstream"></select>
+      <p class="stats" id="upstream-url"></p>
+      <p class="stats" id="proxy-url"></p>
+      <p class="stats" id="proxy-line">nessuna richiesta</p>
+      <p class="stats">Ferma e riavvia per applicare tetto e upstream.</p>
+      <div class="row">
+        <button id="save-proxy" type="button">Salva</button>
+        <button id="toggle-proxy" class="primary" type="button">Avvia</button>
+      </div>
+      <div id="proxy-note" class="stats"></div>
+    </section>
+    <section>
+      <h2>Macchina</h2>
+      <div id="checks"></div>
+    </section>
+    <section>
+      <h2>Preset</h2>
+      <div class="presets" id="presets"></div>
+    </section>
+    <section>
+      <h2>Chiave cloud</h2>
+      <label for="provider">Provider</label>
+      <select id="provider"></select>
+      <label for="secret">Chiave, resta su questo PC</label>
+      <input id="secret" type="password" autocomplete="off">
+      <button id="save-key" style="margin-top:.5rem">Salva</button>
+      <div id="key-note" class="stats"></div>
+    </section>
+    <section>
+      <h2>Scheda</h2>
+      <textarea id="card" class="card"></textarea>
+      <button id="save-card" style="margin-top:.5rem">Aggiorna scheda</button>
+    </section>
+  </div>
+  <div>
+    <section>
+      <h2>Chat</h2>
+      <label for="session">Sessione</label>
+      <select id="session"></select>
+      <div id="log"></div>
+      <form class="chat" id="chat">
+        <textarea id="message" placeholder="Scrivi. La storia lunga viene riassunta, non rispedita."></textarea>
+        <button class="primary" type="submit" id="send">Invia</button>
+      </form>
+    </section>
+  </div>
+</main>
+<script>
+const $ = (id) => document.getElementById(id);
+
+async function api(path, body) {
+  const opts = body ? {method: "POST", headers: {"Content-Type": "application/json"}, body: JSON.stringify(body)} : {};
+  const res = await fetch(path, opts);
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error || res.statusText);
+  return data;
+}
+
+function render(status) {
+  $("checks").innerHTML = status.checks.map(c =>
+    `<div class="check ${c.level}"><span>${c.level === "ok" ? "✓" : c.level === "warn" ? "!" : "✗"}</span><span><b>${c.name}</b> ${c.detail}</span></div>`
+  ).join("");
+  $("presets").innerHTML = Object.entries(status.presets).map(([id, label]) =>
+    `<button data-preset="${id}" ${status.profile && status.profile.preset === id ? "class=primary" : ""}>${id}<br><span class="stats">${label}</span></button>`
+  ).join("");
+  $("presets").querySelectorAll("button").forEach(btn => btn.onclick = async () => {
+    await api("/api/profile", {preset: btn.dataset.preset});
+    await refresh();
+  });
+  const current = $("provider").value;
+  $("provider").innerHTML = status.keys.filter(k => k.id !== "omniroute").map(k =>
+    `<option value="${k.id}">${k.label}${k.present ? " · presente" : ""}</option>`
+  ).join("");
+  if (current) $("provider").value = current;
+  if (document.activeElement !== $("card")) $("card").value = status.card || "";
+  const sid = $("session").value;
+  $("session").innerHTML = `<option value="">continua l'ultima</option>` + status.sessions.map(s =>
+    `<option value="${s.id}">${s.title}</option>`
+  ).join("");
+  if (sid) $("session").value = sid;
+  const proxy = status.proxy;
+  if (document.activeElement !== $("budget")) $("budget").value = proxy.budget_tokens;
+  if (document.activeElement !== $("verbatim")) $("verbatim").value = proxy.verbatim_turns;
+  const signature = proxy.upstreams.map(item => item.id + item.url).join("|");
+  if ($("upstream").dataset.sig !== signature) {
+    const chosen = $("upstream").value || proxy.upstream;
+    $("upstream").innerHTML = proxy.upstreams.map(item =>
+      `<option value="${item.id}" data-url="${item.url}">${item.label}</option>`
+    ).join("");
+    $("upstream").dataset.sig = signature;
+    $("upstream").value = chosen;
+  }
+  if (document.activeElement !== $("upstream")) $("upstream").value = proxy.upstream;
+  const selected = $("upstream").selectedOptions[0];
+  $("upstream-url").textContent = selected ? selected.dataset.url : "";
+  $("proxy-url").textContent = proxy.url;
+  $("proxy-line").textContent = proxy.last_line || "nessuna richiesta";
+  $("toggle-proxy").textContent = proxy.running ? "Ferma" : "Avvia";
+  $("toggle-proxy").dataset.running = proxy.running ? "1" : "0";
+}
+
+async function refresh() { render(await api("/api/status")); }
+
+$("save-key").onclick = async () => {
+  $("key-note").textContent = "";
+  try {
+    const out = await api("/api/keys", {provider: $("provider").value, key: $("secret").value});
+    $("secret").value = "";
+    $("key-note").textContent = "salvata in " + out.backend;
+    await refresh();
+  } catch (err) { $("key-note").textContent = err.message; }
+};
+
+$("save-card").onclick = async () => {
+  await api("/api/card", {text: $("card").value});
+  $("key-note").textContent = "";
+};
+
+function proxyBody() {
+  return {
+    budget: Number($("budget").value),
+    verbatim: Number($("verbatim").value),
+    upstream: $("upstream").value,
+  };
+}
+
+$("save-proxy").onclick = async () => {
+  $("proxy-note").textContent = "";
+  try {
+    await api("/api/proxy", Object.assign({action: "save"}, proxyBody()));
+    $("proxy-note").textContent = "salvato nel profilo";
+    await refresh();
+  } catch (err) { $("proxy-note").textContent = err.message; }
+};
+
+$("upstream").onchange = () => {
+  const selected = $("upstream").selectedOptions[0];
+  $("upstream-url").textContent = selected ? selected.dataset.url : "";
+};
+
+$("toggle-proxy").onclick = async () => {
+  $("proxy-note").textContent = "";
+  const action = $("toggle-proxy").dataset.running === "1" ? "stop" : "start";
+  $("toggle-proxy").disabled = true;
+  try {
+    await api("/api/proxy", Object.assign({action}, proxyBody()));
+    await refresh();
+  } catch (err) {
+    $("proxy-note").textContent = err.message;
+  } finally { $("toggle-proxy").disabled = false; }
+};
+
+$("chat").onsubmit = async (ev) => {
+  ev.preventDefault();
+  const message = $("message").value.trim();
+  if (!message) return;
+  $("send").disabled = true;
+  const log = $("log");
+  log.insertAdjacentHTML("beforeend", `<div class="bubble"><div class="who">tu</div>${escapeHtml(message)}</div>`);
+  $("message").value = "";
+  try {
+    const body = {message};
+    if ($("session").value) body.session = $("session").value;
+    const out = await api("/api/chat", body);
+    let html = "";
+    if (out.local_text) html += `<div class="stats">${escapeHtml(out.local_text)}</div>`;
+    html += `<div class="bubble"><div class="who">tramamind</div>${escapeHtml(out.text)}<div class="stats">${escapeHtml(out.stats)}</div></div>`;
+    log.insertAdjacentHTML("beforeend", html);
+    $("session").value = out.session;
+    await refresh();
+    $("session").value = out.session;
+  } catch (err) {
+    log.insertAdjacentHTML("beforeend", `<div class="fail">${escapeHtml(err.message)}</div>`);
+  } finally { $("send").disabled = false; }
+};
+
+function escapeHtml(text) {
+  return String(text).replace(/[&<>]/g, (c) => ({ "&":"&amp;", "<":"&lt;", ">":"&gt;" }[c]));
+}
+
+refresh().catch(err => { $("checks").textContent = err.message; });
+setInterval(() => { refresh().catch(() => {}); }, 3000);
+</script>
+</body>
+</html>

tramamind-0.5.0/cli/keys.py

@@ -0,0 +1,129 @@
+"""`tramamind keys` — le chiavi stanno nel keyring, in age o in .env locale."""
+from __future__ import annotations
+
+import getpass
+
+from router import keystore
+from router.providers import resolve_provider
+
+
+def _load_providers() -> list[str]:
+    from router.providers import provider_ids
+    return provider_ids()
+
+
+def _pick_backend(cli_choice: str | None) -> str:
+    if cli_choice:
+        return cli_choice
+    best = keystore.detect_best_backend()
+    labels = {
+        "keyring": "Keyring di sistema (consigliato su desktop)",
+        "age": "File cifrato age (consigliato su server/headless)",
+        "plain": ".env plain (solo sviluppo)",
+    }
+    print("\nSalvataggio:")
+    options = list(labels)
+    for i, b in enumerate(options, 1):
+        marker = " <- rilevato" if b == best else ""
+        print(f"  [{i}] {labels[b]}{marker}")
+    raw = input(f"Scelta [{options.index(best) + 1}]: ").strip()
+    if not raw:
+        return best
+    try:
+        return options[int(raw) - 1]
+    except (ValueError, IndexError):
+        print("Scelta non valida, uso il rilevamento automatico.")
+        return best
+
+
+def _ask_key(provider: str) -> str | None:
+    key = getpass.getpass(f"{provider}: ").strip()
+    if not key:
+        print(f"  {provider}: saltato")
+        return None
+    return key
+
+
+def cmd_add(provider: str | None, backend: str | None) -> int:
+    providers = _load_providers()
+    if not provider:
+        print("Provider disponibili:")
+        for i, p in enumerate(providers, 1):
+            print(f"  [{i}] {p}")
+        raw = input("Scelta: ").strip()
+        try:
+            provider = providers[int(raw) - 1]
+        except (ValueError, IndexError):
+            print("Scelta non valida.")
+            return 1
+    known = resolve_provider(provider)
+    if known is None and provider not in providers:
+        print(f"nota: '{provider}' non è nel catalogo — procedo comunque")
+    elif known is not None:
+        provider = known.id
+
+    key = _ask_key(provider)
+    if not key:
+        return 1
+    chosen = _pick_backend(backend)
+    keystore.store_key(provider, key, chosen)
+    print(f"OK: {provider} salvata ({chosen})")
+    return 0
+
+
+def cmd_setup(backend: str | None) -> int:
+    providers = _load_providers()
+    print("\nTramaMind - setup API key")
+    print("Incolla le chiavi (invio per saltare):\n")
+    collected = {}
+    for p in providers:
+        key = _ask_key(p)
+        if key:
+            collected[p] = key
+    if not collected:
+        print("\nNessuna chiave inserita.")
+        return 1
+    chosen = _pick_backend(backend)
+    for p, k in collected.items():
+        keystore.store_key(p, k, chosen)
+    print(f"\nOK: {len(collected)} chiavi salvate ({chosen})")
+    print("Per spingerle in OmniRoute, se lo usi: `tramamind sync`")
+    return 0
+
+
+def cmd_list() -> int:
+    providers = _load_providers()
+    print(f"\n{'Provider':<14}{'Stato':<12}{'Storage':<10}Chiave")
+    print("-" * 48)
+    missing = 0
+    for p in providers:
+        key, storage = keystore.get_key(p)
+        if key:
+            print(f"{p:<14}{'presente':<12}{storage or '?':<10}{keystore.mask(key)}")
+        else:
+            print(f"{p:<14}{'mancante':<12}{'-':<10}")
+            missing += 1
+    if missing:
+        print(f"\n{missing} provider senza chiave: `tramamind keys add <provider>`")
+    return 0
+
+
+def cmd_remove(provider: str) -> int:
+    removed = keystore.delete_key(provider)
+    if removed:
+        print(f"OK: {provider} rimossa da: {', '.join(removed)}")
+    else:
+        print(f"{provider}: nessuna chiave trovata")
+    return 0
+
+
+def run(args) -> int:
+    if args.keys_command == "add":
+        return cmd_add(args.provider, args.backend)
+    if args.keys_command == "setup":
+        return cmd_setup(args.backend)
+    if args.keys_command == "list":
+        return cmd_list()
+    if args.keys_command == "remove":
+        return cmd_remove(args.provider)
+    return 1