@agentforge/tools 0.16.22 → 0.16.24

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 +56 -50
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,16 +1,16 @@
1
1
  # @agentforge/tools
2
2
 
3
- > Production-ready tools collection for AgentForge - 88 tools for web, data, file, utility, and agent operations
3
+ > Production-ready tools collection for AgentForge - 94 tools for web, data, file, utility, and agent operations
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/@agentforge/tools)](https://www.npmjs.com/package/@agentforge/tools)
6
6
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
7
7
  [![License](https://img.shields.io/badge/license-MIT-green)](../../LICENSE)
8
8
 
9
- ## 🎉 Status: Production Ready & Published
9
+ ## Status: Production Ready & Published
10
10
 
11
- **88 production-ready tools** | **Full TypeScript support** | **Comprehensive documentation** | **LangChain compatible**
11
+ **94 production-ready tools** | **Full TypeScript support** | **Comprehensive documentation** | **LangChain compatible**
12
12
 
13
- ## 📦 Installation
13
+ ## Installation
14
14
 
15
15
  ```bash
16
16
  npm install @agentforge/tools
@@ -36,25 +36,25 @@ pnpm add mysql2
36
36
  pnpm add better-sqlite3 @types/better-sqlite3
37
37
  ```
38
38
 
39
- ## 🎯 Overview
39
+ ## Overview
40
40
 
41
- This package provides **88 ready-to-use tools** organized into 5 categories:
41
+ This package provides **94 ready-to-use tools** organized into 5 categories:
42
42
 
43
- - **🌐 Web Tools** (22 tools) - HTTP requests, web search, web scraping, HTML parsing, URL manipulation, Slack integration, Confluence integration
44
- - **📊 Data Tools** (25 tools) - JSON, CSV, XML processing, data transformation, and Neo4j graph database with embeddings
45
- - **📁 File Tools** (18 tools) - File operations, directory management, path utilities
46
- - **🔧 Utility Tools** (22 tools) - Date/time, strings, math, validation
47
- - **🤖 Agent Tools** (1 tool) - Human-in-the-loop and agent interaction
43
+ - **Web Tools** (22 tools) - HTTP requests, web search, web scraping, HTML parsing, URL manipulation, Slack integration, Confluence integration
44
+ - **Data Tools** (32 tools) - JSON, CSV, XML processing, data transformation, Neo4j graph database, and relational database operations
45
+ - **File Tools** (17 tools) - File operations, directory management, path utilities
46
+ - **Utility Tools** (22 tools) - Date/time, strings, math, validation
47
+ - **Agent Tools** (1 tool) - Human-in-the-loop and agent interaction
48
48
 
49
49
  All tools feature:
50
- - ✅ Full TypeScript support with type inference
51
- - ✅ Zod schema validation
52
- - ✅ Comprehensive error handling
53
- - ✅ Detailed documentation and examples
54
- - ✅ LangChain compatibility
55
- - ✅ Production-tested and ready
50
+ - Full TypeScript support with type inference
51
+ - Zod schema validation
52
+ - Comprehensive error handling
53
+ - Detailed documentation and examples
54
+ - LangChain compatibility
55
+ - Production-tested and ready
56
56
 
57
- ## 🚀 Quick Start
57
+ ## Quick Start
58
58
 
59
59
  ```typescript
60
60
  import { httpGet, jsonParser, fileReader, calculator } from '@agentforge/tools';
@@ -83,9 +83,9 @@ const result = await calculator.invoke({
83
83
  });
84
84
  ```
85
85
 
86
- ## 📚 Tool Categories
86
+ ## Tool Categories
87
87
 
88
- ### 🌐 Web Tools (22 tools)
88
+ ### Web Tools (22 tools)
89
89
 
90
90
  Tools for web interactions, HTTP operations, and integrations.
91
91
 
@@ -129,7 +129,7 @@ Tools for web interactions, HTTP operations, and integrations.
129
129
  - **`archiveConfluencePage`** - Archive pages (move to trash)
130
130
  - **`createConfluenceTools()`** - Factory function for custom Confluence configuration
131
131
 
132
- ### 📊 Data Tools (18 tools)
132
+ ### Data Tools (32 tools)
133
133
 
134
134
  Tools for data processing and transformation.
135
135
 
@@ -169,7 +169,15 @@ Tools for data processing and transformation.
169
169
  - **`neo4jVectorSearchWithEmbedding`** - Semantic search with automatic embedding generation
170
170
  - **`neo4jCreateNodeWithEmbedding`** - Create nodes with automatic embeddings
171
171
 
172
- ### 📁 File Tools (18 tools)
172
+ #### Relational Database Tools
173
+ - **`relationalQuery`** - Execute raw SQL with vendor-aware connections
174
+ - **`relationalSelect`** - Build and execute SELECT queries
175
+ - **`relationalInsert`** - Insert rows into relational tables
176
+ - **`relationalUpdate`** - Update rows in relational tables
177
+ - **`relationalDelete`** - Delete rows from relational tables
178
+ - **`relationalGetSchema`** - Inspect relational database schema metadata
179
+
180
+ ### File Tools (17 tools)
173
181
 
174
182
  Tools for file system operations.
175
183
 
@@ -196,7 +204,7 @@ Tools for file system operations.
196
204
  - **`pathRelative`** - Get relative path
197
205
  - **`pathNormalize`** - Normalize paths
198
206
 
199
- ### 🔧 Utility Tools (22 tools)
207
+ ### Utility Tools (22 tools)
200
208
 
201
209
  General utility tools for common operations.
202
210
 
@@ -230,7 +238,7 @@ General utility tools for common operations.
230
238
  - **`ipValidator`** - Validate IPv4/IPv6 addresses
231
239
  - **`uuidValidator`** - Validate UUIDs
232
240
 
233
- ## 💡 Usage Examples
241
+ ## Usage Examples
234
242
 
235
243
  ### Web Search Example
236
244
 
@@ -299,8 +307,8 @@ SERPER_API_KEY=your-serper-api-key-here
299
307
 
300
308
  | Feature | DuckDuckGo (Free) | Serper (Premium) |
301
309
  |---------|-------------------|------------------|
302
- | **API Key** | ❌ Not required | ✅ Required ([get key](https://serper.dev)) |
303
- | **Cost** | 🆓 Free | 💰 Paid (see [pricing](https://serper.dev/pricing)) |
310
+ | **API Key** | Not required | Required ([get key](https://serper.dev)) |
311
+ | **Cost** | Free | Paid (see [pricing](https://serper.dev/pricing)) |
304
312
  | **Search Engine** | DuckDuckGo | Google |
305
313
  | **Rate Limits** | Generous | Based on plan |
306
314
  | **Result Quality** | Good | Excellent (Google results) |
@@ -695,7 +703,7 @@ const card = await creditCardValidator.invoke({
695
703
  console.log(card.valid); // true (passes Luhn check)
696
704
  ```
697
705
 
698
- ## 🔗 Using with LangChain
706
+ ## Using with LangChain
699
707
 
700
708
  All tools are compatible with LangChain through the `@agentforge/core` integration:
701
709
 
@@ -711,7 +719,7 @@ const langchainJsonParser = toLangChainTool(jsonParser);
711
719
  const tools = [langchainHttpGet, langchainJsonParser];
712
720
  ```
713
721
 
714
- ## 📖 API Reference
722
+ ## API Reference
715
723
 
716
724
  ### Tool Structure
717
725
 
@@ -761,7 +769,7 @@ const result = await httpGet.invoke({
761
769
  console.log(result.data);
762
770
  ```
763
771
 
764
- ## 🏗️ Code Organization
772
+ ## Code Organization
765
773
 
766
774
  All tools follow a consistent directory structure pattern for better maintainability and discoverability:
767
775
 
@@ -841,7 +849,7 @@ Available factory functions:
841
849
  - `createMathOperationTools(config?)` - Math operation tools
842
850
  - `createValidationTools(config?)` - Validation tools
843
851
 
844
- ## 🛠️ Development
852
+ ## Development
845
853
 
846
854
  ```bash
847
855
  # Install dependencies
@@ -860,43 +868,43 @@ pnpm typecheck
860
868
  pnpm lint
861
869
  ```
862
870
 
863
- ## 📊 Tool Statistics
871
+ ## Tool Statistics
864
872
 
865
- - **Total Tools**: 81
873
+ - **Total Tools**: 94
866
874
  - **Web Tools**: 22 (includes 4 Slack tools + 7 Confluence tools)
867
- - **Data Tools**: 18
868
- - **File Tools**: 18
875
+ - **Data Tools**: 32
876
+ - **File Tools**: 17
869
877
  - **Utility Tools**: 22
870
878
  - **Agent Tools**: 1
871
879
  - **Lines of Code**: ~4,000
872
- - **Full TypeScript Support**: ✅
873
- - **Zod Validation**: ✅
874
- - **LangChain Compatible**: ✅
880
+ - **Full TypeScript Support**: Yes
881
+ - **Zod Validation**: Yes
882
+ - **LangChain Compatible**: Yes
875
883
 
876
- ## 🤝 Contributing
884
+ ## Contributing
877
885
 
878
886
  Contributions are welcome! Please see the main AgentForge repository for contribution guidelines.
879
887
 
880
- ## 📄 License
888
+ ## License
881
889
 
882
890
  MIT © 2026 Tom Van Schoor
883
891
 
884
- ## 📖 Documentation
892
+ ## Documentation
885
893
 
886
- - 📚 **[Full Documentation](https://tvscoundrel.github.io/agentforge/)**
887
- - 🚀 **[Quick Start](https://tvscoundrel.github.io/agentforge/guide/quick-start)**
888
- - 🛠️ **[Tools API Reference](https://tvscoundrel.github.io/agentforge/api/tools)**
889
- - 💡 **[Custom Tools Tutorial](https://tvscoundrel.github.io/agentforge/tutorials/custom-tools)**
890
- - 📦 **[Examples](https://tvscoundrel.github.io/agentforge/examples/custom-tools)**
894
+ - **[Full Documentation](https://tvscoundrel.github.io/agentforge/)**
895
+ - **[Quick Start](https://tvscoundrel.github.io/agentforge/guide/quick-start)**
896
+ - **[Tools API Reference](https://tvscoundrel.github.io/agentforge/api/tools)**
897
+ - **[Custom Tools Tutorial](https://tvscoundrel.github.io/agentforge/tutorials/custom-tools)**
898
+ - **[Examples](https://tvscoundrel.github.io/agentforge/examples/custom-tools)**
891
899
 
892
- ## 🔗 Links
900
+ ## Links
893
901
 
894
902
  - [GitHub Repository](https://github.com/TVScoundrel/agentforge)
895
903
  - [npm Package](https://www.npmjs.com/package/@agentforge/tools)
896
904
  - [Changelog](https://tvscoundrel.github.io/agentforge/changelog.html) - See what's new before upgrading
897
905
  - [Report Issues](https://github.com/TVScoundrel/agentforge/issues)
898
906
 
899
- ## 📚 Related Packages
907
+ ## Related Packages
900
908
 
901
909
  - [@agentforge/core](https://www.npmjs.com/package/@agentforge/core) - Core abstractions
902
910
  - [@agentforge/patterns](https://www.npmjs.com/package/@agentforge/patterns) - Agent patterns
@@ -905,6 +913,4 @@ MIT © 2026 Tom Van Schoor
905
913
 
906
914
  ---
907
915
 
908
- **Built with ❤️ by the AgentForge Team**
909
-
910
-
916
+ **Built with love by the AgentForge Team**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentforge/tools",
3
- "version": "0.16.22",
3
+ "version": "0.16.24",
4
4
  "description": "Tool library for TypeScript AI agents: web, data, file, and integration tools (HTTP, scraping, CSV, XML/JSON, Slack, databases).",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -18,7 +18,7 @@
18
18
  "README.md"
19
19
  ],
20
20
  "dependencies": {
21
- "@agentforge/core": "0.16.22",
21
+ "@agentforge/core": "0.16.24",
22
22
  "@slack/web-api": "^7.13.0",
23
23
  "axios": "^1.7.9",
24
24
  "cheerio": "^1.0.0",