feat: Export AI module components for public use

[konard]

Summary

This PR implements issue #19 by exporting the complete AI module from the Hasyx package, making all AI components publicly available for import and use.

Problem

The Hasyx AI module (documented in AI.md) was fully implemented but not exported from lib/server.ts, making it impossible for applications to import and use the AI functionality.

Related issues:

• AI #19 - AI (umbrella issue)
• Ask #20 - Ask CLI tool
• Ollama #21 - Ollama provider support
• OpenRouter #22 - OpenRouter provider support

Solution

Added comprehensive exports to lib/server.ts for all AI module components:

Core Components

• AI - Base AI class with memory management
• Dialog - Event-driven conversation orchestrator
• DialogParser - Thinking buffer parser for streaming
• Tool - Abstract base class for tools
• Tooler - Tool execution manager

Utilities

• createSystemPrompt - System prompt builder
• printConsole - Console output formatting
• Terminal and Telegram integration helpers

AI Providers

• OllamaProvider - Local model support via Ollama
• OpenRouterProvider - Cloud model support via OpenRouter
• ApiRouteProvider - API route provider

Tools

• ExecJSTool - JavaScript code execution
• ExecTsxTool - TypeScript code execution
• TerminalTool - Terminal command execution

Handlers

• api-dialog - API dialog handler

Architecture

The AI module provides an event-driven architecture for LLM interactions:

import { Dialog, OpenRouterProvider, ExecJSTool, TerminalTool } from 'hasyx/lib/server';

const dialog = new Dialog({
  provider: new OpenRouterProvider({ 
    token: process.env.OPENROUTER_API_KEY,
    model: 'deepseek/deepseek-chat-v3-0324:free'
  }),
  tools: [new ExecJSTool(), new TerminalTool()],
  systemPrompt: 'You are a helpful AI assistant.',
  onChange: (event) => {
    console.log('[AI Event]', event.type);
  }
});

await dialog.ask('Calculate the factorial of 5 using JavaScript');

Testing

The AI module includes comprehensive tests:

• lib/ai/ai.test.ts - Core AI class tests
• lib/ai/dialog.test.ts - Dialog orchestrator tests
• lib/ai/dialog-parser.test.ts - Parser tests
• lib/ai/tooler.test.ts - Tooler tests
• lib/ai/providers/*.test.ts - Provider tests
• lib/ai/tools/tools.test.ts - Tool tests

Documentation

Full documentation available in:

• AI.md - Architecture overview
• ASK.md - Ask CLI usage
• OLLAMA.md - Local model setup
• OPENROUTER.md - Cloud model setup

Impact

This change enables applications to:

• Build custom AI assistants with Hasyx
• Use local models (Ollama) or cloud models (OpenRouter)
• Create custom tools for AI interactions
• Implement event-driven AI workflows
• Leverage the full AI module architecture

Closes #19

[vercel]

@konard is attempting to deploy a commit to the ivansglazunov's projects Team on Vercel.

A member of the Team first needs to authorize it.

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

📎 Log file uploaded as GitHub Gist (389KB)
🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.