ito-compute

Itô Compute

Use a CLI canônica do Itô Compute ou o servidor MCP. A ECC não implementa um cliente paralelo, simulação local, reserva, executor de workload ou servidor de inferência. A própria ECC não faz automação de navegador.

Instale o pacote local canônico

ito-compute-cli atualmente não está publicado. Compile-o a partir de seu repositório canônico em vez de usar npx, npm exec ou um pacote não 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

Defina ECC_ITO_CLI_EXECUTABLE com o caminho absoluto explícito do artefato compilado:

/caminho/absoluto/para/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito.js

A ECC nunca descobre este cliente portador de credenciais através do PATH. ecc ito login realiza autorização de dispositivo e nunca herda ITO_API_KEY. O auth exclusivo para validação, além de find e status, encaminham ITO_API_KEY diretamente quando configurado; ITO_AUTH_MODE=legacy não é necessário. Nunca coloque uma chave ou token em argumentos, arquivos rastreados, resultados MCP, logs ou chat.

Fluxo de trabalho CLI

1. Execute ecc ito login antes da primeira operação. A ECC delega isso à autorização de dispositivo da CLI canônica, que abre a página de verificação Itô por padrão e persiste um token de dispositivo no Keychain do macOS. Use ecc ito login --no-browser para suprimir a transferência para a página. A própria ECC não faz automação de navegador. Se o agente de origem não conseguir concluir a etapa do navegador autenticado, passe o comando exato para o usuário; após a aprovação terminar, retorne à tarefa de origem e continue com ecc ito auth. Tokens de dispositivo usam o Keychain do macOS por padrão. A alternativa de token em arquivo é explícita e seu diretório e arquivo de token devem permanecer apenas do proprietário (0700 e 0600).

2. Execute ecc ito auth para validar credenciais existentes; ele nunca inicia login e rejeita --no-browser.

3. Antes de ecc ito find, obtenha autorização explícita do comprador para enviar uma RFQ.

   • Exija gpu, count, days inteiros, max-rate, nodes, gpus-per-node, storage-tb, start-window, form-factor, contract-type, fabric, region e a decisão de divisão de lote.
   • Exija count == nodes * gpus-per-node; nunca derive a topologia.
   • Use any apenas quando o comprador aceitar explicitamente qualquer fabric ou região.
   • --allow-split omitido significa falso.

4. Execute o comando RFQ ao 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. Execute ecc ito status para inspecionar RFQs e ordens de compra. Após uma falha de transporte ambígua, verifique o status antes de repetir find.

6. Quando uma cotação estiver pronta e o comprador aprovar explicitamente, aceite-a:

   ecc ito accept rfq_<ticket-id>
   

   Isso encaminha o ticket para a mesa para revisão humana. Não move fundos ou reserva capacidade. Não aceite sem autorização explícita do comprador.

7. Execute ecc ito logout quando o usuário solicitar explicitamente a revogação deste dispositivo. A CLI canônica mantém a credencial local quando a revogação remota falha para que o operador possa tentar novamente; nunca exclua o token manualmente como substituto.

Os preços de inventário são indicativos. Uma RFQ não é capacidade reservada. Trate uma taxa como fixa apenas quando o resultado canônico contiver uma cotação firme não nula.

Qualificação ao vivo de nós

ecc ito evals expõe o adaptador ao vivo restrito da CLI canônica para um sixtytwo-cli==0.3.33 instalado separadamente. Ele não expõe execução de fixtures locais através da ECC. Exija todos os itens a seguir antes de invocá-lo:

• autorização do operador para contatar os nós nomeados;
• ITO_ENABLE_SIXTYTWO_LIVE=1;
• --live-sixtytwo;
• uma lista explícita de nós; e
• um diretório de configuração absoluto existente contendo sixtytwo.yaml.

ecc ito evals \
  --cluster clu_prod_example \
  --live-sixtytwo \
  --nodes gpu-01,gpu-02 \
  --config-dir /caminho/absoluto/para/configuracao-qualificacao

O adaptador canônico pode executar apenas a verificação de versão fixada e sixtytwo test --full contra os nós explícitos. Ele não pode alugar, iniciar, recuperar, reparar, redefinir, comprar ou solicitar recursos. A ECC não encaminha ITO_API_KEY ou credenciais de modelo/nuvem para a qualificação de nós.

Fluxo de trabalho MCP

Compile o pacote canônico e configure o servidor stdio com um caminho absoluto:

{
  "mcpServers": {
    "ito-compute": {
      "command": "node",
      "args": [
        "/caminho/absoluto/para/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito-mcp.js"
      ]
    }
  }
}

O servidor expõe apenas:

• ito_auth
• ito_find
• ito_status
• ito_accept

ito_auth valida credenciais existentes; não inicia login de dispositivo. Use ito_auth, colete autorização explícita do comprador e todas as restrições obrigatórias, chame ito_find e então consulte com ito_status quando necessário. Quando uma cotação estiver pronta e o comprador aprovar explicitamente, chame ito_accept com o id do ticket. Cotações de mesa são geralmente indicativas e não vinculantes até que a mesa confirme; o resultado carrega quote_class.

Semântica de aluguel ou compra

find envia uma RFQ e pode retornar uma cotação firme, mas não aluga, compra, reserva, provisiona ou move fundos. accept encaminha uma cotação para a mesa para revisão humana; não move fundos ou reserva capacidade. status é orientado à leitura, embora o endpoint do provedor possa reconciliar uma ordem de compra existente. O link do painel passivo na ajuda da ECC é uma rota web separada operada pelo usuário; não abra ou opere como substituto para uma funcionalidade ausente da CLI.

Operações não suportadas

A superfície do cliente suportado não pode travar cotações, reservar capacidade, executar workloads ou servir inferência. accept é um encaminhamento para a mesa, não uma compra. O servidor MCP não expõe qualificação; use o comando CLI explícito acima. Não invente ferramentas adicionais ou um caminho de compra. Não substitua um navegador ou fixture quando a CLI local estiver ausente ou uma operação ao vivo falhar. Relate a funcionalidade ausente e pare.