How vcky4/agent88 works
Agent88 is a TypeScript framework for building AI agents and composing them into multi-agent graphs. The main interaction is a user prompt entering an Agent, which loads optional memory, builds an execution context, and delegates to an engine that calls a model and may dispatch tools before returning a response. Agents also support direct text streaming. The graph API runs agents in topological order, passing each output to the next. The map includes documented middleware, tracing, provider adapters, and memory options; unsampled provider and Redis internals are not expanded.
Main entry points: Agent.ts Agent · ExecutionEngine.ts Execution Engine · BaseModel.ts Model Interface · AgentGraph.ts Agent Graph
Components 21
Agent API
- Agent
src/core/Agent.ts
Execution
- Execution Context
src/core/execution/ExecutionContext.ts - Execution Engine
src/core/execution/ExecutionEngine.ts - Middleware
src/core/execution/Middleware.ts - Trace
src/core/execution/Trace.ts - Tool Executor
src/core/execution/ToolExecutor.ts
Tools
- Tool Registry
src/core/tools/ToolRegistry.ts - Tool
src/core/tools/Tool.ts
Model Adapters
- Model Interface
src/core/models/BaseModel.ts - OpenAI Adapter
src/core/models/OpenAIModel.ts - Gemini Adapter
src/core/models/GeminiModel.ts - Ollama Adapter
src/core/models/OllamaModel.ts - Mock Adapter
src/core/models/MockModel.ts
Memory
- Memory Interface
src/types/index.ts - In-Memory Adapter
src/core/memory/InMemoryMemory.ts - Redis Adapter
src/core/memory/RedisMemory.ts
Agent Graphs
- Agent Graph
src/core/graph/AgentGraph.ts - Graph Executor
src/core/graph/GraphExecutor.ts - Graph Node
src/core/graph/GraphNode.ts - Graph Edge
src/core/graph/GraphEdge.ts
Other components
- Developer / User
Connections 26
- Developer / User → Agent: submits prompt
README.md - Agent → Memory Interface: loads / saves
src/core/Agent.ts - Agent → Tool Registry: registers tools
src/core/Agent.ts - Tool Registry → Tool: stores tools
src/core/tools/ToolRegistry.ts - Agent → Execution Context: builds context
src/core/Agent.ts - Agent → Execution Engine: delegates run
src/core/Agent.ts - Agent → Trace: creates trace
src/core/Agent.ts - Agent → Model Interface: streams directly
src/core/Agent.ts - Execution Engine → Execution Context: reads and updates
src/core/execution/ExecutionEngine.ts - Execution Engine → Middleware: dispatches through
src/core/execution/ExecutionEngine.ts - Execution Engine → Model Interface: generates response
src/core/execution/ExecutionEngine.ts - Execution Engine → Tool Executor: dispatches tool
src/core/execution/ExecutionEngine.ts - Tool Executor → Tool: executes
src/core/execution/ToolExecutor.ts - Execution Engine → Trace: records timings
src/core/execution/ExecutionEngine.ts - OpenAI Adapter → Model Interface: implements
src/core/models/OpenAIModel.ts - Gemini Adapter → Model Interface: implements
src/core/models/GeminiModel.ts - Ollama Adapter → Model Interface: implements
src/core/models/OllamaModel.ts - Mock Adapter → Model Interface: implements
src/core/models/MockModel.ts - In-Memory Adapter → Memory Interface: implements
src/core/memory/InMemoryMemory.ts - Redis Adapter → Memory Interface: implements
src/core/memory/RedisMemory.ts - Developer / User → Agent Graph: runs graph
README.md - Agent Graph → Graph Executor: delegates run
src/core/graph/AgentGraph.ts - Agent Graph → Graph Node: registers agents
src/core/graph/AgentGraph.ts - Agent Graph → Graph Edge: connects agents
src/core/graph/AgentGraph.ts - Graph Executor → Agent: runs agents
src/core/graph/GraphExecutor.ts - Graph Executor → Graph Edge: orders by edges
src/core/graph/GraphExecutor.ts