MyBotBoxMyBotBox

@yarlisai Framework

El framework @yarlisai/* es un conjunto de paquetes npm que potencian MyBotBox. Cada paquete sigue el contrato puerto/adaptador para que los consumidores dependan de interfaces estables, no de SDKs de proveedores.

Estos paquetes se encuentran en packages/ en el monorepo público. mybotbox-platform en sí es el consumidor de referencia — consulta apps/sat/lib para ver cómo cada funcionalidad se conecta contra un puerto.

Qué está incluido

  • @yarlisai/core — Primitivos compartidos — helpers de entorno, logger, tipos de streaming, tipos de traza.
  • @yarlisai/ai — Puerto LLM unificado — OpenAI, Anthropic, Bedrock, Gemini y más de 12 adaptadores de proveedores.
  • @yarlisai/agents — Registro de manejadores de agentes — react, planner, reflection, research, evaluator y más.
  • @yarlisai/email — Envío y validación de correos electrónicos. Adaptadores Resend + SendGrid + Azure ACS.
  • @yarlisai/cache — Puerto CacheProvider + adaptadores de memoria + redis con TTL.
  • @yarlisai/queue — Puerto QueueProvider + adaptadores cloud-tasks + memoria.
  • @yarlisai/storage — Puerto StorageProvider + adaptadores GCS + S3 + memoria.
  • @yarlisai/security — Constructor de CSP, middleware de límite de tasa, RBAC, fetch seguro contra SSRF.
  • @yarlisai/billing — Puerto BillingProvider + adaptadores Stripe + Paddle.
  • @yarlisai/audit — Registro de auditoría — log de solo escritura a prueba de manipulaciones para eventos relevantes de seguridad.
  • @yarlisai/brand — Esquema multimarca (icon, logo, og, email, print) + CLI de sincronización.
  • @yarlisai/otel — Observabilidad con OpenTelemetry — adaptadores OTLP + Sentry + noop.
  • @yarlisai/sandbox — Sandbox de ejecución de código conectable — adaptadores worker-threads + memoria.
  • @yarlisai/triggers-core — Primitivos de disparadores genéricos — cadencia de sondeo, estado OAuth, cifrado de secretos.
  • @yarlisai/workflow-validation — Validadores DAG puros — verificaciones de referencia de bloques + topología.
  • @yarlisai/auth — Puerto de autenticación — adaptadores Firebase + JWT.
  • @yarlisai/secrets — Secretos conectables — adaptadores GCP Secret Manager + memoria con caché TTL.
  • @yarlisai/test-utils — Ejecutores de conformidad de puertos compartidos + adaptadores de grabación para pruebas.
  • @yarlisai/platform — Metapaquete — reexporta todos los paquetes del framework para una instalación en una línea.
  • @yarlisai/cli — Herramientas CLI para scaffolding + flujos de trabajo de desarrollo.
  • @yarlisai/cicd — Helpers de CI/CD — scaffolding de flujos de trabajo, puertas de despliegue, generadores de changelog.
  • @yarlisai/create-app — Bootstrap en un solo comando — bun x @yarlisai/create-app crea el andamiaje de un nuevo producto.

Por qué puerto/adaptador

  • Desarrollo más rápido — construye una vez, reutiliza en múltiples aplicaciones y productos
  • Consistencia — la UI compartida, auth, logging, clientes API y validación se comportan igual en todas partes
  • Menor mantenimiento — corrige un error una vez en el paquete en lugar de en cada consumidor
  • Escalabilidad — los nuevos productos se lanzan sobre la misma base
  • Calidad — los paquetes se publican con sus propias pruebas, versionado y CI/CD
  • Monetización — los paquetes internos pueden convertirse más adelante en herramientas open-source, SDKs o devtools de pago
  • Portabilidad de proveedores — los adaptadores aíslan la lógica específica de la nube/proveedor detrás de interfaces reutilizables