Agent with Sub-Agents

​

Overview

• Coordinator (app/agent.ts) — routes users to the right specialist
• Math specialist (app/agents/math.ts) — performs arithmetic using the calculate tool
• Text specialist (app/agents/text.ts) — analyzes text using the word-count tool

​

Project Structure

sub-agents/
├── aixyz.config.ts           # Agent metadata and skills
├── app/
│   ├── agent.ts              # Coordinator agent → /agent
│   ├── agents/
│   │   ├── math.ts           # Math sub-agent → /math/agent
│   │   └── text.ts           # Text sub-agent → /text/agent
│   ├── tools/
│   │   ├── calculate.ts      # Arithmetic tool (add/subtract/multiply/divide)
│   │   └── word-count.ts     # Text analysis tool (words/characters/sentences)
│   └── icon.png
├── package.json
└── vercel.json

​

Endpoints

​

Sub-Agent Definition

import { openai } from "@ai-sdk/openai";
import { stepCountIs, ToolLoopAgent } from "ai";
import type { Accepts } from "aixyz/accepts";
import calculate from "../tools/calculate";

export const accepts: Accepts = { scheme: "exact", price: "$0.001" };

export default new ToolLoopAgent({
  model: openai("gpt-4o-mini"),
  instructions: "You are a math specialist...",
  tools: { calculate },
  stopWhen: stepCountIs(5),
});

​

Key Features

• Auto-discovery — All .ts files in app/agents/ are automatically registered
• Independent endpoints — Each sub-agent gets its own A2A endpoint and agent card
• Shared tools via MCP — Tools in app/tools/ are exposed on a single /mcp endpoint
• Mixed deployment — app/agent.ts and app/agents/ can coexist in the same project

​

Running

cd examples/sub-agents
bun install
bun run dev