Implementar un cliente de Agent Plugins

Un cliente conforme carga un Agent Plugin desde un directorio, valida plugin.json y admite al menos un tipo de componente: Agent Skills o servidores MCP.

Secuencia de carga

1. Determina la raíz del plugin resuelta por el sistema de archivos.
2. Localiza y valida el plugin.json de la raíz con el schema disponible localmente que seleccione $schema.
3. Rechaza el plugin si el manifiesto tiene infracciones fatales; informa de los casos expresamente no fatales y omítelos.
4. Descubre cada tipo de componente compatible en su ubicación fija.
5. Aplica el límite de fallo definido para cada tipo de componente o entrada.
6. Aplica los espacios de nombres de extensión de cliente implementados e ignora los demás.

Los clientes usan identificadores de schema canónicos para seleccionar reglas de validación e interpretación locales. No descargan schemas mientras cargan un plugin.

Comportamiento portátil y comportamiento del cliente

Agent Plugins define la estructura del paquete, la validación, el descubrimiento, la configuración MCP, las variables del plugin y el aislamiento de fallos. No prescribe:

• las fuentes de instalación, los registros ni los mercados
• la experiencia de activación, actualización o caché
• los avisos de permisos, la política de confianza ni el aislamiento
• la forma de mostrar Agent Skills a usuarios o modelos
• el comportamiento interno de las extensiones de cliente

Siguientes pasos

• Carga y descubrimiento: valida el manifiesto, descubre los componentes compatibles y aplica límites de fallo.
• Entorno de ejecución MCP: asigna la configuración MCP portátil a conexiones stdio y HTTP.
• Lista de conformidad: comprueba los requisitos mínimos para clientes portátiles.