ThenaJSO framework TypeScript para agentes de LLM

Declare um agente como classe e o prompt dele como markdown. Execute com isolamento, orçamento e cancelamento já embutidos.

Criar seu primeiro agente

Introdução

GitHub

🛡️

O limite faz parte da API

Orçamento de tempo, de chamadas, de tokens e de dinheiro. Cancelamento que chega dentro das suas tools, e não só entre os passos.

Configurar uma execução

🧵

Um processo, muitas execuções

Cada execução tem o próprio contexto, orçamento e gravador. Requisições concorrentes nunca enxergam o estado uma da outra.

Orquestrar agentes

🔍

Dá para ver o que aconteceu

Toda execução pode gerar um report em HTML e JSON — a árvore inteira de agentes, chamadas ao modelo e tools, com duração e custo em tokens.

Ligar o report

Trinta segundos

bash

npm install -g @thenajs/cli
thena create meu-agente
cd meu-agente && npm install && npm start

Um agente é isto:

// src/agents/explorer/explorer.agent.ts
import { Agent } from "@thenajs/core";
import { ReadFileTool } from "../../tools/read-file.tool";
import { LocalOllamaProvider } from "../../providers/ollama.provider";

@Agent({
  provider: LocalOllamaProvider,
  tools: [ReadFileTool],
  prompt: "./explorer.agent.md", // o comportamento mora no markdown
})
export class ExplorerAgent {}

<!-- src/agents/explorer/explorer.agent.md -->

Você explora projetos de software.

Leia os arquivos relevantes antes de responder. Prefira ler a supor.

Nenhuma linha para tratar mensagem, chamar a API, perceber uma chamada de tool ou validar argumento. Isso é trabalho do framework.

Por que esse nome

Thena vem de Atena — e não por acaso.

Atena não é a deusa da guerra. Essa é Ares. Atena é a deusa da guerra estratégica, da sabedoria e do ofício. É ela quem planeja antes de agir, quem entrega as ferramentas ao herói e quem aparece para dizer a hora de parar.

O projeto inteiro é isso. O ThenaJS não deixa o seu agente mais inteligente. Ele o deixa governado: planeja (@Workflow), age pelo que você entregou (@Tool), conhece o próprio teto (budget) e pode ouvir que é hora de parar (abort, stop).

Por onde começar

Se você quer…	Vá para
saber se serve para o seu caso	Introdução
colocar para rodar	Instalação
construir algo de ponta a ponta	Seu primeiro agente
descobrir o que ler depois	Próximos passos