CodeAgent

Agent that generates, executes, reviews and refactors code with a pluggable executor

CodeAgent generates, executes, reviews, and refactors code, and only runs code when you name an explicit executor.

Quick Start

1. Run code with an explicit executor

   import { CodeAgent, createSubprocessExecutor } from 'praisonai';
   
   const agent = new CodeAgent({
     name: 'Coder',
     code: {
       executor: createSubprocessExecutor(),   // opt-in real runner
       allowedLanguages: ['python'],
       timeout: 20,
     },
   });
   
   const result = await agent.execute('print(2 + 2)', 'python');
   console.log(result.output);   // "4\n"
   console.log(result.success);  // true

2. Generate, review and refactor

   const code = await agent.generate('Write a function to reverse a string');
   const review = await agent.review(code);
   const better = await agent.refactor(code, 'add type hints');

Why an explicit executor?

Execution is granted by naming a runner, never by flipping a boolean.

Without code.executor, execute() returns { success: false, error: 'No code executor is configured...' }. This is deliberate, so model-generated code cannot silently run in-process.

const agent = new CodeAgent({ name: 'Coder' }); // no executor

const result = await agent.execute('print(2 + 2)', 'python');
console.log(result.success); // false
console.log(result.error);   // "No code executor is configured, so 'python' code was not run. ..."

How It Works

CodeConfig

createSubprocessExecutor()

createSubprocessExecutor() is a ready-made out-of-process runner.

import { CodeAgent, createSubprocessExecutor } from 'praisonai';

const agent = new CodeAgent({
  code: { executor: createSubprocessExecutor() },
});

Default interpreter map:

• Runs a detached child on non-Windows so the timeout kills the whole process group.
• Truncates output live during streaming, not after close.
• An unregistered language returns { success: false, error: "No interpreter is registered for '<lang>'. Known: ..." }.

Writing your own executor

Supply a CodeExecutor to target a container, microVM, e2b, or a remote sandbox service.

import { CodeAgent, type CodeExecutor, type CodeExecutorContext } from 'praisonai';

const remoteExecutor: CodeExecutor = async (code, language, context: CodeExecutorContext) => {
  // Send code to your container / microVM / remote sandbox
  return {
    success: true,
    output: '...',
    exitCode: 0,
    executionTime: 0.1,
  };
};

const agent = new CodeAgent({ code: { executor: remoteExecutor } });

The CodeExecutor signature:

type CodeExecutor = (
  code: string,
  language: string,
  context: CodeExecutorContext,
) => Promise<CodeExecutionResult>;

CodeExecutorContext carries sandbox, timeout, workingDirectory, environment, and maxOutputLength.

Best Practices

Related