Documentación
Changelog

Changelog

Fox Framework sigue Semantic Versioning (opens in a new tab). El historial completo también está disponible en CHANGELOG.md (opens in a new tab) en el repositorio.

v1.4.4 — 2026-05-02

Lanzamiento unificado del roadmap v1.4.x: fixes críticos, docs completos, CLI como workspace separado y 5 example apps con infra Docker.

  • v1.4.1 — Fixes críticos de documentación, scripts y configuración de runtime (ver detalle abajo)
  • v1.4.2 — Docs completos: agent tools, SSE streaming, telemetría/OTel, vector store providers, changelog
  • v1.4.3 — CLI extraído a @foxframework/cli; express/axios → peerDeps en core; migration guide
  • v1.4.4 — 5 example apps (basic-api, rest-api, agent-chat, event-sourcing, fullstack) con Docker Compose y script --infrastructure unificado

v1.4.1 — 2026-05-02 (patch)

Fixes críticos de documentación, scripts y configuración de runtime.

  • Fix todos los imports from '@foxframework/core' → from '@foxframework/core' en event-system.mdx
  • Fix auth-jwt.mdx handler verifyEmail para usar JWT decode real vía AuthMiddleware.verifyToken
  • Corregir paths de scripts ai:test y test:unit en package.json
  • Subir engines.node a >=18.0.0; añadir .nvmrc con Node 18
  • Reescribir snippets en examples/index.mdx con APIs reales de express + @foxframework/core
  • Añadir clase OrderRepository faltante en database.mdx
  • Cambiar puerto NotificationService de 3003 → 3004 en microservices.mdx
  • Actualizar imagen Docker consul:latest → hashicorp/consul:1.19

v1.4.0 — 2026-05-01

Nuevas features

Agent Tools Library

  • CalculatorTool — evaluador matemático seguro (sin eval)
  • HttpTool — HTTP requests con fetch nativo (GET/POST/PUT/PATCH/DELETE)
  • FilesystemTool / createFilesystemTool — leer/escribir/listar/borrar archivos con sandbox opcional
  • JsonPathTool — navegación de JSON con path expressions (get, keys, count, flatten, pretty)
  • createSqlQueryTool — ejecuta SQL vía cualquier IQueryExecutor; modo read-only por defecto
  • createVectorSearchTool — búsqueda semántica vía cualquier IVectorSearchProvider
  • 44 tests

Vector Store Providers

  • @foxframework/vector-pinecone — Pinecone REST API (fetch nativo)
  • @foxframework/vector-weaviate — Weaviate GraphQL API (fetch nativo)
  • @foxframework/vector-chroma — ChromaDB REST API (fetch nativo)
  • Todos implementan IVectorSearchProvider con search, upsert, delete
  • 34 tests (34 = 3 × ~11 por package)

Agent Streaming SSE

  • SseStream — writer SSE de bajo nivel compatible con cualquier ServerResponse
  • AgentSseEmitter — ejecuta un agente y emite cada step como evento SSE
  • createAgentSseHandler — factory de route handler para Express/Fox
  • Eventos: step, done, error, heartbeat
  • 21 tests

Agent Observability

  • AgentTracer — proxy vendor-neutral que añade spans por run y por tool call
  • ITracer / ISpan interfaces — implementables con cualquier backend
  • NoOpTracer / NoOpSpan — zero overhead por defecto
  • @foxframework/otel-agents — adapter OtelAgentTracer para @opentelemetry/api
  • 25 tests

v1.3.0 — 2026-05-01

Esta es la release más grande hasta la fecha. Introduce el sistema completo de Agentes AI, tres model providers nativos (OpenAI, Anthropic, Ollama), y adapters serverless para AWS Lambda, Vercel y GCP.

Nuevas features

Sistema de Agentes AI

  • ReActAgent — loop Thought → Action → Observation con tool dispatch y memoria
  • Orchestrator — planificador multi-agente con wave execution y control de concurrencia
  • BaseAgent — base abstracta con AbortController, status tracking y tool registry
  • InMemoryStore — memoria de agente con búsqueda por palabras clave
  • Integraciones: AgentEventBus, AuthenticatedAgent, CachedAgent, AgentMetrics
  • 53 tests (22 core + 31 integraciones)

Model Providers (zero vendor SDKs)

  • @foxframework/model-openai — completions, tool calls, streaming SSE (9 tests)
  • @foxframework/model-anthropic — messages, tool_use blocks, streaming SSE (8 tests)
  • @foxframework/model-ollama — ndjson streaming, keep_alive (10 tests)

Serverless Adapters

  • @foxframework/serverless — LambdaAdapter, VercelAdapter, GcpAdapter
  • coldStartMiddleware con callbacks onColdStart()
  • 19 tests

Event System (Epic A)

  • CQRS: CommandBus, QueryBus con typed errors
  • Event Sourcing: AggregateRoot, InMemoryEventSourcingRepository (auto-snapshots), ProjectionManager, SagaManager
  • Adapters: SseAdapter (zero-dep), RedisEventAdapter (ioredis lazy peer dep)
  • Middleware: EventLoggingMiddleware, EventMetricsMiddleware (latencia real, rolling RPS)
  • 46 tests

v1.2.0 — 2026-04-15

Nuevas features

  • Auth Ecosystem — 6 packages: @foxframework/auth-{jwt,2fa,oauth,cognito,firebase,ldap} (112 tests)
  • Core auth interfaces: IAuthProvider, ITokenValidator, middleware createAuthMiddleware, requireRoles, requirePermissions
  • Database Ecosystem — 8 packages: @foxframework/db-{postgres,mysql,sqlite,mongo,redis,rds,documentdb,dynamodb}
  • CI/CD automatizado con npm publish en GitHub Release

v1.1.0 — 2026-03-01

  • Estabilización del core
  • Integración Express
  • Template engine (Handlebars)
  • CLI tools (tsfox binary)
  • Plugin system, logging, monitoring
  • Docker integration

v1.0.0 — 2026-01-01

  • Release inicial de Fox Framework
  • Sistema de rutas modular
  • Pipeline de middleware
  • Diseño TypeScript-first
  • Arquitectura Factory pattern
  • CLI scaffolding básico

Roadmap

v1.5.0 — Planificado

  • Workflow Engine — Workflows duraderos con checkpoint/resume
  • @foxframework/mcp — Servidor/cliente Model Context Protocol
  • GraphQL Layer — Generación de schema desde controllers Fox
  • WebSocket Support — Canales WebSocket junto a rutas HTTP

v2.0.0 — Futuro

  • Edge Runtime — Cloudflare Workers / Deno Deploy
  • Database Migrations — Runner integrado con db-* packages
  • Schema Validation — Zod/Valibot en el request pipeline
  • Fox Studio — Herramienta visual para orquestación de agentes
TestingPreguntas Frecuentes