Tetrees AI

Tetrees Agent EX

Kit de integração pública para usar, crescer, comprar e publicar Tetrees AI Packs por meio do Tetrees Agent MCP e da API hospedados.

Explore Tetrees AI Packs  ·  Connect through MCP  ·  Publish an AI Pack

Este repositório é o produto público @tetrees/mcp (ai.tetrees/mcp): o servidor MCP stdio, clientes, exemplos de configuração e amostras seguras de extensão. Ele não contém os internos do Tetrees Agent, inteligência privada de Packs, pontuação Agent AVCP, prompts de serviço, armazenamento, moderação ou infraestrutura de troca.

O que você pode construir

Caminho	Use este kit para
Comprador / operador	Pesquisar Packs, inspecionar o relatório público Agent AVCP, cotar uma execução, testar um Pack com Tetrees Points, adquirir um Pack gratuito e baixar uma versão .taip de sua propriedade.
Construtor	Conectar um Pack auditado a uma API HTTPS de propriedade do usuário, servidor MCP aninhado ou habilidade local sem shell, mantendo as credenciais locais.
Vendedor	Criar um anúncio, enviar uma versão imutável .taip e imagens, inspecionar a prontidão, executar Agent AVCP, ler feedback privado de reparo e publicar uma versão aprovada.

O trabalho hospedado pela Tetrees não precisa de GPU local. Execuções financiadas por modelo são cotadas em Tetrees Points antes da execução; um Pack de sua propriedade também pode usar uma chave de provedor compatível fornecida ao processo MCP local.

Início rápido: MCP hospedado

Requisitos: Node.js 20+ e um token de API revogável da Conta Tetrees.

Adicione isto à configuração do seu 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>"
      }
    }
  }
}

Reinicie o cliente MCP e peça a ele para:

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.

Não coloque chaves de provedor em um Pack, prompt, arquivo de origem ou configuração MCP compartilhada. Chaves BYOK opcionais pertencem apenas ao ambiente do processo MCP local. Consulte examples/mcp/mcp-config.jsonc.

Inspecione o contrato MCP

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

O inspetor inicia o pacote MCP hospedado oficial, lista suas ferramentas e recursos públicos, verifica a superfície esperada de comprador/construtor/vendedor e sai sem gastar Points ou alterar o estado da conta.

O sufixo v=2.2.1 é intencional: ele impede que npx reutilize um tarball MCP mais antigo em cache sob a mesma URL. Altere-o apenas quando a Tetrees publicar um contrato MCP mais novo. A identidade npm para o mesmo pacote é @tetrees/mcp@2.2.1.

CLI da API pública

Copie os valores de .env.example para o seu shell; este projeto deliberadamente não carrega arquivos secretos automaticamente.

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

A CLI oculta campos de resposta com formato de segredo e relata códigos de erro da Tetrees, status HTTP e Retry-After. Ela não tenta novamente uma mutação automaticamente.

Fluxo do comprador

1. Pesquise por um Pack.
2. Inspecione o relatório público Agent AVCP e o perfil de execução.
3. Cote o modelo exato, o teto de tokens, as habilidades hospedadas e o ponto de verificação de crescimento.
4. Execute uma prévia stateless financiada por Points. Points reservados não utilizados são devolvidos.
5. Adquira um Pack gratuito ou compre um Pack pago no Tetrees EX.
6. A propriedade desbloqueia download, BYOK, crescimento salvo e extensões de cliente.

Execute o exemplo somente leitura documentado:

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

Fluxo do construtor: adicione capacidades sem entregá-las à Tetrees

Um Pack publicado pode declarar extensões de cliente que passaram no Agent AVCP. A vinculação real e as credenciais permanecem na máquina do usuário.

Padrões de vinculação suportados:

• https_api: URL HTTPS base fixa, métodos declarados, cabeçalhos baseados em ambiente.
• mcp: um servidor MCP aninhado iniciado sem shell e mapeado para nomes de ferramentas declarados.
• local_skill: um processo filho sem shell que recebe uma solicitação JSON e retorna um resultado JSON.

Comece com:

• examples/extensions/client-extensions.example.json
• examples/extensions/local-skill/issue-summary.mjs
• docs/BUILDER_GUIDE.md

A hospedagem da Tetrees nunca herda essas permissões locais. Um método de escrita precisa da frase exata por chamada APPROVE extensionId.methodId.

Fluxo do vendedor

O caminho de publicação suportado é intencionalmente orientado 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

Em seguida, use as ferramentas MCP hospedadas ou a referência da API Tetrees para enviar, cotar Agent AVCP, executá-lo após confirmar o valor exato de Points, inspecionar o relatório privado e publicar apenas o digest aprovado.

Consulte docs/SELLER_GUIDE.md e examples/seller/pack-listing.example.json.

Referências públicas estáveis

• Guia MCP
• Documentação da API
• OpenAPI 3.1
• Coleção Postman
• Catálogo de AI Packs

Segurança e limite do produto

Este repositório não contém:

• Implementação do Tetrees Agent, conteúdos privados de Packs, representação de memória ou lógica de crescimento;
• Regras de pontuação Agent AVCP, fixtures internas de avaliação, prompts de serviço ou lógica de moderação;
• Credenciais de provedores de modelo, margens de preço, chaves de assinatura, detalhes de armazenamento, bancos de dados, APIs administrativas, código de implantação ou configuração de produção.

Os exemplos operam apenas por meio do contrato público e autenticado documentado. Revise SECURITY.md e docs/PUBLIC_BOUNDARY.md antes de contribuir.

Verifique este repositório

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

Licença

Os exemplos de cliente e a documentação neste repositório são licenciados sob MIT. Os nomes e marcas de serviço Tetrees, Tetrees Agent, Tetrees AI Pack, TAIP e Agent AVCP permanecem propriedade da Tetrees EX. A licença não concede acesso ou direitos ao serviço hospedado ou à inteligência privada de Packs.