Carga y descubrimiento

Establecer el límite del paquete

La raíz del plugin es una única ubicación del sistema de archivos. Después de resolver enlaces simbólicos, puntos de unión, puntos de reanálisis y mecanismos equivalentes, todos los archivos del paquete que el cliente descubra, lea o ejecute deben permanecer dentro de la raíz resuelta por el sistema de archivos.

Cargar primero el manifiesto

Los clientes buscan plugin.json en la raíz del plugin y lo cargan antes de descubrir componentes o aplicar comportamiento propio. El objeto JSON cerrado tiene dos campos obligatorios: $schema selecciona la versión de Agent Plugins y el contrato de validación, mientras que name identifica el plugin. Los demás campos permitidos aportan metadatos opcionales o datos de extensiones de cliente. Consulta la referencia del manifiesto para ver todos los campos.

Selecciona a partir de $schema las reglas de validación e interpretación disponibles localmente; no descargues un schema mientras cargas el plugin. Si falta $schema o no es compatible, el cliente rechaza el plugin.

Las dos infracciones siguientes del schema del manifiesto no son fatales:

• Informa de cada campo desconocido de nivel superior y omítelo. Continúa si el resto del manifiesto es válido.
• Informa de un campo extensions que no sea un objeto y omítelo. Después, continúa cargando componentes.

Cualquier otra infracción del schema del manifiesto provoca el rechazo del plugin completo.

Cuando extensions es un objeto, cada miembro pertenece al cliente identificado por su espacio de nombres de dominio inverso. Ignora los espacios de nombres que el cliente no implementa sin validar sus valores.

Descubrir componentes compatibles

Agent Plugins asigna una ubicación fija a cada tipo de componente:

La ausencia de una ubicación fija no es un error. Si la ubicación existe con un tipo incorrecto del sistema de archivos, marca como no válido solo ese tipo de componente y continúa con los demás tipos compatibles.

Si una Agent Skill descubierta no cumple la especificación de Agent Skills, omítela y continúa cargando las Agent Skills del mismo nivel. No busques otras Agent Skills de forma recursiva en descendientes anidados.

Un cliente ignora los tipos de componentes que no implementa. La falta de compatibilidad no constituye por sí misma un error del plugin; un cliente conforme implementa al menos uno de estos tipos: Agent Skills o servidores MCP. La forma de presentar una Agent Skill válida a usuarios o modelos queda bajo la política del cliente.

Límites de fallo de rutas

Aplica el límite específico pertinente:

1. Rechaza el plugin si plugin.json se resuelve fuera de la raíz del plugin.
2. Desactiva un tipo de componente cuando su ubicación fija tenga un tipo incorrecto del sistema de archivos o escape de la raíz.
3. Omite una Agent Skill cuando su SKILL.md escape de la raíz.
4. Omite una entrada MCP cuando una ruta configurada del paquete escape de la raíz permitida.
5. Deniega el acceso a otras rutas del paquete que escapen de la raíz.