ito-compute

Itô Compute

Usa la CLI canónica de Itô Compute o el servidor MCP. ECC no implementa un cliente paralelo, simulación local, reserva, ejecutor de cargas de trabajo ni servidor de inferencia. ECC mismo no realiza automatización de navegador.

Instala el paquete local canónico

ito-compute-cli actualmente no está publicado. Constrúyelo desde su repositorio canónico en lugar de usar npx, npm exec o un paquete no verificado:

git clone https://github.com/Ito-Markets/ito-cloud-runtime.git
cd ito-cloud-runtime/cli/ito-compute-cli
npm ci
npm run check

Establece ECC_ITO_CLI_EXECUTABLE a la ruta absoluta de la entrada construida:

/ruta/absoluta/a/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito.js

ECC nunca descubre este cliente con credenciales a través de PATH. ecc ito login realiza autorización de dispositivo y nunca hereda ITO_API_KEY. El auth solo para validación, junto con find y status, reenvían ITO_API_KEY directamente cuando está configurada; no se requiere ITO_AUTH_MODE=legacy. Nunca coloques una clave o token en argumentos, archivos rastreados, resultados MCP, registros o chat.

Flujo de trabajo CLI

1. Ejecuta ecc ito login antes de la primera operación. ECC delega esto a la autorización de dispositivo de la CLI canónica, que abre la página de verificación de Itô por defecto y persiste un token de dispositivo en el Llavero de macOS. Usa ecc ito login --no-browser para suprimir la transferencia a la página. ECC mismo no realiza automatización de navegador. Si el agente originador no puede completar el paso del navegador con sesión iniciada, entrega el comando exacto al usuario; después de que la aprobación finalice, regresa a la tarea originadora y continúa con ecc ito auth. Los tokens de dispositivo usan el Llavero de macOS por defecto. La alternativa de token en archivo es explícita y su directorio y archivo de token deben permanecer solo del propietario (0700 y 0600).

2. Ejecuta ecc ito auth para validar las credenciales existentes; nunca inicia sesión y rechaza --no-browser.

3. Antes de ecc ito find, obtén autorización explícita del comprador para enviar una RFQ.

   • Requiere gpu, count, days completos, max-rate, nodes, gpus-per-node, storage-tb, start-window, form-factor, contract-type, fabric, region y la decisión de llenado dividido.
   • Requiere count == nodes * gpus-per-node; nunca derives la topología.
   • Usa any solo cuando el comprador acepte explícitamente cualquier tejido o región.
   • --allow-split omitido significa falso.

4. Ejecuta el comando RFQ en vivo:

   ecc ito find \
     --gpu h200 \
     --count 8 \
     --nodes 1 \
     --gpus-per-node 8 \
     --days 30 \
     --storage-tb 1 \
     --start-window 2099-08-15 \
     --max-rate 3.00 \
     --form-factor bare_metal \
     --contract-type reservation \
     --fabric infiniband \
     --region us-east-1
   

5. Ejecuta ecc ito status para inspeccionar RFQ y órdenes de adquisición. Después de una falla de transporte ambigua, verifica el estado antes de repetir find.

6. Cuando una cotización esté lista y el comprador la apruebe explícitamente, acéptala:

   ecc ito accept rfq_<ticket-id>
   

   Esto enruta el ticket al escritorio para revisión humana. No mueve fondos ni reserva capacidad. No aceptes sin autorización explícita del comprador.

7. Ejecuta ecc ito logout cuando el usuario solicite explícitamente revocar este dispositivo. La CLI canónica conserva la credencial local cuando la revocación remota falla para que el operador pueda reintentar; nunca elimines el token manualmente como sustituto.

Los precios del inventario son indicativos. Una RFQ no es capacidad reservada. Trata una tarifa como fija solo cuando el resultado canónico contenga una cotización firme no nula.

Calificación de nodos en vivo

ecc ito evals expone el adaptador en vivo limitado de la CLI canónica a un sixtytwo-cli==0.3.33 instalado por separado. No expone la ejecución de accesorios locales a través de ECC. Requiere todo lo siguiente antes de invocarlo:

• autorización del operador para contactar los nodos nombrados;
• ITO_ENABLE_SIXTYTWO_LIVE=1;
• --live-sixtytwo;
• una lista explícita de nodos; y
• un directorio de configuración absoluto existente que contenga sixtytwo.yaml.

ecc ito evals \
  --cluster clu_prod_example \
  --live-sixtytwo \
  --nodes gpu-01,gpu-02 \
  --config-dir /ruta/absoluta/a/configuracion-calificacion

El adaptador canónico solo puede ejecutar la verificación de versión fija y sixtytwo test --full contra los nodos explícitos. No puede alquilar, lanzar, recuperar, reparar, restablecer, comprar u ordenar recursos. ECC no reenvía ITO_API_KEY ni credenciales de modelo/nube a la calificación de nodos.

Flujo de trabajo MCP

Construye el paquete canónico, luego configura el servidor stdio con una ruta absoluta:

{
  "mcpServers": {
    "ito-compute": {
      "command": "node",
      "args": [
        "/ruta/absoluta/a/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito-mcp.js"
      ]
    }
  }
}

El servidor expone solo:

• ito_auth
• ito_find
• ito_status
• ito_accept

ito_auth valida las credenciales existentes; no inicia el inicio de sesión del dispositivo. Usa ito_auth, reúne la autorización explícita del comprador y cada restricción obligatoria, llama a ito_find, luego consulta con ito_status cuando sea necesario. Cuando una cotización esté lista y el comprador la apruebe explícitamente, llama a ito_accept con el id del ticket. Las cotizaciones de escritorio suelen ser indicativas y no vinculantes hasta que el escritorio las confirme; el resultado lleva quote_class.

Semántica de alquiler o compra

find envía una RFQ y puede devolver una cotización firme, pero no alquila, compra, reserva, aprovisiona ni mueve fondos. accept enruta una cotización al escritorio para revisión humana; no mueve fondos ni reserva capacidad. status está orientado a lectura, aunque el endpoint del proveedor puede conciliar una orden de adquisición existente. El enlace al panel pasivo en la ayuda de ECC es una ruta web separada operada por el usuario; no lo abras ni lo operes como sustituto de una capacidad CLI faltante.

Operaciones no soportadas

La superficie del cliente soportada no puede bloquear cotizaciones, reservar capacidad, ejecutar cargas de trabajo ni servir inferencia. accept es una transferencia al escritorio, no una compra. El servidor MCP no expone calificación de nodos; usa el comando CLI explícito anterior. No inventes herramientas adicionales ni una ruta de compra. No sustituyas un navegador o accesorio cuando la CLI local falte o una operación en vivo falle. Reporta la capacidad faltante y detente.