Tetrees AI

Posee, haz crecer y comercializa inteligencia de agentes portátil mediante TAIP/1 Packs y MCP.

GitHub
314
Prueba este MCPPatrocinado

Documentación

Tetrees Agent EX

Kit de integración pública para usar, hacer crecer, comprar y publicar Tetrees AI Packs a través del MCP y la API alojados de Tetrees Agent.

Tetrees Agent selecting useful intelligence from a holographic shelf

Explorar Tetrees AI Packs  ·  Conectar a través de MCP  ·  Publicar un AI Pack

Este repositorio es el producto público @tetrees/mcp (ai.tetrees/mcp): el servidor MCP stdio, clientes, ejemplos de configuración y muestras de extensión seguras. No contiene internos de Tetrees Agent, inteligencia privada de Packs, puntuación Agent AVCP, prompts de servicio, almacenamiento, moderación o infraestructura de intercambio.

Qué puedes construir

RutaUsa este kit para
Comprador / operadorBuscar Packs, inspeccionar el informe público Agent AVCP, cotizar una ejecución, probar un Pack con Tetrees Points, adquirir un Pack gratuito y descargar una versión .taip de tu propiedad.
ConstructorConectar un Pack auditado a una API HTTPS propiedad del usuario, un servidor MCP anidado o una habilidad local sin shell, manteniendo las credenciales locales.
VendedorCrear un listado, subir una versión inmutable .taip e imágenes, inspeccionar la preparación, ejecutar Agent AVCP, leer comentarios privados de reparación y publicar una versión que pase la validación.

El trabajo alojado por Tetrees no necesita GPU local. Las ejecuciones financiadas por modelos se cotizan en Tetrees Points antes de ejecutarse; un Pack de tu propiedad también puede usar una clave de proveedor compatible suministrada al proceso MCP local.

Inicio rápido: MCP alojado

Requisitos: Node.js 20+ y un token de API revocable desde Tetrees Account.

Añade esto a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "tetrees-ai": {
      "command": "npx",
      "args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.1"],
      "env": {
        "TETREES_API_URL": "https://ex.tetrees.ai/api",
        "TETREES_TOKEN": "<revocable-account-token>"
      }
    }
  }
}

Reinicia el cliente MCP y luego pídele que:

Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.

No pongas claves de proveedor en un Pack, prompt, archivo fuente o configuración MCP compartida. Las claves BYOK opcionales pertenecen solo al entorno del proceso MCP local. Consulta examples/mcp/mcp-config.jsonc.

Inspecciona el contrato MCP

npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect

El inspector lanza el paquete MCP alojado oficial, lista sus herramientas y recursos públicos, verifica la superficie esperada de comprador/constructor/vendedor y sale sin gastar Points ni cambiar el estado de la cuenta.

El sufijo v=2.2.1 es intencional: evita que npx reutilice un tarball MCP más antiguo almacenado en caché bajo la misma URL. Cámbialo solo cuando Tetrees publique un contrato MCP más nuevo. La identidad npm para el mismo paquete es @tetrees/mcp@2.2.1.

CLI de API pública

Copia los valores de .env.example en tu shell; este proyecto deliberadamente no carga archivos secretos automáticamente.

export TETREES_TOKEN="txk_..."

# Read-only calls
npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>

# Quote first. This never starts a model request.
npm run tetrees -- quote <pack-id> <model-id>

# A Point-spending run needs the exact confirmation flag.
npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend

La CLI redacta campos de respuesta con forma de secreto e informa códigos de error de Tetrees, estado HTTP y Retry-After. No reintenta una mutación automáticamente.

Flujo del comprador

  1. Busca un Pack.
  2. Inspecciona su informe público Agent AVCP y perfil de ejecución.
  3. Cotiza el modelo exacto, el límite de tokens, las habilidades alojadas y el punto de control de crecimiento.
  4. Ejecuta una vista previa stateless financiada con Points. Los Points reservados no utilizados se devuelven.
  5. Adquiere un Pack gratuito o compra un Pack de pago en Tetrees EX.
  6. La propiedad desbloquea descarga, BYOK, crecimiento guardado y extensiones de cliente.

Ejecuta el ejemplo de solo lectura documentado:

node examples/buyer/discover-and-quote.mjs "incident response"

Flujo del constructor: añade capacidades sin dárselas a Tetrees

Un Pack publicado puede declarar extensiones de cliente que pasaron Agent AVCP. El enlace real y las credenciales permanecen en la máquina del usuario.

Patrones de enlace compatibles:

  • https_api: URL HTTPS base fija, métodos declarados, cabeceras respaldadas por entorno.
  • mcp: un servidor MCP anidado iniciado sin shell y mapeado a nombres de herramientas declarados.
  • local_skill: un proceso hijo sin shell que recibe una solicitud JSON y devuelve un resultado JSON.

Comienza con:

El alojamiento de Tetrees nunca hereda estos permisos locales. Un método de escritura necesita la frase exacta por llamada APPROVE extensionId.methodId.

Flujo del vendedor

La ruta de publicación compatible es intencionalmente impulsada por contrato:

# Read-only readiness/report inspection
node examples/seller/check-readiness.mjs <pack-id>

# Upload one higher immutable version. Requires explicit confirmation.
node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload

Luego usa las herramientas MCP alojadas o la referencia de API de Tetrees para enviar, cotizar Agent AVCP, ejecutarlo después de confirmar la cantidad exacta de Points, inspeccionar el informe privado y publicar solo el digest que pase.

Consulta docs/SELLER_GUIDE.md y examples/seller/pack-listing.example.json.

Referencias públicas estables

Seguridad y límite del producto

Este repositorio no contiene:

  • Implementación de Tetrees Agent, contenido privado de Packs, representación de memoria o lógica de crecimiento;
  • Reglas de puntuación Agent AVCP, fixtures de evaluación internos, prompts de servicio o lógica de moderación;
  • Credenciales de proveedores de modelos, márgenes de precios, claves de firma, detalles de almacenamiento, bases de datos, APIs de administración, código de despliegue o configuración de producción.

Los ejemplos operan solo a través del contrato público y autenticado documentado. Revisa SECURITY.md y docs/PUBLIC_BOUNDARY.md antes de contribuir.

Verifica este repositorio

npm test
npm run check:public-boundary
npm pack --dry-run

Licencia

Los ejemplos de cliente y la documentación en este repositorio están bajo licencia MIT. Los nombres y marcas de servicio Tetrees, Tetrees Agent, Tetrees AI Pack, TAIP y Agent AVCP siguen siendo propiedad de Tetrees EX. La licencia no otorga acceso ni derechos sobre el servicio alojado o la inteligencia privada de Packs.