ito-compute

Itô Compute

Utilisez le CLI canonique Itô compute ou le serveur MCP. ECC n'implémente pas de client parallèle, de simulation locale, de réservation, d'exécuteur de charge de travail ou de serveur d'inférence. ECC lui-même n'effectue aucune automatisation de navigateur.

Installer le paquet local canonique

ito-compute-cli n'est actuellement pas publié. Construisez-le à partir de son dépôt canonique plutôt que d'utiliser npx, npm exec, ou un paquet non vérifié :

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

Définissez ECC_ITO_CLI_EXECUTABLE avec le chemin absolu explicite du binaire construit :

/absolute/path/to/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito.js

ECC ne découvre jamais ce client porteur d'identifiants via le PATH. ecc ito login effectue une autorisation d'appareil et n'hérite jamais de ITO_API_KEY. Les commandes auth, find et status (validation uniquement) transmettent ITO_API_KEY directement lorsqu'il est configuré ; ITO_AUTH_MODE=legacy n'est pas requis. Ne placez jamais une clé ou un jeton dans les arguments, les fichiers suivis, les résultats MCP, les journaux ou le chat.

Workflow CLI

1. Exécutez ecc ito login avant la première opération. ECC délègue cela à l'autorisation d'appareil du CLI canonique, qui ouvre par défaut la page de vérification Itô et stocke un jeton d'appareil dans le trousseau macOS. Utilisez ecc ito login --no-browser pour supprimer le transfert vers la page. ECC lui-même n'effectue aucune automatisation de navigateur. Si l'agent d'origine ne peut pas terminer l'étape du navigateur connecté, transmettez la commande exacte à l'utilisateur ; une fois l'approbation terminée, revenez à la tâche d'origine et continuez avec ecc ito auth. Les jetons d'appareil utilisent le trousseau macOS par défaut. Le fallback vers un fichier jeton est explicite, et son répertoire et son fichier jeton doivent rester en propriétaire uniquement (0700 et 0600).

2. Exécutez ecc ito auth pour valider les identifiants existants ; cela ne démarre jamais la connexion et rejette --no-browser.

3. Avant ecc ito find, obtenez l'autorisation explicite de l'acheteur pour soumettre une RFQ.

   • Exigez gpu, count, days (nombre entier), max-rate, nodes, gpus-per-node, storage-tb, start-window, form-factor, contract-type, fabric, region et la décision de fractionnement.
   • Exigez count == nodes * gpus-per-node ; ne dérivez jamais la topologie.
   • Utilisez any uniquement lorsque l'acheteur accepte explicitement n'importe quel fabric ou région.
   • --allow-split omis signifie faux.

4. Exécutez la commande RFQ en direct :

   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. Exécutez ecc ito status pour inspecter les RFQ et les commandes d'achat. Après un échec de transport ambigu, vérifiez le statut avant de répéter find.

6. Lorsqu'un devis est prêt et que l'acheteur l'approuve explicitement, acceptez-le :

   ecc ito accept rfq_<ticket-id>
   

   Cela achemine le ticket au bureau pour examen humain. Cela ne déplace pas de fonds et ne réserve pas de capacité. N'acceptez pas sans autorisation explicite de l'acheteur.

7. Exécutez ecc ito logout lorsque l'utilisateur demande explicitement de révoquer cet appareil. Le CLI canonique conserve l'identifiant local lorsque la révocation à distance échoue afin que l'opérateur puisse réessayer ; ne supprimez jamais le jeton manuellement en remplacement.

Les prix de l'inventaire sont indicatifs. Une RFQ n'est pas une capacité réservée. Traitez un taux comme fixe uniquement lorsque le résultat canonique contient un devis ferme non nul.

Qualification de nœud en direct

ecc ito evals expose l'adaptateur en direct étroit du CLI canonique vers un sixtytwo-cli==0.3.33 installé séparément. Il n'expose pas l'exécution de fixtures locales via ECC. Exigez tous les éléments suivants avant de l'invoquer :

• l'autorisation de l'opérateur pour contacter les nœuds nommés ;
• ITO_ENABLE_SIXTYTWO_LIVE=1 ;
• --live-sixtytwo ;
• une liste explicite de nœuds ; et
• un répertoire de configuration absolu existant contenant sixtytwo.yaml.

ecc ito evals \
  --cluster clu_prod_example \
  --live-sixtytwo \
  --nodes gpu-01,gpu-02 \
  --config-dir /absolute/path/to/qualification-config

L'adaptateur canonique peut exécuter uniquement la vérification de version épinglée et sixtytwo test --full sur les nœuds explicites. Il ne peut pas louer, lancer, récupérer, réparer, réinitialiser, acheter ou commander des ressources. ECC ne transmet pas ITO_API_KEY ni les identifiants de modèle/cloud dans la qualification de nœud.

Workflow MCP

Construisez le paquet canonique, puis configurez le serveur stdio avec un chemin absolu :

{
  "mcpServers": {
    "ito-compute": {
      "command": "node",
      "args": [
        "/absolute/path/to/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito-mcp.js"
      ]
    }
  }
}

Le serveur expose uniquement :

• ito_auth
• ito_find
• ito_status
• ito_accept

ito_auth valide les identifiants existants ; il ne démarre pas la connexion d'appareil. Utilisez ito_auth, rassemblez l'autorisation explicite de l'acheteur et toutes les contraintes strictes, appelez ito_find, puis interrogez avec ito_status si nécessaire. Lorsqu'un devis est prêt et que l'acheteur l'approuve explicitement, appelez ito_accept avec l'identifiant du ticket. Les devis de bureau sont généralement indicatifs et non contraignants jusqu'à confirmation par le bureau ; le résultat porte quote_class.

Sémantique de location ou d'achat

find soumet une RFQ et peut retourner un devis ferme, mais ne loue pas, n'achète pas, ne réserve pas, ne provisionne pas et ne déplace pas de fonds. accept achemine un devis au bureau pour examen humain ; cela ne déplace pas de fonds et ne réserve pas de capacité. status est orienté lecture, bien que le point de terminaison du fournisseur puisse rapprocher une commande d'achat existante. Le lien passif vers le tableau de bord dans l'aide ECC est une route web distincte exploitée par l'utilisateur ; ne l'ouvrez pas et ne l'utilisez pas comme substitut d'une fonctionnalité CLI manquante.

Opérations non prises en charge

La surface client prise en charge ne peut pas verrouiller les devis, réserver de capacité, exécuter des charges de travail ou servir de l'inférence. accept est un transfert au bureau, pas un achat. Le serveur MCP n'expose pas la qualification ; utilisez la commande CLI explicite ci-dessus. N'inventez pas d'outils supplémentaires ni de chemin d'achat. Ne substituez pas un navigateur ou une fixture lorsque le CLI local est manquant ou qu'une opération en direct échoue. Signalez la capacité manquante et arrêtez-vous.