ai-code-agents 0.1.0-beta.1 → 0.1.0

package/README.md

@@ -13,10 +13,14 @@ A TypeScript SDK for creating AI agents that interact with sandboxed code execut
 
 ## Installation
 
-You will need Node.js 20+ and npm or another package manager installed on your local machine.
+You will need:
+
+- Node.js 20+
+- `npm` or another package manager
+- AI SDK v5+ and zod v4+ (see below)
 
 ```bash
-npm install ai-code-agents
+npm install ai-code-agents ai zod
 ```
 
 ## Quick Start
@@ -37,10 +41,11 @@ const agent = createCodeAgent({
   environment,
   environmentToolsDefinition: 'all',
   maxSteps: 10,
+  logStep: (log: string) => console.log(log),
 });
 
 // Run the agent
-const result = await agent.execute({
+const result = await agent.generate({
   prompt: 'Create a simple Node.js HTTP server in server.js',
 });
 
@@ -119,7 +124,7 @@ const environment = createEnvironment('unsafe-local', {
 });
 
 const agent = createCodeAgent({
-  model: anthropic('claude-3-5-sonnet-20241022'),
+  model: anthropic('claude-sonnet-4.5'),
   environment,
   environmentToolsDefinition: 'basic', // Read/write only, no deletions
   maxSteps: 15,
@@ -128,7 +133,7 @@ const agent = createCodeAgent({
   },
 });
 
-const result = await agent.execute({
+const result = await agent.generate({
   prompt: 'Create a Python script that calculates fibonacci numbers',
 });
 ```
@@ -162,7 +167,7 @@ const agent = createCodeAgent({
   maxSteps: 20,
 });
 
-const result = await agent.execute({
+const result = await agent.generate({
   prompt: 'Create a React frontend and Flask backend for a todo app',
 });
 ```
@@ -178,7 +183,7 @@ const environment = createEnvironment('node-filesystem', {
 });
 
 const agent = createCodeAgent({
-  model: google('gemini-2.0-flash-exp'),
+  model: google('gemini-2.5-pro'),
   environment,
   environmentToolsDefinition: [
     'read_file',
@@ -215,7 +220,7 @@ Track agent execution with detailed step logs:
 
 ```typescript
 const agent = createCodeAgent({
-  model: anthropic('claude-3-5-sonnet-20241022'),
+  model: anthropic('claude-sonnet-4.5'),
   environment,
   environmentToolsDefinition: 'all',
   maxSteps: 15,

package/dist/index.cjs

@@ -84,6 +84,10 @@ __export(index_exports, {
   RunCommandToolInput: () => RunCommandToolInput,
   RunCommandToolName: () => RunCommandToolName,
   RunCommandToolOutput: () => RunCommandToolOutput,
+  SubmitTool: () => SubmitTool,
+  SubmitToolInput: () => SubmitToolInput,
+  SubmitToolName: () => SubmitToolName,
+  SubmitToolOutput: () => SubmitToolOutput,
   UnsafeLocalEnvironment: () => UnsafeLocalEnvironment,
   UnsafeLocalEnvironmentName: () => UnsafeLocalEnvironmentName,
   WriteFileResult: () => WriteFileResult,
@@ -110,6 +114,12 @@ function escapeCommandArg(arg) {
   return `'${arg.replace(/'/g, "'\\''")}'`;
 }
 
+// src/util/escape-command.ts
+function escapeCommand(command) {
+  const escaped = command.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+  return `"${escaped}"`;
+}
+
 // src/util/validate-relative-path.ts
 var path = __toESM(require("path"), 1);
 function validateRelativePath(filePath) {
@@ -413,7 +423,7 @@ var DockerEnvironment = class extends UnixEnvironmentBase {
   async executeCommand(command) {
     return new Promise((resolve) => {
       (0, import_node_child_process.exec)(
-        `docker exec ${this._envConfig.containerId} ${this._commandPrefix}${command}`,
+        `docker exec ${this._envConfig.containerId} sh -c ${escapeCommand(this._commandPrefix + command)}`,
         (error, stdout, stderr) => {
           const exitCode = error ? error.code ?? 1 : 0;
           resolve([exitCode, stdout, stderr]);
@@ -2200,9 +2210,6 @@ var WriteFileTool = class extends EnvironmentToolBase {
   }
 };
 
-// src/agent-creators.ts
-var import_ai = require("ai");
-
 // src/tools/submit-tool.ts
 var import_zod12 = require("zod");
 var SubmitToolName = "submit";
@@ -2257,6 +2264,9 @@ var SubmitTool = class extends ToolBase {
   }
 };
 
+// src/agent-creators.ts
+var import_ai = require("ai");
+
 // src/instructions.ts
 function getAdditionalInstructions(config) {
   const { maxSteps, allowSubmit, tools } = config;
@@ -2503,18 +2513,18 @@ function createCodeAgent(agentConfig) {
           `No tools definition provided for environment "${environmentName}". Please provide a tools definition for each environment.`
         );
       }
-      const environmentTools2 = createToolsForNamedEnvironment(
+      const envTools = createToolsForNamedEnvironment(
         environmentName,
         environment,
         environmentToolsDefinition[environmentName]
       );
-      for (const [toolName, tool] of Object.entries(environmentTools2)) {
-        if (toolName in environmentTools2) {
+      for (const [toolName, tool] of Object.entries(envTools)) {
+        if (toolName in environmentTools) {
           throw new Error(
             `Tool name conflict: The tool name "${toolName}" from environment "${environmentName}" is already used by another environment's tools.`
           );
         }
-        environmentTools2[toolName] = tool;
+        environmentTools[toolName] = tool;
       }
     }
   } else if ("environment" in remainingConfig) {
@@ -2672,6 +2682,10 @@ function createEnvironment(environmentName, config) {
   RunCommandToolInput,
   RunCommandToolName,
   RunCommandToolOutput,
+  SubmitTool,
+  SubmitToolInput,
+  SubmitToolName,
+  SubmitToolOutput,
   UnsafeLocalEnvironment,
   UnsafeLocalEnvironmentName,
   WriteFileResult,