defineAPI() una vez.think() y remember() integrados.Lógica de negocio y razonamiento AI en el mismo handler. HTTP, MCP, A2A y OpenAPI — generados automáticamente.
Una sola definición defineAPI() crea automáticamente: HTTP JSON API (Hono), MCP Tools (Claude Desktop), A2A Skills (Google Agent-to-Agent), OpenAPI 3.1 Spec.
import { defineAPI } from "@zauso-ai/capstan-core";
import { z } from "zod";
export const GET = defineAPI({
input: z.object({
status: z.enum(["open", "closed"]).optional(),
}),
output: z.object({
tickets: z.array(z.object({
id: z.string(),
title: z.string(),
status: z.string(),
})),
}),
description: "List support tickets",
capability: "read",
resource: "ticket",
async handler({ input }) {
return { tickets: await db.tickets.list(input) };
},
});Un defineAPI() expone HTTP, MCP, A2A y OpenAPI simultáneamente.
think(), generate(), bucle de agente con llamadas a herramientas. Paquete independiente @zauso-ai/capstan-ai.
remember/recall/about con alcance. Deduplicación automática, búsqueda híbrida.
React 18 renderToReadableStream, hidratación selectiva, Image/Font/Metadata.
JWT, OAuth, DPoP (RFC 9449), SPIFFE/mTLS, limitación de velocidad, CSRF.
Drizzle ORM, campos vectoriales, embeddings, búsqueda híbrida, 4 proveedores.
cacheSet/cacheGet con TTL, etiquetas, stale-while-revalidate.
defineCompliance con niveles de riesgo, registro de auditoría, flujos de aprobación.
| Característica | Capstan | Next.js | FastAPI |
|---|---|---|---|
| Multi-protocol (HTTP + MCP + A2A) | + | – | – |
| OpenAPI auto-generation | + | – | + |
| File-based routing | + | + | – |
| React SSR | + | + | – |
| Built-in auth (JWT + API keys) | + | – | ~ |
| Policy engine + approval workflow | + | – | – |
| AI TDD verifier | + | – | – |
| Built-in database layer | + | – | – |
| AI Agent Toolkit | + | – | – |
| Long-term Memory | + | – | – |
| LLM Integration | + | ~ | ~ |
| Cache / ISR | + | + | – |
+ integrado ~ parcial – no disponible | Comparación completa
bunx create-capstan-app my-appcd my-app && bunx capstan devTu app está activa con todos los endpoints de agentes listos:
# Agent manifest
curl http://localhost:3000/.well-known/capstan.json
# OpenAPI spec
curl http://localhost:3000/openapi.json
# MCP server (for Claude Desktop / Cursor)
bunx capstan mcp@zauso-ai/capstan-ai funciona independientemente del framework. Úsalo en cualquier proyecto TypeScript para interacción LLM estructurada y memoria persistente.
import { createAI } from "@zauso-ai/capstan-ai";
const ai = createAI({ llm: openaiProvider({ apiKey: "..." }) });
await ai.think("Analyze this data");
await ai.remember("User prefers dark mode");
const context = await ai.memory.about("customer", "c-42").recall("preferences");Instala Capstan, crea tu primer proyecto y comprende la estructura del proyecto.
Aprende sobre defineAPI, CapabilityRegistry, middleware y la arquitectura multi-protocolo.
Define modelos con campos tipados, configura relaciones y usa operaciones CRUD autogeneradas.
Referencia completa de todas las funciones, tipos y opciones de configuración del framework.