@envisiongroup/create-alakazam

CLI para generar un proyecto Mastra cliente sobre @envisiongroup/alakazam: agents hub con auth Entra ID, storage multi-dialecto, rutas de chat/catálogo/ adjuntos y observability ya cableadas vía createAgentsHub().

npm create @envisiongroup/alakazam mi-proyecto
# o
pnpm create @envisiongroup/alakazam mi-proyecto

Qué genera

Un proyecto Mastra mínimo pero funcional:

• weather-agent — agente mínimo de referencia: hubAgent() (catálogo + acceso), getAzureClient(), tool propia, scorers, Memory.
• azure-openai-sandbox-agent (opcional) — patrones avanzados listos para copiar: emisión de reasoning al cliente (emitReasoning), procesado de adjuntos (uploads), generación de archivos con code_interpreter y links de descarga (downloads).
• azure-claude-sandbox-agent (opcional) — provider alternativo: Claude vía Azure AI Foundry, adjuntos PDF/imágenes nativos, fail-closed de uploads Office.
• user-context-agent (opcional) — contexto del usuario autenticado: requestContextSchema, instrucciones dinámicas con la identidad y tools condicionales (sin Microsoft Graph: funciona out-of-the-box).
• Tool, workflow, scorers (prebuilt + LLM-judged), role-rules.ts y .env.sample documentado.

Flags

| Flag | Descripción | | ------------------------ | ----------------------------------------------------------------------------------------------------- | | --minimal | Solo la suite weather, sin los tres agents de ejemplo avanzados. | | --yes, -y | Acepta defaults sin preguntar (nombre mi-agents-hub si no se pasa uno). | | --dir <ruta> | Directorio destino (default: ./<nombre>). | | --alakazam-version <v> | Versión de @envisiongroup/alakazam a estampar. Default: última publicada en el registry (^x.y.z). |

Requisitos del proyecto generado

• Node >= 22.13.
• Token npm con acceso al scope @envisiongroup en ~/.npmrc (@envisiongroup/alakazam se publica con access: restricted).
• Rellenar .env (Azure OpenAI + App Registration de Entra ID) antes de pnpm dev.

Desarrollo de este paquete (monorepo Alakazam)

pnpm --filter @envisiongroup/create-alakazam test    # tests del scaffold
pnpm --filter @envisiongroup/create-alakazam smoke   # scaffold + install + typecheck real
pnpm sandbox:shell -- --verify                     # sandbox local con el tarball de alakazam (pre-publish)