Sobre o projeto

Este repositório fornece os SDKs oficiais em JavaScript/TypeScript para criar aplicações com agentes de IA Octavus. Está organizado como um monorepo contendo vários pacotes npm, cada um direcionado a uma parte diferente da superfície de integração. Os pacotes incluem @octavus/core para tipos e utilitários compartilhados usados na comunicação cliente/servidor, @octavus/server-sdk para integração de backend, @octavus/client-sdk como cliente agnóstico de framework, @octavus/react para hooks e bindings React, @octavus/cli para gerenciamento de agentes e @octavus/docs para conteúdo de documentação. O SDK de servidor demonstra a criação de um OctavusClient com uma chave de API, a criação de uma sessão de agente com variáveis iniciais, a anexação a essa sessão com manipuladores de ferramentas personalizados e o acionamento de um trigger nomeado enquanto transmite eventos de resposta, como deltas de texto. O pacote React mostra um hook useOctavusChat combinado com um transporte HTTP, onde uma solicitação de trigger é encaminhada para um endpoint de backend e mensagens, status e uma função de envio são expostos à interface do usuário. Os links de documentação cobrem primeiros passos, SDK de servidor, SDK de cliente, referência de protocolo e referência de API. O desenvolvimento requer Node.js 20+ e pnpm 10+, com scripts para instalação, build, lint, verificação de tipos e formatação. O projeto é licenciado sob MIT e aceita contribuições por meio de um guia de contribuição.