Erstan Agent Tools Beta

Integración beta temporal de Erstan para agentes de codificación de IA. Este repositorio empaqueta un único plugin amplio que conecta a los usuarios beta con el entorno de QA aislado de Erstan y proporciona instrucciones específicas para crear, revisar y optimizar Agents y Skills, operar ejecuciones y trabajar con contenido autorizado del espacio de trabajo.

Entorno beta: Los datos y las autorizaciones OAuth de este plugin están separados de producción. Instala el plugin erstan de producción cuando tu espacio de trabajo se haya migrado. Este repositorio se retirará entonces.

El plugin no contiene ninguna clave de API de Erstan. Cada usuario inicia sesión en https://api-qa.erstan.com/v1/mcp con OAuth a través de su host de IA. La política de acceso beta del lado del servidor de Erstan sigue siendo el límite de acceso; la visibilidad del repositorio no concede acceso al producto.

Qué incluye

• erstan-agent-builder — crear, revisar, validar, probar y publicar grafos de Agent.

• erstan-agent-optimizer — recuperar un Agent existente y producir la propuesta de optimización correlacionada con la versión más pequeña.

• erstan-agent-review — revisar definiciones de Agent y diagnosticar ejecuciones a partir de evidencia duradera.

• erstan-run-operator — lanzar Agents publicados y gestionar de forma segura esperas, aprobaciones y trazas.

• erstan-skill-manager — gestionar paquetes de Skill de Erstan completos y versionados.

• erstan-skill-optimizer — recuperar un paquete de Skill completo del espacio de trabajo y optimizarlo sin perder reglas de negocio, archivos ni metadatos de acciones.

• erstan-work-manager — trabajar con tareas, proyectos, documentos, carpetas y archivos autorizados.

Las operaciones conceptuales agent:optimize y skill:optimize se distribuyen como los Skills $erstan-agent-optimizer y $erstan-skill-optimizer. No son comandos CLI de npm. Por defecto se detienen en una propuesta local respaldada por evidencia y un resultado de validación; las actualizaciones, las vistas previas de Agent en vivo y la publicación requieren cada una una autorización explícita separada.

Related MCP server: mcp-testing-tools

Modelo de permisos

Erstan es la fuente de verdad sobre lo que la conexión puede acceder. Los usuarios gestionan las aplicaciones conectadas, el ámbito del espacio de trabajo, las familias de herramientas permitidas, las listas de permitidos de proyectos o equipos y la política de aprobación del lado de Erstan en Settings > Connected apps.

La autorización inicial se establece por defecto en el perfil recomendado Build. Incluye View agents, Build agents, Run agents, Publish agents y los permisos de solo lectura View runs, View work, View documents y View files. No permite escrituras de tareas, documentos ni archivos. Usa Review para acceso de solo lectura. Para escrituras, usa Custom con el permiso aplicable Manage work, Edit documents o Edit files, o elige Full access.

Los usuarios gestionan y revocan la conexión en Settings > Connected apps. Reducir el acceso surte efecto directamente. Aumentar los permisos o cambiar a un perfil más amplio requiere una reautorización OAuth explícita para que un agente en segundo plano no pueda ampliar su propia concesión.

Claude, Codex, ChatGPT u otro host de MCP es el propietario de la sesión de conexión local y de sus propios controles de confirmación. Un host puede restringir el acceso o exigir una confirmación adicional, pero no puede conceder permisos que Erstan haya denegado. Revocar la conexión en Erstan la invalida para todas las sesiones de host que la utilicen.

Este modelo de dos capas mantiene los permisos comprensibles:

1. Erstan decide los datos y las acciones máximos autorizados.

2. El host de IA decide si invocar una acción dentro de ese límite.

Instalar en Codex

erstan-beta@erstan-beta significa nombre-del-plugin@nombre-del-marketplace; no es un ID de cuenta ni un secreto.

codex plugin marketplace add erstanai/erstan-agent-tools-beta
codex plugin add erstan-beta@erstan-beta

Abre una nueva sesión de Codex, usa /plugins para confirmar la instalación, conecta el servidor MCP erstan-beta cuando se te solicite y completa el inicio de sesión en el navegador. El plugin usa la configuración de servidor remoto en plugins/erstan-beta/.mcp.json.

Instalar en Claude Code

claude plugin marketplace add erstanai/erstan-agent-tools-beta
claude plugin install erstan-beta@erstan-beta

Ejecuta /reload-plugins y luego /mcp para conectar erstan-beta y completar OAuth. Claude Code inicia la autorización MCP remota; el plugin no pide al usuario que pegue un token de portador ni una clave de API.

Instalar en Claude Cowork / Desktop

Abre Customize > Plugins > Browse plugins, selecciona Add marketplace e introduce:

https://github.com/erstanai/erstan-agent-tools-beta

Instala Erstan Beta y completa el inicio de sesión en el navegador cuando se te solicite. Los plugins están disponibles en Claude Cowork y Claude Code, no en la superficie estándar de Claude Chat.

Actualizar o eliminar

Usa el navegador de plugins del host para actualizar, deshabilitar o desinstalar Erstan Beta. Eliminar el plugin local no revoca una concesión OAuth existente de Erstan. Revisa o revoca las concesiones en Settings > Connected apps en Erstan.

Las versiones publicadas y las sumas de verificación están disponibles en GitHub Releases.

ChatGPT y otros hosts

Este repositorio beta temporal no está enviado al directorio universal de plugins de ChatGPT y Codex. Intencionadamente no contiene .app.json: una asignación de aplicación de OpenAI debe usar un identificador real registrado plugin_asdk_app... o asdk_app_... asignado durante la publicación. Consulta Publishing para conocer el límite de distribución.

Otros clientes MCP pueden conectarse directamente a:

https://api-qa.erstan.com/v1/mcp

El servidor desplegado debe exponer descubrimiento y autorización OAuth conformes a los estándares. No hay alternativa de clave estática en esta distribución.

Verificar localmente

Requisitos: Node.js 20 o posterior, Python 3 y, opcionalmente, Claude Code para su validador nativo.

npm run verify
python C:/Users/<you>/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/erstan-beta
python C:/Users/<you>/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/erstan-beta/skills/erstan-agent-builder
claude plugin validate .

Ejecuta el validador de Skills una vez por cada directorio en plugins/erstan-beta/skills. CI ejecuta el verificador de versiones propiedad del repositorio; los validadores nativos de Codex, Skill y Claude siguen siendo puertas de versión obligatorias porque su disponibilidad y sus esquemas son propiedad de sus respectivos hosts.

Sincronizar desde producción

La distribución beta se deriva de un checkout de producción revisado con una transformación explícita de identidad y endpoint. Localmente, ejecuta:

npm run sync:production -- --source ../erstan-agent-tools

El comando copia los Skills y activos de producción, alinea los metadatos del plugin, mantiene la identidad distinta erstan-beta y reescribe el endpoint MCP alojado a https://api-qa.erstan.com/v1/mcp. El flujo de trabajo manual de GitHub Actions Sync production distribution realiza la misma transformación, valida el resultado y abre una solicitud de extracción para su revisión. No publica ni fusiona la versión beta. Pasa --version solo cuando se necesite un número de prelanzamiento posterior; la versión debe seguir siendo un prelanzamiento de la versión de producción.

Separación del toolkit

Este repositorio es la distribución pequeña e instalable para el usuario final. Las utilidades CLI de mantenimiento y los accesorios de diagnóstico sin conexión pertenecen al repositorio separado erstan-agent-toolkit y no deben copiarse en una versión de plugin.

Licencia

Apache License 2.0. Consulta LICENSE.