Openrouter-sdk NPM

Agent Wizard

A step-by-step interface for building and orchestrating AI agents. Create, configure, and connect AI agents through an intuitive wizard interface.

Quick Start

Install dependencies:

npm install

Build the TypeScript files:

npm run build

Start the server:

npm start

Visit http://localhost:3000

Building Agents

The wizard guides you through 5 steps to create an agent:

Basic Configuration
- Name your agent
- Describe its purpose
- Choose agent type (researcher/analyst/assistant/executor)
Capabilities
- Select available tools (web search, file access, etc.)
- Choose memory type (none/short-term/long-term)
- Pick language model (GPT-3.5/GPT-4/Claude-3)
Behavior Configuration
- Set personality type (professional/friendly/direct)
- Configure autonomy level (1-5)
- Define response style (concise/detailed/analytical)
Integration Setup
- Define input/output formats
- Set up triggers and event handlers
- Configure data transformations
Testing & Validation
- Add test cases
- Define success criteria
- Set fallback behavior

Development

For development with auto-reload:

npm run dev

Watch TypeScript files:

npm run build:watch

File Structure

├── src/
│   ├── utils/
│   │   ├── agent-wizard.js      # Core wizard functionality
│   │   └── function-wizard.js   # Function building utilities
│   │
│   ├── examples/
│   │   ├── wizard-dashboard.html # Main wizard interface
│   │   ├── server.js            # Development server
│   │   └── agent-templates.js   # Pre-built agent templates
│   │
│   └── types/                   # TypeScript definitions
│
├── start.sh        # Quick start script for macOS/Linux
├── start.bat      # Quick start script for Windows
├── package.json   # Project configuration
└── tsconfig.json  # TypeScript configuration

Creating Agent Templates

Create new agent templates in src/examples/agent-wizard-templates.js:

wizard.defineFunction('customAgent')
  .description('Your custom agent')
  .parameter('input', 'string', 'Input data', true)
  .parameter('options', 'object', 'Configuration options', false)
  .implement(async ({ input, options = {} }) => {
    // Agent implementation
    const result = await processInput(input, options);
    return result;
  })
  .register();

Orchestrating Agents

Connect multiple agents in a workflow:

const workflow = wizard.createWorkflow('myWorkflow', 'Research and Analysis', [
  {
    source: 'researchAgent',
    target: 'analysisAgent',
    config: {
      transformation: {
        rules: [
          {
            condition: data => Boolean(data),
            transform: data => ({ analysis: data })
          }
        ]
      }
    }
  }
]);

// Execute workflow
const results = await wizard.executeWorkflow('myWorkflow', {
  topic: 'AI trends in 2025'
});

Error Handling

The wizard includes built-in error handling and logging:

Invalid configurations are caught early
Runtime errors are logged with full context
Fallback behaviors can be defined per agent
Workflow errors include full execution trace

Customization

Extend the wizard by: 1. Adding new agent types in agent-wizard.js 2. Creating custom templates in agent-templates.js 3. Defining new field types in wizard-dashboard.html 4. Adding workflow patterns in function implementations

Example: Adding a New Agent Type

// In agent-wizard.js
class CustomAgentType extends BaseAgent {
  constructor(config) {
    super(config);
    this.customFeature = config.customFeature;
  }

  async execute(input) {
    // Custom implementation
    return result;
  }
}

// Register the new type
AgentWizard.registerAgentType('custom', CustomAgentType);