Fuerza de trabajo de agentes de IA liderada por un CEO. Inteligencia operativa con memoria neuronal, agentes especialistas y ejecución con aprobación humana. Lenguaje natural. Autonomía controlada. Orientado a rentabilidad.
MSL es una empresa agente: una jerarquía de agentes de IA que investigan, colaboran, aprenden y proponen acciones de negocio. El CEO humano mantiene el control de cada decisión comercial a través de aprobaciones en Telegram ("dale").
MSL no es un bot de MercadoLibre. MercadoLibre es el primer canal operativo, no el límite del producto. La arquitectura está diseñada para expandirse a ecommerce propio, redes sociales, otros marketplaces y operaciones de proveedores.
Contexto de negocio: Plasticov y Maustian son cuentas independientes de MercadoLibre Chile operadas como canales comerciales paralelos con precios, tipos de publicación y estrategias independientes. MSL las gestiona como activos comerciales separados con memoria, aprendizaje y ejecución por cuenta.
MSL combina razonamiento (DeepSeek), memoria (Cortex, grafo neuronal en SQLite) y colaboración entre agentes (Agent Message Bus + evidencia entre pares). Cada mutación de negocio requiere aprobación explícita del CEO.
Verificado contra el commit 413248c en main:
| Componente | Estado |
|---|---|
| Agent Message Bus | Cola asíncrona SQLite, claim/resolve/fail, deduplicación |
| 14 daemon handlers | Ciclos de 15 minutos, solo lectura, proponen al CEO |
| 15 lane contracts | Contratos tipados con prefijos estables para caché |
| Evidence Response Router | 5 responders que responden solicitudes de evidencia |
| Work Sessions | Sesiones persistentes con cooldown para 6 lanes |
| Account Assets + Account Brain | Tracking estratégico por cuenta, scoring, comparación |
| Cortex | Grafo neuronal con aprendizaje hebbiano y poda darwiniana |
| DeepSeek | Cliente real, bloques de caché, requiere DEEPSEEK_API_KEY |
| Operational Read Model | Snapshots SQLite de 8 tipos de entidad |
| Supplier Mirror | Evidencia de proveedores local-first, dry-run Jinpeng |
| Owned Ecommerce | Write boundary Medusa (fail-closed), env-gated |
| Creative Studio | MiniMax imagen/video, env-gated |
| Telegram Bot | Runtime grammY, CEO-only, multi-seller |
| MCP Server | ~40 herramientas para clientes MCP |
| Aprobación "dale" | Pipeline prepare → approve → execute → audit |
| Background Ingestion | 5 procesadores con paginación por checkpoint |
- Credenciales reales de ML OAuth: sin
MERCADOLIBRE_CLIENT_ID/MERCADOLIBRE_CLIENT_SECRET, la ingesta y las herramientas de ML operan en modo stub. - Ingesta real: los procesadores existen pero requieren credenciales reales para funcionar con datos de producción.
- Ecommerce productivo: el write boundary de Medusa está implementado pero no activo sin credenciales y aprobación.
- Canales sociales: no implementados.
- Expansión a otros marketplaces: no implementada.
CEO Humano
└─ CEO Agent (DeepSeek)
├─ Director Financiero y Rentabilidad
├─ Director de Portafolio
├─ Director de Inventario, Compras e Importaciones
├─ Director de Crecimiento Social
└─ Director de Expansión
└─ Especialistas (pricing, ads, contenido, postventa...)
Los especialistas investigan y colaboran entre ellos. Los gerentes consolidan evidencia. El CEO Agent presenta solo las decisiones de negocio al CEO humano. Los workers, managers y especialistas son recursos internos de orquestación — el CEO nunca interactúa directamente con ellos.
Especialista detecta oportunidad
→ Solicita evidencia a otros agentes (EvidenceResponseRouter + 5 responders)
→ Gerente consolida evidencia en propuesta
→ CEO Agent presenta la decisión de negocio en Telegram
→ CEO humano aprueba ("dale"), rechaza o redirige
→ Cortex registra el outcome + feedback darwiniano
El CEO no es interrumpido para recolección de evidencia. Solo para decisiones con utilidad de negocio significativa.
Telegram / Web Console
│
▼
@msl/agent (DeepSeek v4)
Agent Loop · Guardrails · 14 Daemons · Evidence Router
│
┌────┼────────────┬──────────────┐
▼ ▼ ▼ ▼
@msl/memory @msl/mercadolibre @msl/creative-studio
Cortex (SQLite) ML API (OAuth) MiniMax (imagen/video)
Op Read Model Sync Engine Policy Engine
│ │ │
└────────────┼──────────────┘
▼
@msl/domain (núcleo hexagonal puro — sin I/O)
@msl/bot · @msl/mcp · @msl/workers · @msl/tools · @msl/ecommerce-medusa
Toda mutación de negocio requiere aprobación explícita del CEO:
- El agente prepara una propuesta (sin ejecutar nada)
- La propuesta pasa por verificación automática (6 checks)
- Si es de alto riesgo, pasa por consenso multi-agente
- El CEO ve la propuesta en Telegram y responde "dale" para ejecutar
- La ejecución registra auditoría completa
- Cortex recibe feedback darwiniano según el outcome
Nada se publica, modifica, cancela o gasta sin un "dale" explícito. Las herramientas de ML en el MCP server son read-only hasta que haya credenciales reales y aprobación.
| Package | Rol |
|---|---|
@msl/agent |
CEO agent loop, DeepSeek, 14 daemons, evidence router, work sessions, account brain |
@msl/memory |
Cortex neural graph, operational read model, evidence request store, supplier mirror |
@msl/mercadolibre |
ML API client (OAuth), sync engine, supplier source adapters |
@msl/creative-studio |
MiniMax image/video generation, policy engine, cost controls |
@msl/workers |
Background ingestion, creative sync, supplier mirror scheduler |
@msl/ecommerce-medusa |
Medusa write boundary, storefront projections, preview adapter |
@msl/bot |
Telegram bot (grammY), CEO-only, multi-seller |
@msl/mcp |
MCP server — ~40 tools |
@msl/tools |
Approval queue, audit trail, risk gates, execution |
@msl/domain |
Pure TypeScript hexagonal core — no I/O, no DB |
apps/web |
Next.js 15 + React 19 web console |
git clone https://github.com/riquelmechile/Msl.git
cd Msl
cp .env.example .env.local # editar con tus claves
npm install
npm test
npm run dev # http://127.0.0.1:3000Seguro por defecto. El chat y el bot de Telegram usan comportamiento local/mock hasta que configures variables de entorno. Cada mutación requiere aprobación explícita del CEO.
Ver .env.example para la referencia completa. Grupos principales:
| Grupo | Requerido para |
|---|---|
DEEPSEEK_API_KEY |
Respuestas reales del LLM |
BOT_TOKEN |
Bot de Telegram |
MINIMAX_API_KEY |
Creative Studio (imagen/video) |
| MercadoLibre OAuth | Acceso a API de ML (listings, órdenes, claims) |
| Supplier Mirror | Bootstrap de Jinpeng, evidencia de proveedores |
MSL_ENCRYPTION_KEY |
Cifrado de tokens OAuth |
npm run typecheck # TypeScript strict
npm run lint # ESLint
npm run format:check # Prettier
npm test # Vitest (unitarios + integración)
npm run test:e2e # Playwright E2E
npm run build # Build completo del workspace| Componente | Estado |
|---|---|
| Agent Loop + DeepSeek | ✅ Listo (requiere DEEPSEEK_API_KEY) |
| Agent Message Bus | ✅ Listo (SQLite) |
| 14 Daemon Handlers | ✅ Listo (15-min cycles) |
| Evidence Responses | ✅ Listo (5 responders) |
| Work Sessions | ✅ Listo |
| Cortex | ✅ Listo (SQLite) |
| Operational Read Model | ✅ Listo (8 entity kinds) |
| Telegram Bot | ✅ Runtime listo (requiere BOT_TOKEN) |
| MCP Server | ✅ Runtime listo (~40 tools) |
| Supplier Mirror | ✅ Foundation listo (workers disabled by default) |
| Owned Ecommerce | ✅ Runtime listo (env-gated) |
| Creative Studio | ✅ Runtime listo (env-gated) |
| ML OAuth | ❌ Sin credenciales reales (modo stub) |
| Ingesta real | ❌ Requiere P0 (credenciales ML) |
| Ecommerce productivo | ❌ Requiere credenciales Medusa + aprobación |
| Canales sociales | 🔲 No implementado |
| Expansión multicanal | 🔲 No implementado |
| Prioridad | Fase | Estado |
|---|---|---|
| P0 | Operational Truth & Production | Pendiente |
| P1 | Financial Truth & Economic Outcomes | Pendiente |
| P2 | Full Product Launch Cycle | Pendiente |
| P3 | Social Growth | Pendiente |
| P4 | Portfolio, Pricing, Inventory | Pendiente |
| P5 | Experimentation & Org Intelligence | Pendiente |
| P6 | Multichannel Expansion | Pendiente |
Ver ROADMAP.md para el detalle completo con capacidades, dependencias, criterios de aceptación y riesgos de cada fase.
| Documento | Tipo | Contenido |
|---|---|---|
docs/agent-enterprise-vision.md |
Canónico | Visión de producto estable |
ARCHITECTURE.md |
Arquitectura actual | Arquitectura implementada en HEAD |
ROADMAP.md |
Roadmap | Capacidades pendientes y prioridades |
docs/PHILOSOPHY.md |
Filosofía | Principios de ingeniería |
docs/vps-deployment.md |
Operación | Guía de deploy en VPS |
docs/production-secrets-setup.md |
Operación | Configuración de secretos de producción |
docs/creative-studio-minimax-integration.md |
Diseño | Integración MiniMax |
docs/supplier-to-owned-ecommerce-cortex-bridge.md |
Diseño | Puente Supplier → Ecommerce |
docs/supplier-mirror.md |
Diseño | Supplier Mirror |
docs/architecture/ |
Diseño especializado | Documentos de arquitectura por componente |
docs/audits/ |
Auditoría | Auditorías de arquitectura y runtime |
docs/propuesta-ceo-socio.md |
Histórico | Propuesta inicial (material superado) |
openspec/specs/ |
Contratos vigentes | Especificaciones activas (SDD) |
openspec/changes/archive/ |
Histórico | Cambios completados (evidencia, no estado actual) |
MIT. Construido en Chile 🇨🇱.