ai-code-agents 0.1.0 → 0.2.0
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/README.md +15 -16
- package/dist/index.cjs +687 -633
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +256 -575
- package/dist/index.d.ts +256 -575
- package/dist/index.js +751 -648
- package/dist/index.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +21 -6
package/README.md
CHANGED
|
@@ -17,12 +17,14 @@ You will need:
|
|
|
17
17
|
|
|
18
18
|
- Node.js 20+
|
|
19
19
|
- `npm` or another package manager
|
|
20
|
-
- AI SDK
|
|
20
|
+
- AI SDK v6+ and zod v4+ (see below)
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
23
|
npm install ai-code-agents ai zod
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
+
To explore the SDK via a command-line interface, see [`@ai-code-agents/cli`](https://www.npmjs.com/package/@ai-code-agents/cli).
|
|
27
|
+
|
|
26
28
|
## Quick Start
|
|
27
29
|
|
|
28
30
|
```typescript
|
|
@@ -37,7 +39,7 @@ const environment = createEnvironment('docker', {
|
|
|
37
39
|
|
|
38
40
|
// Create an agent with all tools
|
|
39
41
|
const agent = createCodeAgent({
|
|
40
|
-
model: openai('gpt-
|
|
42
|
+
model: openai('gpt-5'),
|
|
41
43
|
environment,
|
|
42
44
|
environmentToolsDefinition: 'all',
|
|
43
45
|
maxSteps: 10,
|
|
@@ -58,23 +60,27 @@ console.log(result.text);
|
|
|
58
60
|
|
|
59
61
|
Environments provide sandboxed execution contexts for agents. All tools are built against environment interfaces, ensuring complete interoperability.
|
|
60
62
|
|
|
61
|
-
**
|
|
63
|
+
**Built-in:**
|
|
62
64
|
|
|
63
65
|
- `docker` - Docker container environments
|
|
64
66
|
- `node-filesystem` - Node.js filesystem operations (read-only recommended)
|
|
65
67
|
- `unsafe-local` - Local filesystem with command execution (development only)
|
|
66
68
|
- `mock-filesystem` - In-memory filesystem for testing
|
|
67
69
|
|
|
70
|
+
**Additional:**
|
|
71
|
+
|
|
72
|
+
- [`@ai-code-agents/just-bash`](https://www.npmjs.com/package/@ai-code-agents/just-bash) - Simulated bash environments using "just-bash"
|
|
73
|
+
- [`@ai-code-agents/vercel-sandbox`](https://www.npmjs.com/package/@ai-code-agents/vercel-sandbox) - Vercel sandbox environments
|
|
74
|
+
|
|
68
75
|
**Planned:**
|
|
69
76
|
|
|
70
77
|
- `e2b` - E2B cloud sandboxes
|
|
71
|
-
- `vercel-sandbox` - Vercel sandbox environments
|
|
72
78
|
|
|
73
79
|
### Tools
|
|
74
80
|
|
|
75
81
|
Tools enable agents to interact with their environments. Each tool has a well-defined purpose with comprehensive input/output validation.
|
|
76
82
|
|
|
77
|
-
**
|
|
83
|
+
**Built-in:**
|
|
78
84
|
|
|
79
85
|
- `read_file` - Read file contents
|
|
80
86
|
- `write_file` - Write or create files
|
|
@@ -102,14 +108,7 @@ Tools enable agents to interact with their environments. Each tool has a well-de
|
|
|
102
108
|
|
|
103
109
|
### Agent Integrations
|
|
104
110
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
- [Vercel AI SDK](https://ai-sdk.dev/) - Integration with AI SDK agents
|
|
108
|
-
|
|
109
|
-
**Planned:**
|
|
110
|
-
|
|
111
|
-
- [Mastra](https://mastra.ai/) - Integration with Mastra agents
|
|
112
|
-
- [AI SDK Tools](https://ai-sdk-tools.dev/) - Integration with AI SDK Tools agents
|
|
111
|
+
The agent infrastructure from the AI SDK is used by default. The `createCodeAgent` function will return an instance of `ToolLoopAgent`.
|
|
113
112
|
|
|
114
113
|
## Usage Examples
|
|
115
114
|
|
|
@@ -158,7 +157,7 @@ const environments = {
|
|
|
158
157
|
|
|
159
158
|
// Configure tools per environment
|
|
160
159
|
const agent = createCodeAgent({
|
|
161
|
-
model: openai('gpt-
|
|
160
|
+
model: openai('gpt-5'),
|
|
162
161
|
environments,
|
|
163
162
|
environmentToolsDefinition: {
|
|
164
163
|
frontend: 'all',
|
|
@@ -206,7 +205,7 @@ Enable agents to signal completion before reaching max steps:
|
|
|
206
205
|
|
|
207
206
|
```typescript
|
|
208
207
|
const agent = createCodeAgent({
|
|
209
|
-
model: openai('gpt-
|
|
208
|
+
model: openai('gpt-5'),
|
|
210
209
|
environment,
|
|
211
210
|
environmentToolsDefinition: 'all',
|
|
212
211
|
maxSteps: 20,
|
|
@@ -233,4 +232,4 @@ const agent = createCodeAgent({
|
|
|
233
232
|
|
|
234
233
|
## Contributing
|
|
235
234
|
|
|
236
|
-
Contributions to the AI Code Agents SDK are welcome and highly appreciated.
|
|
235
|
+
Contributions to the AI Code Agents SDK are welcome and highly appreciated. Please review the [contributing guidelines](https://github.com/felixarntz/ai-code-agents/blob/main/CONTRIBUTING.md) to learn more about how you can contribute.
|