Skip to content

Commit d0b3541

Browse files
committed
fix(ia): ciclo cloud tool_call ronda 2 (role tool->user), sesion Zen fresca por request, MAX_TOKENS 4096, fallback free vivo, guard muse-spark /responses, model_used sin UNKNOWN, apiKey viva en send (getApiKeyFor), 8 tools abasto/trazabilidad + migracion 0018 (ordenes_compra, historial_costos con trigger, lotes, sucursales), allowlist sql_readonly extendida, prompts por rol, 19 tools en docs
- motor-chat/cloud/apis_cloud/helpers.rs: normalizar_mensajes mapea role tool a user con prefijo 'Resultado de <tool>:'; Zen /chat/completions rechaza tool suelto sin tool_calls con 400 Upstream (repro curl: tool->400, user->200). Test normalizar_convierte_tool_a_user_para_zen. - motor-chat/cloud/apis_cloud/proveedores.rs: nueva_sesion_zen() fresca por request (evita sticky-routing clavado anomalyco/opencode#46011), headers duales x-opencode-session + X-Session-Id + x-opencode-client, guard temprano es_solo_responses para muse-spark-* (/responses, daba 500). - motor-chat/cloud/variables.rs: MAX_TOKENS 39800->4096; ORDEN_FALLBACK_FREE con 6 free vivos verificados 2026-09-15 contra GET /models (fuera hy3-free, laguna-s-2.1-free). - motor-chat/cloud/apis_cloud/catalogo.rs: excluye muse-spark-* del listado chat. - motor-chat/cloud/apis_cloud/errores.rs: recorte 300->600 chars; generacion.rs: mensaje missing-key accionable. - backadmin/admintarvis/ciclo_tools.rs: resultado tool con nombre; rutas.rs: model_used defaultea al modelo pedido + flag modelo_confirmado (fix badge UNKNOWN). - llm/tools/{compras,operativa}.rs nuevos: query_suppliers, query_purchases, get_purchase_detail, query_purchase_orders, query_cost_history, query_expiring, list_branches, query_branch_stock (solo lectura, centavos->pesos, LIKE con escape). mod.rs dispatch + sql.rs TABLAS_PERMITIDAS +9. - prompts.rs: TOOLS_ABASTO (admin, 8) y TOOLS_ABASTO_EMPLEADO (4 operativas, sin montos/costos); TOOLS_LINEA intacta. - migrations/0018_abasto_trazabilidad.sql: ordenes_compra/items, compras.orden_id, historial_costos + trigger trg_historial_costos, lotes, sucursales/stock_sucursal. - frontend: ChatWidget.getApiKeyFor + useChatStream resuelve apiKey del cache vivo (fix snapshot stale con apiKey vacia -> 'Falta la API key'). - tests: 9 nuevos (db_abasto seed, filtros, errores legibles, trigger/CHECK verificados via sqlite); suite 57/57 src-ia, 147/147 vitest, tsc limpio. - docs: bugs Z2/Z3, ComoFunciona.md sec.10, conteo 10->19 tools.
1 parent 013610b commit d0b3541

27 files changed

Lines changed: 1058 additions & 51 deletions

File tree

‎ComoFunciona.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,3 +56,13 @@ En tu lista de días con extra, si el día de hoy todavía no tiene corte Z, en
5656

5757
* **Sin login no hay avance.** Si no has entrado hoy, la barra va en 0%. El reloj solo no es trabajo.
5858
* **La hora la pone tu computadora.** El POS cree lo que diga el reloj de Windows. Si la computadora está mal de hora, todo sale mal. Por eso la computadora de la tienda debe tener la hora automática activada.
59+
60+
---
61+
62+
## 10. Cómo piensa Y.A.R.V.I.S. (tu ayudante de la tienda)
63+
64+
Imagina que Y.A.R.V.I.S. es un ayudante con muy buena memoria y varios cuadernos: uno de ventas, uno de inventario, uno de proveedores y otro de caducidades. Cuando le preguntas algo, primero piensa si necesita abrir un cuaderno. Si sí, lo abre, copia el dato exacto y con eso te responde. Nunca inventa números: si el cuaderno está vacío, te lo dice.
65+
66+
Tiene dos formas de pensar. Una es llamar por teléfono a un amigo muy listo que vive lejos: para eso la tienda necesita una llave y tener internet. La otra es pensar solito dentro de la computadora de la tienda, sin internet, aunque es más lento y más sencillo.
67+
68+
Si el amigo de lejos no contesta, no se queda callado: piensa solito y te avisa con un letrerito amarillo de que la respuesta vino de la tienda. Y siempre te dice quién respondió, para que sepas a quién creerle.

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ Un sistema de punto de venta de escritorio para tiendas medianas y pequeñas, co
7070

7171
**Backend** — <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="4 17 10 11 4 5"/><line x1="12" y1="19" x2="20" y2="19"/></svg> Tauri 2.11 · sqlx 0.8 · Tokio · Serde · reqwest · Argon2 · chrono
7272

73-
**IA** — <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="4" y="4" width="16" height="16" rx="2"/><rect x="9" y="9" width="6" height="6"/><path d="M9 1v3M15 1v3M9 20v3M15 20v3M1 9h3M1 15h3M20 9h3M20 15h3"/></svg> `src-ia` (crate Rust): Qwen 3 1.7B GGUF vía llama.cpp (local) · OpenCode Zen / Gemini vía SSE (cloud) con relevo 429 · **10 tools de consulta** (ventas, inventario y navegación de catálogo, solo lectura)
73+
**IA** — <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="4" y="4" width="16" height="16" rx="2"/><rect x="9" y="9" width="6" height="6"/><path d="M9 1v3M15 1v3M9 20v3M15 20v3M1 9h3M1 15h3M20 9h3M20 15h3"/></svg> `src-ia` (crate Rust): Qwen 3 1.7B GGUF vía llama.cpp (local) · OpenCode Zen / Gemini vía SSE (cloud) con relevo 429 · **19 tools de consulta** (ventas, inventario, navegación de catálogo, abasto y trazabilidad, solo lectura)
7474

7575
**Datos** — <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M21 12c0 1.66-4 3-9 3s-9-1.34-9-3"/><path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"/></svg> SQLite (WAL) con un solo escritor (Rust) · `yarvis.db`
7676

‎docs/arquitectura/arquitectura.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Y.A.R.V.I.S.-POS/
5454
│ │ │ └── variables.rs # API keys (archivo plano 0600 via backend).
5555
│ │ └── llm/
5656
│ │ ├── mod.rs # Chat LOCAL Qwen2.5-Coder 1.5B Instruct via llama-cpp-4 (feature llm-local) + recortar_historial.
57-
│ │ └── tools/ # Ejecutor de 10 tools (ventas.rs, inventario.rs, deteccion, helpers).
57+
│ │ └── tools/ # Ejecutor de 19 tools (ventas.rs, inventario.rs, compras.rs, operativa.rs, deteccion, helpers).
5858
│ └── tests/ # estres.rs, fuzzing, masivo, verificar_modelos, etc.
5959
│
6060
└── yarvis-app/ # Aplicacion de Escritorio (Frontend React + Backend Rust).

‎docs/arquitectura/interconexion.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ No hay HTTP local. No hay puertos libres. No hay ai_service. No hay externalBin
4848
1. El usuario escribe en adminyarvis o empleayarvis.
4949
2. ChatWidget llama send_chat_stream o send_chat_message (Tauri command).
5050
3. admintarvis/chat.rs delega en src-ia/motor-chat:
51-
- Cloud: cloud/apis_cloud/generacion.rs abre un stream HTTP/SSE a OpenCode Zen o Gemini. Los bloques think/response se separan (think.rs). Si el proveedor devuelve 429, la cola de fallback releva al siguiente proveedor (espera 2-4 s, max 3 modelos). Las 10 tools se resuelven via ciclo_tools.rs con re-inyeccion del resultado como mensaje role tool (MAX_RONDAS_TOOLS=3).
51+
- Cloud: cloud/apis_cloud/generacion.rs abre un stream HTTP/SSE a OpenCode Zen o Gemini. Los bloques think/response se separan (think.rs). Si el proveedor devuelve 429, la cola de fallback releva al siguiente proveedor (espera 2-4 s, max 3 modelos). Las 19 tools se resuelven via ciclo_tools.rs con re-inyeccion del resultado como mensaje role tool (MAX_RONDAS_TOOLS=3).
5252
- Local: llm/mod.rs genera con Qwen GGUF (llama.cpp) en CPU, con recortar_historial para no exceder 4096 tokens. Usa el mismo ejecutor de tools que cloud.
5353
4. Roles: herramientas_rol.rs filtra TOOLS_SOLO_ADMIN (query_sales, compare_periods, get_restock_analysis) para empleados. El prompt es sugerencia; el guard es control de acceso real.
5454
5. La respuesta llega al frontend por el mismo mecanismo (invoke no bloquea la caja).

‎docs/arquitectura/que-es-yarvis.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Capacidades:
2929
- Cortes de caja X/Z, gastos recurrentes, alertas financieras, metricas y exportacion.
3030
- Empleados: metas/bonos, turnos, salario, resumen de ventas, asistencia y horas extra.
3131
- Parseo de tickets y catalogos (TXT/CSV/Excel) con reglas + LLM local para mapeo automatico y lotes con streaming.
32-
- Chat con IA: cloud (OpenCode Zen/Gemini) con fallback a local (Qwen2.5-Coder 1.5B Instruct fine-tuneado (unico modelo local)) y 10 tools de consulta.
32+
- Chat con IA: cloud (OpenCode Zen/Gemini) con fallback a local (Qwen2.5-Coder 1.5B Instruct fine-tuneado (unico modelo local)) y 19 tools de consulta.
3333
- Predicciones de ventas con Holt-Winters e intervalos de confianza al 95% (src-ia/predicciones).
3434

3535
Stack verificado:

‎docs/arquitectura/tecnologias.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Python eliminado. No hay sidecar, no hay yarvis-IA/, no hay ai_service.
5959

6060
> Chat local: Qwen2.5-Coder 1.5B Instruct GGUF via llama.cpp (src-ia/motor-chat/llm, CPU, ventana 4096, fine-tuneado con tools) tokens, recorte de historial conservador (src-ia/motor-chat/llm/mod.rs:42). Comandos send_chat_message, send_chat_stream, get_cloud_models, get_model_status, load_chat_model, unload_chat_model, stop_chat_stream (admintarvis/chat.rs).
6161
> Chat cloud: OpenCode Zen + Gemini con cola de fallback 429, streaming SSE, instrucciones de tools congeladas segun dataset tools_arreglado.jsonl (TOOLS_LINEA en src-ia/motor-chat/cloud/prompts.rs:28 y src-ia/motor-chat/llm/tools/).
62-
> Tools: 10 tools de solo lectura, SQL parametrizado con escape_like, LIMIT parametrizado, ejecutor compartido cloud/local (src-ia/motor-chat/llm/tools/mod.rs). Roles enforced en herramientas_rol.rs (empleado no ve finanzas/nomina).
62+
> Tools: 19 tools de solo lectura, SQL parametrizado con escape_like, LIMIT parametrizado, ejecutor compartido cloud/local (src-ia/motor-chat/llm/tools/mod.rs). Roles enforced en herramientas_rol.rs (empleado no ve finanzas/nomina).
6363
> Parseador: 100% Rust sin LLM (detección estadística + folio/clave/orden cronológico). Comandos parser_* (adminparser/, parser_txt/ por tema) + get_tickets_total para el historial real.
6464
> Predicciones: implementadas con Holt-Winters aditivo (src-ia/predicciones/holt_winters.rs:70 predecir, ventana 7 dias, grid 343 combos alpha/beta/gamma, banda 95% z 1.96). Capa de datos lee ventas completadas, agrupa por dia, densifica huecos con 0 y devuelve fecha/prediccion/minimo/maximo (src-ia/predicciones/ventas.rs:37).
6565
> Embeddings / RAG: no hay RAG. Pendiente busqueda semantica con modelo de embeddings propio. El plan anterior de all-MiniLM-L6-v2 + ort/fastembed fue descartado.

‎docs/historial/bugs-resueltos.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -627,3 +627,40 @@ APPIMAGE_EXTRACT_AND_RUN=1 npm run tauri build
627627
4. Test de regresión vitest `turno-extra.test.tsx` (7 casos).
628628

629629
**Leccion aprendida:** "reloj pasado de la salida" no es "trabajo extra": todo cálculo de extra debe anclarse a la llegada real, no a la hora actual. Y ojo con efectos cruzados: el stamp de salida del corte Z (#26) es correcto, pero cualquier consumidor de `ultimo_login` debe aplicar la misma regla o hereda el fantasma.
630+
631+
---
632+
633+
### Bug Z2: la ronda 2 de tools cloud moría con `400 Upstream request failed` — ALTO (RESUELTO 2026-09-15)
634+
635+
**Sintoma:** con `YARVIS_SIN_FALLBACK=1` el chat cloud fallaba siempre que el modelo pedía una tool: `Error 400 del proveedor (OpenCode). Detalle del servidor: Error from provider (Console): Upstream request failed: [400] Provider returned error`. Sin la variable, el fallo se enmascaraba cayendo a Qwen (y la UI mostraba `UNKNOWN` en el badge del modelo cuando el stream solo traía reasoning).
636+
637+
**Causa raiz (cuádruple, verificada con sondas directas contra `https://opencode.ai/zen/v1/chat/completions`):**
638+
1. `role:"tool"` suelto: `ciclo_tools.rs` reinyectaba el resultado como mensaje `role:"tool"` y `normalizar_mensajes` lo mandaba literal a Zen. El gateway OpenAI-compatible lo rechaza sin `tool_calls` previos. Repro: mismo historial con `tool` → 400; como `user` → 200 con respuesta correcta.
639+
2. `MAX_TOKENS = 39800` (variables.rs): techo de salida absurdo para los free; se bajó a 4096.
640+
3. Session id estable por proceso (`OnceLock`): el sticky-routing de Zen puede clavar un id en una réplica rota y fallar el 100% hasta reiniciar (ver sst/opencode#46011). Ahora es fresco por request y se mandan ambos headers (`x-opencode-session` oficial + `X-Session-Id` alias + `x-opencode-client`), como el CLI oficial.
641+
4. Cola de fallback con modelos muertos (`hy3-free`, `laguna-s-2.1-free` ya no existen en `GET /models`) y `muse-spark-*-contributor-free` listado aunque usa `/responses` (daba 500): se excluye del catálogo chat con error accionable.
642+
643+
**Solucion:**
644+
1. `helpers.rs::normalizar_mensajes` convierte `tool` → `user` con prefijo `Resultado de <tool>:` (el modelo local sigue recibiendo `role:"tool"` por llama.cpp, sin pasar por ahí); `ciclo_tools.rs` guarda el nombre en el contenido; `prompts.rs` documenta el formato.
645+
2. `variables.rs`: `MAX_TOKENS 4096`, `ORDEN_FALLBACK_FREE` con los 6 free vivos verificados el 2026-09-15.
646+
3. `proveedores.rs`: `nueva_sesion_zen()` por request + headers duales + guard temprano para modelos `/responses`.
647+
4. `rutas.rs`: `model_used` defaultea al modelo pedido (adiós badge `UNKNOWN`) y solo lo reemplaza el primer modelo real del stream; `errores.rs` recorta a 600 chars para no perder el detalle upstream.
648+
5. De paso: 8 tools nuevas de abasto/trazabilidad (`compras.rs`, `operativa.rs`, migración `0018_abasto_trazabilidad.sql` con trigger de historial de costos) + allowlist de `sql_readonly` extendida. Total: 19 tools.
649+
650+
**Verificación real:** ciclo completo contra Zen en vivo (ronda 1 → `<tool_call>query_sales today/revenue</tool_call>`, ronda 2 → `$300 MXN en ventas`); `cargo test -p src-ia --lib motor_chat` 57/57; `cargo check` Tauri limpio.
651+
652+
**Leccion aprendida:** "OpenAI-compatible" no significa "acepta cualquier rol": `tool` sin `tool_calls` es 400 garantizado aguas arriba. Y un session id estable es una trampa de sticky-routing: barato de generar, carísimo cuando se clava.
653+
654+
---
655+
656+
### Bug Z3: "Falta la API key" con la clave ya guardada — ALTO (RESUELTO 2026-09-15)
657+
658+
**Sintoma:** con la API key configurada y guardada en `Configurar modelos`, al enviar un mensaje el chat respondía `Falta la API key del proveedor.`
659+
660+
**Causa raiz:** `useChatStream.ts` resolvía `currentSelection = activeSession?.modelSelection || fallbackSelection`. Cada chat persiste un snapshot `{provider, apiKey, model}` en localStorage, y `ChatProvider` solo lo re-sincroniza cuando cambia `provider:modelo:label` (la key no forma parte de esa clave a propósito). Si la sesión nació antes de que `leerApiKeys()` resolviera (o antes de guardar la clave), el snapshot quedaba con `apiKey: ""` para siempre y cada envío mandaba la key vacía al backend.
661+
662+
**Solucion:** la sesión conserva provider/modelo/label, pero la key se resuelve SIEMPRE del caché vivo (`apiKeysCache`, alimentado del `api_keys.json` 0600) vía nuevo `getApiKeyFor(provider)` en `ChatWidget.tsx`. Los chats existentes se curan solos sin recrearlos. Además el error de backend ahora dice dónde ponerla (`...Agrégala en 'Configurar modelos'...`).
663+
664+
**Verificación real:** `tsc --noEmit` limpio, vitest frontend 147/147.
665+
666+
**Leccion aprendida:** un snapshot persistido nunca debe ser la fuente de un secreto rotativo: provider/modelo/label se congelan, la key se resuelve en vivo en el momento del envío.

‎docs/historial/implementacion.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ La idea original era un sidecar Python con FastAPI. Se descarto y se migro todo
2525
- Motor de IA en Rust: crate local src-ia (se enlaza por ruta desde yarvis-app/src-tauri/Cargo.toml con feature llm-local).
2626
- Arranque: binario unico. Sin python3 main.py, sin ai_service, sin externalBin.
2727
- Chat cloud: src-ia/motor-chat/cloud (OpenCode Zen / Gemini via reqwest + SSE) con fallback a local y ciclo de tools con 10 herramientas.
28-
- Chat local: Qwen2.5-Coder 1.5B Instruct GGUF fine-tuneado con llama-cpp-4 (src-ia/motor-chat/llm), carga bajo demanda (lazy), ventana 4096, recorte de historial conservador. Opera 100% offline con 10 tools SQL.
28+
- Chat local: Qwen2.5-Coder 1.5B Instruct GGUF fine-tuneado con llama-cpp-4 (src-ia/motor-chat/llm), carga bajo demanda (lazy), ventana 4096, recorte de historial conservador. Opera 100% offline con 19 tools SQL.
2929

3030
## Ola 3: El Parseador y la Ingesta Masiva — COMPLETADA (estadística sin IA)
3131

‎docs/historial/migracion-rust.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ Interino: vinculador_inventario/similitud.rs usa TF-IDF + fuzzy sin vectores.
6969

7070
## Fase 6 — Chat hibrido/local + cierre
7171

72-
1. Port del chat hibrido con modelo local (prompts, cache, motor_chat endpoints local) + 10 tools de solo lectura.
72+
1. Port del chat hibrido con modelo local (prompts, cache, motor_chat endpoints local) + 19 tools de solo lectura.
7373
2. /model_status, /load_model, /unload_model, /stop en Rust (manager de RAM con llama-cpp-4, unico modelo para parseo y chat).
7474
3. Retirar Python: cuando los endpoints pasen la suite de equivalencia:
7575
- Apagar sidecar (sidecar.rs), quitar yarvis-IA/ del repo.

‎docs/negocio/idea-comercial.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Busqueda experta: "que productos para el cabello no tienen sal?" -> "tienes el s
3434

3535
Contador conversacional: "cuanto gane libre hoy quitando el costo?" -> "tu utilidad neta hoy fue de 2,543 MXN, 15% mas que el promedio de los miercoles". Predicciones de inventario: "que deberia comprar para el fin de semana?" -> "viene frente frio, tus ventas de cafe y pan suben 30% historicamente, aumenta 15-20% el pedido de pan".
3636

37-
El chat usa 10 tools de solo lectura, SQL parametrizado y roles (admin ve finanzas/nomina, empleado solo mostrador). Estrategia: fine-tuning de Qwen + ejecutor de tools, sin RAG.
37+
El chat usa 19 tools de solo lectura, SQL parametrizado y roles (admin ve finanzas/nomina, empleado solo mostrador). Estrategia: fine-tuning de Qwen + ejecutor de tools, sin RAG.
3838

3939
## Parseador de Tickets de la Tienda
4040

0 commit comments

Comments
 (0)