Helix AgentsComposable AI Agents for TypeScript

import { defineAgent, defineTool } from '@helix-agents/core';
import { JSAgentExecutor, InMemoryStateStore, InMemoryStreamManager } from '@helix-agents/sdk';
import { VercelAIAdapter } from '@helix-agents/llm-vercel';
import { openai } from '@ai-sdk/openai';
import { z } from 'zod';

// Define a tool
const searchTool = defineTool({
  name: 'search',
  description: 'Search the web for information',
  inputSchema: z.object({
    query: z.string().describe('Search query'),
  }),
  outputSchema: z.object({
    results: z.array(z.string()),
  }),
  execute: async ({ query }) => ({
    results: [`Results for: ${query}`],
  }),
});

// Define an agent
const ResearchAgent = defineAgent({
  name: 'researcher',
  systemPrompt: 'You are a helpful research assistant.',
  tools: [searchTool],
  outputSchema: z.object({
    summary: z.string(),
    sources: z.array(z.string()),
  }),
  llmConfig: {
    model: openai('gpt-4o'),
  },
});

// Create infrastructure and execute
const executor = new JSAgentExecutor(
  new InMemoryStateStore(),
  new InMemoryStreamManager(),
  new VercelAIAdapter()
);

const handle = await executor.execute(ResearchAgent, 'Research AI agents');

// Stream results
for await (const chunk of await handle.stream()) {
  if (chunk.type === 'text_delta') {
    process.stdout.write(chunk.delta);
  }
}

const result = await handle.result();
console.log(result.output);