isA Agent SDK

A comprehensive TypeScript SDK for building AI agent applications with modular, event-driven architecture.

🚀 Quick Start

npm install isa-agent-sdk

import { AIClient, AgentConfig, useAI } from 'isa-agent-sdk';

// Basic setup
const config = new AgentConfig()
  .withEndpoint('http://localhost:8000')
  .withTransport('sse')
  .build();

const client = new AIClient(config);

📚 Documentation

👉 Complete documentation is in the docs/ directory

Start Here: docs/SDK_USAGE_GUIDE.md

The main guide covering:

• ✅ Installation & Setup
• ✅ Quick Start Examples
• ✅ Core Concepts
• ✅ Configuration
• ✅ Basic Usage Patterns

Integration with App SDK: docs/INTEGRATION_GUIDE.md

Complete guide for integrating this Agent SDK into the isA App SDK:

• ✅ Step-by-step integration
• ✅ Enhanced provider setup
• ✅ Complete working examples
• ✅ Combined hooks and configuration

Additional Guides:

• docs/SDK_MODULES_GUIDE.md - All modules (Chat, Canvas, RAG, Tools, etc.)
• docs/SDK_COMPONENTS_GUIDE.md - UI components and styling
• docs/SDK_EXAMPLES_GUIDE.md - Complete application examples

🎯 Key Features

• 🤖 Agent-First Design - Built specifically for AI agent interactions
• ⚡ Event-Driven Architecture - Real-time streaming and updates
• 🧩 Modular Components - Use only what you need
• 🎨 Rich UI Components - Pre-built chat interfaces and controls
• 🔧 Framework Agnostic - Works with React, Vue, or vanilla JS
• 📱 Responsive Design - Mobile-friendly components
• 🎭 Extensible - Custom modules, tools, and transports

🏗️ Architecture

Application Layer (React/Vue/Widget Components)
Integration Layer (Hooks, Composables, Adapters)
Module Layer (Chat, Tools, Memory, Speech)
Core Layer (AIClient, EventBus, StateManager)
Foundation Layer (Types, Transport, Utils, Config)

📦 What's Included

Core Modules

• ChatModule - Conversation management
• SessionModule - Session persistence
• MemoryModule - Context and memory
• ToolModule - Tool registration and execution

Advanced Modules

• CanvasModule - Interactive visual AI
• RAGModule - Retrieval-Augmented Generation
• HITLModule - Human-in-the-loop workflows

UI Components

• ChatInterface - Complete chat UI
• MessageBubble - Message display
• TextInput - Advanced input controls
• Button, Icon, Typography - Design primitives

🚀 Getting Started

1. Read the main guide: docs/SDK_USAGE_GUIDE.md
2. For App SDK integration: docs/INTEGRATION_GUIDE.md
3. Explore modules: docs/SDK_MODULES_GUIDE.md
4. See examples: docs/SDK_EXAMPLES_GUIDE.md

🤝 Integration with isA App SDK

This Agent SDK is designed to seamlessly integrate with the isA App SDK (full-stack framework with Auth0, Supabase, Stripe).

See the complete integration guide: docs/INTEGRATION_GUIDE.md

📄 License

MIT

📖 Start with the main documentation →