ito-compute (Itô 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 workloads ou servidor de inferência. A ECC em si não realiza automação de navegador.

Instale o pacote canônico local

ito-compute-cli está atualmente não 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 para o caminho absoluto explícito do artefato compilado:

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

A ECC nunca descobre este cliente que contém credenciais através do PATH. ecc ito login realiza autorização de dispositivo e nunca herda ITO_API_KEY. O auth somente 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 de MCP, logs ou chat.

Fluxo de trabalho da 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 por padrão a página de verificação Itô e persiste um token de dispositivo no macOS Keychain. Use ecc ito login --no-browser para suprimir o redirecionamento de página. A ECC em si não faz automação de navegador. Se o agente de origem não puder 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 macOS Keychain por padrão. A alternativa de arquivo-token é explícita, e seu diretório e arquivo de token devem permanecer somente 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 submeter 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 topologia.
   • Use any apenas quando o comprador aceitar explicitamente qualquer fabric ou região.
   • --allow-split omitido significa falso.

4. Execute o comando de 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 procurement. 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 análise humana. Não move fundos nem reserva capacidade. Não aceite sem autorização explícita do comprador.

7. Execute ecc ito logout quando o usuário solicitar explicitamente revogar este 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 de nós ao vivo

ecc ito evals expõe o adaptador ao vivo restrito da CLI canônica para um sixtytwo-cli==0.3.33 instalado separadamente. Não expõe execução de fixture local 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 /absolute/path/to/qualification-config

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, lançar, recuperar, reparar, redefinir, comprar ou pedir 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": [
        "/absolute/path/to/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 do dispositivo. Use ito_auth, obtenha autorização explícita do comprador e todas as restrições obrigatórias, chame ito_find, depois 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 costumam ser indicativas e não vinculantes até a mesa confirmar; o resultado carrega quote_class.

Semântica de aluguel ou compra

find submete 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 análise humana; não move fundos nem reserva capacidade. status é orientado a leitura, embora o endpoint do provedor possa reconciliar uma ordem de procurement existente. O link do painel passivo na ajuda da ECC é uma rota web separada operada pelo usuário; não 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 é uma transferência para a mesa, não uma compra. O servidor MCP não expõe qualificação; use o comando explícito da CLI 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.