@agentforge/core 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +65 -55
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,69 +1,71 @@
1
1
  # @agentforge/core
2
2
 
3
- Core abstractions for AgentForge - production-ready deep agents framework.
3
+ > Core abstractions for AgentForge - production-ready framework for building deep agents with LangGraph
4
4
 
5
- ## Status
5
+ [![npm version](https://img.shields.io/npm/v/@agentforge/core)](https://www.npmjs.com/package/@agentforge/core)
6
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
7
+ [![License](https://img.shields.io/badge/license-MIT-green)](../../LICENSE)
6
8
 
7
- ✅ **Phase 1 & 2 Complete** | 🚧 **Phase 3.1 In Progress** - ReAct Pattern Nearly Complete
9
+ ## 🎉 Status: Production Ready & Published
8
10
 
9
- **326 tests passing** | **Full TypeScript support** | **Comprehensive documentation**
11
+ **All features complete** | **500+ tests passing** | **Full TypeScript support** | **Comprehensive documentation**
10
12
 
11
- ## Features
13
+ ## ✨ Features
12
14
 
13
- ### ✅ Production Ready (Phase 1 & 2)
14
-
15
- **Phase 1: Tool System** (113 tests)
16
- - **Tool Metadata** - Rich metadata with categories, tags, examples
17
- - **Tool Builder** - Fluent API for creating tools
15
+ ### 🛠️ Tool System (Phase 1)
16
+ - **Rich Metadata** - Categories, tags, examples, and detailed descriptions
17
+ - **Fluent Builder API** - Easy tool creation with `createTool()`
18
18
  - **Tool Registry** - Centralized management with querying and events
19
- - **LangChain Integration** - Seamless conversion to LangChain tools
20
- - **Prompt Generation** - Automatic LLM prompt generation
19
+ - **LangChain Integration** - Seamless conversion to/from LangChain tools
20
+ - **Prompt Generation** - Automatic LLM-friendly prompt generation
21
+ - **113 tests** - Comprehensive test coverage
21
22
 
22
- **Phase 2: LangGraph Utilities** (158 tests)
23
+ ### 📊 LangGraph Utilities (Phase 2)
23
24
  - **State Management** - Type-safe state annotations with Zod validation
24
25
  - **Workflow Builders** - Sequential, parallel, and conditional patterns
25
26
  - **Error Handling** - Retry, error handling, and timeout utilities
26
27
  - **Subgraph Composition** - Reusable subgraph utilities
27
28
  - **Memory & Persistence** - Checkpointer and thread management
28
29
  - **Observability** - LangSmith integration, metrics, logging, error reporting
29
-
30
- ### 🚧 In Progress (Phase 3)
31
-
32
- **Phase 3.1.1-3.1.3: ReAct Pattern Core** (29 tests) ✅
33
- - **ReAct State** - State definition with Zod schemas
34
- - **Agent Builder** - `createReActAgent()` factory function
35
- - **Prompt Templates** - System prompts and reasoning templates
36
- - **Reasoning Node** - Generates thoughts and decides on actions
37
- - **Action Node** - Executes tools with error handling
38
- - **Observation Node** - Processes results and updates scratchpad
39
-
40
- **Phase 3.1.4: ReAct Builder & Integration** (26 tests) ✅
41
- - **Fluent Builder API** - `ReActAgentBuilder` with method chaining
42
- - **Factory Function** - `createReActAgentBuilder()` alternative
43
- - **Integration Tests** - 7 end-to-end scenarios
44
- - **Validation** - Runtime validation of required fields
45
- - **Type Safety** - Full TypeScript support with inference
46
-
47
- **Phase 3.1.5: Documentation** (In Progress)
48
- - Usage guide with examples
49
- - API documentation
50
- - Migration guide
51
-
52
- ### 📋 Coming Soon
53
-
54
- **Phase 3.2-3.4: More Agent Patterns**
55
- - Plan-Execute pattern
56
- - Reflection pattern
57
- - Multi-agent coordination
58
-
59
- **Phase 4: Middleware System**
60
- - Logging, tracing, caching middleware
61
- - Rate limiting and retry middleware
62
-
63
- **Phase 5: Production Features**
64
- - Streaming support
65
- - Performance monitoring
66
- - Production deployment guides
30
+ - **158 tests** - Full coverage of all utilities
31
+
32
+ ### � Middleware System (Phase 4)
33
+ - **Composable Middleware** - Caching, rate limiting, validation, concurrency control
34
+ - **Production Presets** - Ready-to-use middleware stacks
35
+ - **Development Tools** - Logging, debugging, and testing middleware
36
+ - **94 tests** - Comprehensive middleware testing
37
+
38
+ ### 🌊 Streaming & Real-time (Phase 5.1)
39
+ - **Stream Transformers** - Filter, map, batch, debounce, throttle
40
+ - **Stream Aggregators** - Collect, reduce, window operations
41
+ - **SSE Support** - Server-Sent Events for real-time updates
42
+ - **WebSocket Support** - Bidirectional streaming
43
+ - **Progress Tracking** - Monitor long-running operations
44
+ - **68 tests** - Full streaming coverage
45
+
46
+ ### 🛠️ Advanced Tools (Phase 5.2)
47
+ - **Async Execution** - Parallel and sequential tool execution
48
+ - **Lifecycle Management** - Setup, teardown, and cleanup hooks
49
+ - **Tool Composition** - Combine tools into pipelines
50
+ - **Testing Utilities** - Mock tools and test helpers
51
+
52
+ ### 📦 Resource Management (Phase 5.3)
53
+ - **Connection Pooling** - Efficient resource reuse
54
+ - **Memory Management** - Automatic cleanup and limits
55
+ - **Batch Processing** - Efficient bulk operations
56
+ - **Circuit Breaker** - Fault tolerance and resilience
57
+
58
+ ### � Monitoring (Phase 5.4)
59
+ - **Health Checks** - System and component health monitoring
60
+ - **Profiling** - Performance metrics and bottleneck detection
61
+ - **Alerts** - Configurable alerting system
62
+ - **Audit Logging** - Comprehensive activity tracking
63
+
64
+ ### 🚀 Deployment (Phase 5.5)
65
+ - **Docker Support** - Production-ready containers
66
+ - **Kubernetes** - Deployment manifests and guides
67
+ - **CI/CD Templates** - GitHub Actions, GitLab CI
68
+ - **Configuration Management** - Environment-based config
67
69
 
68
70
  ## Installation
69
71
 
@@ -117,13 +119,21 @@ const app = workflow.compile();
117
119
 
118
120
  ## Documentation
119
121
 
120
- - [Tool System](./docs/TOOL_SYSTEM.md)
121
- - [LangChain Integration](./docs/LANGCHAIN_INTEGRATION.md)
122
- - [LangGraph Integration](./docs/LANGGRAPH_INTEGRATION.md)
122
+ 📚 **[Full Documentation](https://tvscoundrel.github.io/agentforge/)**
123
+
124
+ ### Core Guides
125
+ - [Getting Started](https://tvscoundrel.github.io/agentforge/guide/getting-started)
126
+ - [Core Concepts](https://tvscoundrel.github.io/agentforge/guide/concepts/tools)
127
+ - [API Reference](https://tvscoundrel.github.io/agentforge/api/core)
128
+
129
+ ### Tutorials
130
+ - [Building Your First Agent](https://tvscoundrel.github.io/agentforge/tutorials/first-agent)
131
+ - [Creating Custom Tools](https://tvscoundrel.github.io/agentforge/tutorials/custom-tools)
132
+ - [Advanced Patterns](https://tvscoundrel.github.io/agentforge/tutorials/advanced-patterns)
123
133
 
124
134
  ## Examples
125
135
 
126
- See the [examples](./examples) directory for complete working examples.
136
+ See the [examples documentation](https://tvscoundrel.github.io/agentforge/examples/react-agent) for complete working examples.
127
137
 
128
138
  ## Development
129
139
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentforge/core",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Core abstractions for AgentForge - production-ready deep agents framework",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",