feat: Add intelligent auto-router and enhanced integrations
- Add intelligent-router.sh hook for automatic agent routing - Add AUTO-TRIGGER-SUMMARY.md documentation - Add FINAL-INTEGRATION-SUMMARY.md documentation - Complete Prometheus integration (6 commands + 4 tools) - Complete Dexto integration (12 commands + 5 tools) - Enhanced Ralph with access to all agents - Fix /clawd command (removed disable-model-invocation) - Update hooks.json to v5 with intelligent routing - 291 total skills now available - All 21 commands with automatic routing 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
130
dexto/examples/README.md
Normal file
130
dexto/examples/README.md
Normal file
@@ -0,0 +1,130 @@
|
||||
# Dexto Examples
|
||||
|
||||
This directory contains example code and configurations demonstrating how to use Dexto in various contexts.
|
||||
|
||||
## Code Examples
|
||||
|
||||
### Basic Agent Usage (`basic-agent-example.ts`)
|
||||
|
||||
The simplest example of how to use the Dexto Agent SDK. Shows:
|
||||
- Creating an agent with minimal configuration
|
||||
- Starting and stopping the agent
|
||||
- Creating a session
|
||||
- Using `generate()` for request/response interactions
|
||||
- Token usage tracking
|
||||
|
||||
Run it with:
|
||||
```bash
|
||||
npx tsx basic-agent-example.ts
|
||||
```
|
||||
|
||||
### LangChain Integration (`dexto-langchain-integration/`)
|
||||
|
||||
Shows how to integrate Dexto with LangChain, useful if you're already using LangChain in your project.
|
||||
|
||||
### Agent Manager (`agent-manager-example/`)
|
||||
|
||||
Demonstrates using the AgentManager API for managing multiple agents programmatically.
|
||||
|
||||
### Agent Delegation (`agent-delegation/`)
|
||||
|
||||
Shows a pattern for implementing a multi-agent coordinator/specialist architecture where one agent delegates tasks to specialized agents.
|
||||
|
||||
### Demo Server (`resources-demo-server/`)
|
||||
|
||||
A simple HTTP server example demonstrating Dexto's resource authorization flow.
|
||||
|
||||
## Agent Configuration Examples
|
||||
|
||||
See the `/agents/` directory for YAML configuration examples for different use cases.
|
||||
|
||||
## How to Use These Examples
|
||||
|
||||
1. **Copy an example** to your project or workspace
|
||||
2. **Customize** the configuration for your needs
|
||||
3. **Install dependencies** if it has a `package.json`
|
||||
4. **Follow the README** for setup and running instructions
|
||||
|
||||
Each example is self-contained and can be run independently.
|
||||
|
||||
## Platform Integration Examples
|
||||
|
||||
These examples show how to integrate DextoAgent with different messaging platforms. They are **reference implementations** that you can customize and extend for your own use cases.
|
||||
|
||||
### Discord Bot (`discord-bot/`)
|
||||
|
||||
A complete Discord bot integration using discord.js and the Discord Gateway API.
|
||||
|
||||
**Features:**
|
||||
- Responds to messages in DMs and server channels
|
||||
- Support for the `!ask` command prefix in channels
|
||||
- Image attachment processing
|
||||
- Rate limiting per user
|
||||
- Persistent per-user conversation sessions
|
||||
- Tool call notifications
|
||||
|
||||
**Quick Start:**
|
||||
```bash
|
||||
cd discord-bot
|
||||
pnpm install
|
||||
cp .env.example .env
|
||||
# Add your DISCORD_BOT_TOKEN to .env
|
||||
pnpm start
|
||||
```
|
||||
|
||||
**See:** [`discord-bot/README.md`](./discord-bot/README.md) for detailed setup and usage instructions.
|
||||
|
||||
### Telegram Bot (`telegram-bot/`)
|
||||
|
||||
A complete Telegram bot integration using grammy and the Telegram Bot API.
|
||||
|
||||
**Features:**
|
||||
- Responds to messages in DMs and group chats
|
||||
- Support for `/ask` command and `/start` menu
|
||||
- Image attachment processing
|
||||
- Inline query support (use bot username in any chat)
|
||||
- Session reset button
|
||||
- Concurrency control for inline queries
|
||||
- Persistent per-user conversation sessions
|
||||
- Tool call notifications
|
||||
|
||||
**Quick Start:**
|
||||
```bash
|
||||
cd telegram-bot
|
||||
pnpm install
|
||||
cp .env.example .env
|
||||
# Add your TELEGRAM_BOT_TOKEN to .env
|
||||
pnpm start
|
||||
```
|
||||
|
||||
**See:** [`telegram-bot/README.md`](./telegram-bot/README.md) for detailed setup and usage instructions.
|
||||
|
||||
## Building Your Own Integration
|
||||
|
||||
To build your own platform integration:
|
||||
|
||||
1. **Start with a reference implementation** - Use `discord-bot` or `telegram-bot` as a template
|
||||
2. **Adapt the bot.ts** - Replace platform-specific code with your target platform's SDK
|
||||
3. **Keep the pattern** - Receive a pre-initialized DextoAgent and implement platform-specific I/O
|
||||
4. **Reuse the config** - Use the same agent-config.yml pattern for configuration
|
||||
5. **Add main.ts** - Create a standalone runner that initializes the agent and starts your bot
|
||||
|
||||
The key pattern is:
|
||||
```typescript
|
||||
export function startMyBot(agent: DextoAgent) {
|
||||
// Platform-specific setup
|
||||
// Use agent.run() to process user input
|
||||
// Use agent.agentEventBus to listen for events
|
||||
// Return your platform's client/connection object
|
||||
}
|
||||
```
|
||||
|
||||
## Documentation
|
||||
|
||||
- [Dexto Documentation](https://dexto.dev)
|
||||
- [DextoAgent API](https://docs.dexto.dev)
|
||||
- [Configuration Reference](../agents/examples/README.md)
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user