Plan de vinculación de sesión agnóstica al canal
Visión general
Este documento define el modelo de vinculación de sesión agnóstico al canal a largo plazo y el alcance concreto para la siguiente iteración de implementación.
Objetivo:
- Hacer que el enrutamiento de sesión vinculada a subagente sea una capacidad del core
- Mantener el comportamiento específico del canal en adaptadores
- Evitar regresiones en el comportamiento normal de Discord
Por qué existe esto
El comportamiento actual mezcla:
- Política de contenido de completado
- Política de enrutamiento de destino
- Detalles específicos de Discord
Esto causó casos extremos como:
- Entrega duplicada main y thread bajo ejecuciones concurrentes
- Uso obsoleto de token en managers de vinculación reutilizados
- Falta de contabilidad de actividad para envíos de webhook
Alcance de la iteración 1
Esta iteración es intencionalmente limitada.
1. Agregar interfaces core agnósticas al canal
2. Agregar un router de entrega core para completados de subagente
3. Mantener Discord como adaptador
4. Corregir problemas de corrección actualmente conocidos
5. Preservar valores por defecto de seguridad del runtime actual
No incluido en la iteración 1
Explícitamente diferido:
- Objetivos de vinculación ACP (
targetKind: "acp") - Nuevos adaptadores de canal más allá de Discord
- Reemplazo global de todas las rutas de entrega
- Cambios a nivel de protocolo
- Rediseño de migración/versionado de almacenamiento para toda la persistencia de vinculaciones
Invariantes de enrutamiento
Estos invariantes son obligatorios para la iteración 1.
- La selección de destino y la generación de contenido son pasos separados
- Si el completado en modo sesión se resuelve a un destino vinculado activo, la entrega debe apuntar a ese destino
- Sin redireccionamiento oculto desde destino vinculado al canal principal
- El comportamiento de fallback debe ser explícito y observable
Criterios de completado para la iteración 1
- Las interfaces core existen y están conectadas para enrutamiento de completado
- Las correcciones de arriba están fusionadas con tests
- Sin entrega duplicada de completado en main y thread en ejecuciones vinculadas en modo sesión
- Sin cambio de comportamiento para despliegues con spawn vinculado deshabilitado
- ACP permanece explícitamente diferido