# Teddy

> Teddy publica en un enlace propio lo que prepara tu IA: apuntes de clase, tests para repasar, tarjetas de estudio, documentación de proyectos o actas de reunión. Gratis.

## Conectar
- Servidor MCP: https://teddyagent.app/mcp (conector personalizado; inicias sesión en Teddy y das permiso, sin clave).
- API REST: https://teddyagent.app/docs (clave en https://teddyagent.app/app/keys).

## Cómo trabajar con Teddy (para agentes)
1. Antes de crear una página, llama a list_templates y, si encaja, a get_template: devuelve un HTML con la estructura y el estilo recomendados. Conserva la estructura y sustituye solo el contenido (en los tests y las tarjetas, el bloque de datos JS del principio).
2. Publica con publish_artifact. Pasa folder con el nombre de la asignatura, el proyecto o el equipo (por ejemplo "Cálculo II"): la carpeta se crea si no existe. Una carpeta por asignatura mantiene ordenadas las clases. Cuando una carpeta tenga varias páginas, POST /api/folders/{id}/index crea (o actualiza) la página «Índice · carpeta» con enlaces a todas.
3. Pon un título que se entienda en la lista: "Cálculo II · Clase 12 · Integración por partes".
4. Material personal de estudio: usa visibility="private" y comparte después con create_share_link si hace falta.
5. Para corregir o ampliar una página existente usa update_artifact con su id, no publiques otra: la URL no cambia y se guarda el historial.
6. Las páginas son HTML estático autocontenido, sin formularios de contraseña. Los tests, las tarjetas y el plan funcionan con JavaScript en la propia página (cambia solo los bloques de datos QUIZ, TARJETAS y PLAN); apuntes, guía y acta se editan directamente en el HTML. Si necesitas lógica de servidor, Teddy también publica funciones (publish_function).

7. Si la página necesita guardar datos (reservas, respuestas, un contador, estado compartido), crea una colección con create_collection y llama a su API https://teddyagent.app/d/<id> con fetch desde la propia página (CORS abierto). Pon la escritura en public solo si cualquiera debe poder escribir; en otro caso key u owner.

8. Si varias páginas deben verse en directo (chat, marcador, aviso, panel que se actualiza solo), crea un canal con create_channel y úsalo con EventSource (escuchar) y fetch POST (publicar) sobre https://teddyagent.app/c/<id>; para ver cambios de una colección sin sondear, escucha https://teddyagent.app/d/<id>/_events. Los mensajes no se guardan: si importan, guárdalos también en una colección.

9. Si la página debe saber quién es el visitante (portal de clientes, pedidos, presupuestos, área privada), añade <script src="https://teddyagent.app/sdk/teddy.js"></script> y usa Teddy.login(), Teddy.user (email, nombre) y Teddy.fetch(url) para llamar a una función publicada con access="user": la función recibe x-teddy-user-email (con encodeURIComponent) de confianza. El botón de Google no se puede insertar en la página (entorno aislado): Teddy.login() abre el login de Teddy. Guarda los datos de cada cliente en una colección privada (owner) y filtra por su email dentro de la función.

## Casos de uso
- Estudiante: a partir de la transcripción de una clase, apuntes del día; después un test autocorregido y tarjetas, en la carpeta de la asignatura.
- Programador: guía de onboarding de un repositorio, resumen de un PR o changelog.
- Equipo: acta de reunión con tareas, informe o resumen semanal.

## Plantillas
- apuntes-clase (Estudiantes): Resumen limpio de la clase del día con conceptos, fórmulas, ejemplo resuelto y preguntas para repasar.
- test-autocorregido (Estudiantes): Preguntas tipo test con corrección al instante, explicación de cada respuesta y lista de lo que repasar.
- tarjetas-estudio (Estudiantes): Tarjetas con pregunta y respuesta para memorizar: girar, avanzar y mezclar.
- plan-estudio (Estudiantes): Calendario por días con tareas que se marcan y una barra de progreso (el avance dura mientras la página está abierta).
- guia-proyecto (Programadores): Cómo arrancar un repositorio, su arquitectura y por dónde empezar según la tarea.
- acta-reunion (Equipos): Decisiones, tareas con responsable y fecha, y temas abiertos, listo para enviar.