agent-sdk

Este repositorio proporciona los SDK oficiales de JavaScript/TypeScript para crear aplicaciones con agentes de Octavus AI. Está organizado como un monorepo que contiene varios paquetes npm, cada uno dirigido a una parte diferente de la superficie de integración. Los paquetes incluyen @octavus/core para tipos y utilidades compartidos usados en la comunicación cliente/servidor, @octavus/server-sdk para la integración backend, @octavus/client-sdk como cliente agnóstico de framework, @octavus/react para hooks y bindings de React, @octavus/cli para la gestión de agentes, y @octavus/docs para el contenido de documentación. El SDK de servidor demuestra cómo crear un OctavusClient con una clave de API, crear una sesión de agente con variables iniciales, adjuntarse a esa sesión con manejadores de herramientas personalizados, y activar un trigger con nombre mientras se transmiten eventos de respuesta como deltas de texto. El paquete de React muestra un hook useOctavusChat combinado con un transporte HTTP, donde una solicitud de trigger se reenvía a un endpoint backend y los mensajes, el estado y una función de envío se exponen a la interfaz de usuario. Los enlaces de documentación cubren primeros pasos, SDK de servidor, SDK de cliente, referencia del protocolo y referencia de la API. El desarrollo requiere Node.js 20+ y pnpm 10+, con scripts para instalar, compilar, lint, verificación de tipos y formateo. El proyecto tiene licencia MIT y acepta contribuciones mediante una guía de contribución.