@agentforge/core
> Core abstractions for AgentForge - production-ready framework for building deep agents with LangGraph



š Status: Production Ready & Published
All features complete | 500+ tests passing | Full TypeScript support | Comprehensive documentation
⨠Features
$3
-
Rich Metadata - Categories, tags, examples, and detailed descriptions
-
Fluent Builder API - Easy tool creation with
createTool()-
Tool Registry - Centralized management with querying and events
-
LangChain Integration - Seamless conversion to/from LangChain tools
-
Prompt Generation - Automatic LLM-friendly prompt generation
-
113 tests - Comprehensive test coverage
$3
-
State Management - Type-safe state annotations with Zod validation
-
Workflow Builders - Sequential, parallel, and conditional patterns
-
Error Handling - Retry, error handling, and timeout utilities
-
Subgraph Composition - Reusable subgraph utilities
-
Memory & Persistence - Checkpointer and thread management
-
Observability - LangSmith integration, metrics, logging, error reporting
-
158 tests - Full coverage of all utilities
$3
-
Composable Middleware - Caching, rate limiting, validation, concurrency control
-
Production Presets - Ready-to-use middleware stacks
-
Development Tools - Logging, debugging, and testing middleware
-
94 tests - Comprehensive middleware testing
$3
-
Stream Transformers - Filter, map, batch, debounce, throttle
-
Stream Aggregators - Collect, reduce, window operations
-
SSE Support - Server-Sent Events for real-time updates
-
WebSocket Support - Bidirectional streaming
-
Progress Tracking - Monitor long-running operations
-
68 tests - Full streaming coverage
$3
-
Async Execution - Parallel and sequential tool execution
-
Lifecycle Management - Setup, teardown, and cleanup hooks
-
Tool Composition - Combine tools into pipelines
-
Testing Utilities - Mock tools and test helpers
$3
-
Connection Pooling - Efficient resource reuse
-
Memory Management - Automatic cleanup and limits
-
Batch Processing - Efficient bulk operations
-
Circuit Breaker - Fault tolerance and resilience
$3
-
Health Checks - System and component health monitoring
-
Profiling - Performance metrics and bottleneck detection
-
Alerts - Configurable alerting system
-
Audit Logging - Comprehensive activity tracking
$3
-
Docker Support - Production-ready containers
-
Kubernetes - Deployment manifests and guides
-
CI/CD Templates - GitHub Actions, GitLab CI
-
Configuration Management - Environment-based config
Installation
``bash
pnpm add @agentforge/core
`
Quick Start
$3
`typescript
import { createTool } from '@agentforge/core';
import { z } from 'zod';
const weatherTool = createTool({
name: 'get_weather',
description: 'Get current weather for a location',
schema: z.object({
location: z.string().describe('City name'),
units: z.enum(['celsius', 'fahrenheit']).optional()
}),
execute: async ({ location, units = 'celsius' }) => {
// Implementation
return { temperature: 22, units, location };
}
});
`
$3
`typescript
import { createSequentialWorkflow, withRetry } from '@agentforge/core';
import { z } from 'zod';
// Create a sequential workflow
const workflow = createSequentialWorkflow(AgentState, [
{ name: 'fetch', node: fetchNode },
{ name: 'process', node: processNode },
{ name: 'save', node: saveNode },
]);
// Add error handling
const robustNode = withRetry(myNode, {
maxAttempts: 3,
backoff: 'exponential',
});
const app = workflow.compile();
`
Documentation
š Full Documentation
$3
-
Getting Started-
Core Concepts-
API Reference$3
-
Building Your First Agent-
Creating Custom Tools-
Advanced PatternsExamples
See the examples documentation for complete working examples.
Development
`bash
Build
pnpm build
Watch mode
pnpm dev
Run tests
pnpm test
Type check
pnpm typecheck
``
š Links
- GitHub Repository
- npm Package
- Changelog - See what's new before upgrading
- Report Issues
License
MIT Ā© 2026 Tom Van Schoor