@iqai/adk 0.0.4 โ†’ 0.0.6

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@iqai/adk",
3
- "version": "0.0.4",
3
+ "version": "0.0.6",
4
4
  "description": "Agent Development Kit for TypeScript with multi-provider LLM support",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -21,11 +21,11 @@
21
21
  "license": "MIT",
22
22
  "dependencies": {
23
23
  "@anthropic-ai/sdk": "^0.39.0",
24
- "@clack/prompts": "^0.10.1",
25
24
  "@electric-sql/pglite": "^0.3.2",
26
25
  "@google-cloud/vertexai": "^0.5.0",
27
26
  "@google/genai": "^1.0.0",
28
27
  "@modelcontextprotocol/sdk": "^1.11.1",
28
+ "@types/better-sqlite3": "^7.6.13",
29
29
  "axios": "^1.6.2",
30
30
  "dotenv": "^16.4.7",
31
31
  "drizzle-orm": "^0.43.1",
@@ -34,22 +34,13 @@
34
34
  "zod": "^3.22.4"
35
35
  },
36
36
  "devDependencies": {
37
- "@changesets/cli": "^2.29.2",
38
- "@biomejs/biome": "1.9.4",
39
37
  "@types/node": "^20.17.30",
40
- "gh-pages": "^6.3.0",
41
- "lint-staged": "^15.5.2",
42
- "prettier": "^3.1.0",
43
- "rimraf": "^5.0.5",
44
- "ts-node": "^10.9.1",
45
- "tsconfig-paths": "^4.2.0",
46
- "tsx": "^4.19.4",
47
38
  "tsup": "^8.4.0",
48
- "typedoc": "^0.28.2",
49
- "typedoc-plugin-markdown": "^4.6.2",
50
39
  "typescript": "^5.3.2",
51
- "vitest": "^3.1.3"
40
+ "vitest": "^3.1.3",
41
+ "@iqai/tsconfig": "0.0.1"
52
42
  },
43
+ "packageManager": "pnpm@9.0.0",
53
44
  "engines": {
54
45
  "node": ">=22.0"
55
46
  },
@@ -61,29 +52,13 @@
61
52
  "LICENSE",
62
53
  "README.md"
63
54
  ],
64
- "lint-staged": {
65
- "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
66
- "biome check --write --organize-imports-enabled=false --no-errors-on-unmatched"
67
- ]
68
- },
69
55
  "publishConfig": {
70
56
  "access": "public"
71
57
  },
72
58
  "scripts": {
73
59
  "build": "tsup",
74
60
  "test": "vitest run",
75
- "format": "biome format . --write",
76
- "lint": "lint-staged --allow-empty",
77
- "lint:all": "biome check . --write --organize-imports-enabled=true",
78
- "clean": "rimraf dist",
79
- "docs": "typedoc --out docs src/index.ts || exit 0",
80
- "docs:serve": "npx http-server docs",
81
- "docs:markdown": "typedoc --plugin typedoc-plugin-markdown",
82
- "predeploy": "npm run docs",
83
- "deploy:docs": "gh-pages -d docs",
84
- "example": "tsx examples/index.ts",
85
61
  "test:watch": "vitest",
86
- "test:coverage": "vitest run --coverage",
87
- "release": "pnpm build && changeset publish"
62
+ "test:coverage": "vitest run --coverage"
88
63
  }
89
64
  }
package/LICENSE DELETED
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Agent Development Kit (ADK) Contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
package/README.md DELETED
@@ -1,260 +0,0 @@
1
- <div align="center">
2
- <img src="adk-typescript.jpg" alt="ADK TypeScript Logo" width="100%"/>
3
-
4
- <p align="center">
5
- A robust framework for building AI agents with multi-provider LLM support
6
- </p>
7
-
8
- <p align="center">
9
- <a href="https://www.npmjs.com/package/@iqai/adk">
10
- <img src="https://img.shields.io/npm/v/@iqai/adk" alt="npm version" />
11
- </a>
12
- <a href="https://www.npmjs.com/package/@iqai/adk">
13
- <img src="https://img.shields.io/npm/dm/@iqai/adk" alt="npm downloads" />
14
- </a>
15
- <a href="https://github.com/IQAIcom/adk-ts/blob/main/LICENSE">
16
- <img src="https://img.shields.io/npm/l/@iqai/adk" alt="license" />
17
- </a>
18
- <a href="https://github.com/IQAIcom/adk-ts">
19
- <img src="https://img.shields.io/github/stars/IQAIcom/adk-ts?style=social" alt="github stars" />
20
- </a>
21
- </p>
22
-
23
- <p align="center">
24
- <a href="https://pontus-devoteam.github.io/adk-typescript/" target="_blank">
25
- <img src="https://img.shields.io/badge/Docs-View_Documentation-blue?style=for-the-badge&logo=readthedocs" alt="View Documentation" />
26
- </a>
27
- </p>
28
- </div>
29
-
30
- ## ๐Ÿš€ Features
31
-
32
- - **๐Ÿค– Multi-provider Support**: Seamlessly switch between OpenAI, Anthropic, or Google LLMs
33
- - **๐Ÿ› ๏ธ Tool System**: Create and use custom tools with declarative schemas
34
- - **๐Ÿ”„ Agent Loop**: Complete implementation of the agent reasoning loop with tool execution
35
- - **๐Ÿ“ก Streaming Support**: Real-time streaming responses from LLMs
36
- - **๐Ÿ”’ Authentication**: Flexible auth system for secure API access
37
- - **๐Ÿ’พ Memory Systems**: Persistent memory capabilities for stateful agents
38
-
39
- ## ๐Ÿ“š Quick Start
40
-
41
- ### 1. Installation
42
-
43
- ```bash
44
- # Using npm
45
- npm install @iqai/adk
46
-
47
- # Using yarn
48
- yarn add @iqai/adk
49
-
50
- # Using pnpm
51
- pnpm add @iqai/adk
52
- ```
53
-
54
- ### 2. Configure Environment
55
-
56
- Create a `.env` file in your project root with your API keys:
57
-
58
- ```env
59
- OPENAI_API_KEY=your_openai_api_key_here
60
- ANTHROPIC_API_KEY=your_anthropic_api_key_here
61
- GOOGLE_API_KEY=your_google_api_key_here
62
- ```
63
-
64
- ### 3. Create Your First Agent
65
-
66
- ```typescript
67
- import { Agent } from '@iqai/adk';
68
- import dotenv from 'dotenv';
69
-
70
- // Load environment variables
71
- dotenv.config();
72
-
73
- // Create a basic agent
74
- const agent = new Agent({
75
- name: "simple_assistant",
76
- model: "gemini-2.5-flash-preview-05-20", // Or "gpt-4-turbo" or "claude-3-opus"
77
- description: "A simple assistant",
78
- instructions: "You are a helpful assistant. Answer questions concisely."
79
- });
80
-
81
- // Run the agent
82
- async function main() {
83
- const response = await agent.run({
84
- messages: [{ role: 'user', content: 'Hello, who are you?' }]
85
- });
86
-
87
- console.log(response.content);
88
- }
89
-
90
- main().catch(console.error);
91
- ```
92
-
93
- ## ๐Ÿ“– Documentation
94
-
95
- **[View Full Documentation](https://pontus-devoteam.github.io/adk-typescript/)**
96
-
97
- Our comprehensive documentation includes:
98
-
99
- - Complete API reference
100
- - Architecture overview
101
- - Integration guides
102
- - Advanced usage examples
103
- - Provider-specific configurations
104
-
105
- ## ๐Ÿ—๏ธ Project Status
106
-
107
- โš ๏ธ **Early Development Stage**
108
-
109
- This project is currently in early development and should be considered alpha software. While it's functional and can be used in projects, you may encounter:
110
-
111
- - Breaking changes between versions
112
- - APIs that may evolve based on user feedback
113
- - Features that are still being stabilized
114
-
115
- Current development status:
116
-
117
- - โœ… Core agent framework
118
- - โœ… Basic OpenAI implementation
119
- - โœ… Initial Anthropic integration
120
- - โœ… Initial Google/Gemini integration
121
- - โœ… Tool system foundation
122
- - โœ… Basic memory system
123
- - ๐Ÿšง Enhanced error handling
124
- - ๐Ÿšง Improved type safety
125
- - ๐Ÿšง Extended provider features
126
- - ๐Ÿšง Advanced memory capabilities
127
- - โฌœ Comprehensive testing suite
128
- - โฌœ Performance optimizations
129
- - โฌœ Advanced streaming features
130
-
131
- We welcome feedback, bug reports, and contributions! Please check the [issues page](https://github.com/IQAIcom/adk-ts/issues) for known issues or to report new ones.
132
-
133
- ## ๐Ÿ“š Usage Examples
134
-
135
- ### Agent with Tools
136
-
137
- ```typescript
138
- import { Agent, BaseTool } from '@iqai/adk';
139
-
140
- // Create a custom calculator tool
141
- class CalculatorTool extends BaseTool {
142
- constructor() {
143
- super({
144
- name: 'calculator',
145
- description: 'Perform basic calculations'
146
- });
147
- }
148
-
149
- getDeclaration() {
150
- return {
151
- name: this.name,
152
- description: this.description,
153
- parameters: {
154
- type: 'object',
155
- properties: {
156
- operation: {
157
- type: 'string',
158
- enum: ['add', 'subtract', 'multiply', 'divide']
159
- },
160
- a: { type: 'number' },
161
- b: { type: 'number' }
162
- },
163
- required: ['operation', 'a', 'b']
164
- }
165
- };
166
- }
167
-
168
- async runAsync(args) {
169
- const { operation, a, b } = args;
170
-
171
- switch(operation) {
172
- case 'add': return { result: a + b };
173
- case 'subtract': return { result: a - b };
174
- case 'multiply': return { result: a * b };
175
- case 'divide': return { result: a / b };
176
- default: throw new Error(`Unknown operation: ${operation}`);
177
- }
178
- }
179
- }
180
-
181
- // Create an agent with the tool
182
- const agent = new Agent({
183
- name: "calculator_assistant",
184
- model: "gpt-4-turbo",
185
- instructions: "You can perform calculations. Use the calculator tool when asked about math.",
186
- tools: [new CalculatorTool()]
187
- });
188
-
189
- // Run the agent
190
- const response = await agent.run({
191
- messages: [{ role: 'user', content: 'What is 24 * 7?' }]
192
- });
193
- ```
194
-
195
- ### Agent with Memory
196
-
197
- ```typescript
198
- import { Agent, PersistentMemoryService } from '@iqai/adk';
199
- import path from 'path';
200
-
201
- // Create a memory service
202
- const memoryService = new PersistentMemoryService({
203
- storageDir: path.join(__dirname, '.memory'),
204
- createDir: true
205
- });
206
-
207
- // Create an agent with memory
208
- const agent = new Agent({
209
- name: "memory_assistant",
210
- model: "gemini-2.5-flash-preview-05-20",
211
- instructions: "You have persistent memory. Remember user preferences.",
212
- memoryService,
213
- userId: 'user-123'
214
- });
215
-
216
- // Run the agent with a session ID for persistence
217
- const response = await agent.run({
218
- messages: [{ role: 'user', content: 'Remember that I like blue.' }],
219
- sessionId: 'persistent-session-1'
220
- });
221
- ```
222
-
223
- ## ๐Ÿงช Example Projects
224
-
225
- The `examples/` directory contains several example implementations:
226
-
227
- ```bash
228
- # Run simple agent example
229
- npm run example:simple
230
-
231
- # Run tool usage example
232
- npm run example:tool
233
-
234
- # Run memory usage example
235
- npm run example:memory
236
-
237
- # Run multi-provider example
238
- npm run example:multi
239
-
240
- # Run Anthropic tool example
241
- npm run example:anthropic
242
- ```
243
-
244
- ## ๐Ÿค Contributing
245
-
246
- We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
247
-
248
- 1. Fork the repository
249
- 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
250
- 3. Commit your changes (`git commit -m 'Add some amazing feature'`)
251
- 4. Push to the branch (`git push origin feature/amazing-feature`)
252
- 5. Open a Pull Request
253
-
254
- ## ๐Ÿ“„ License
255
-
256
- This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
257
-
258
- ## ๐ŸŒŸ Show your support
259
-
260
- Give a โญ๏ธ if this project helped you!