客户端 → executeApi("someApi")
              ↓
         子 agent（服务端内部）
              ↓ ReAct 循环
         外部 MCP 工具调用 × N 步
              ↓
         汇总结果返回客户端

/src
  /agents                 # 子 agent 基础设施
    llm-provider.ts       # LLM Provider（OpenAI 协议兼容）
    kb-mcp-client.ts      # 示例：知识库 MCP 客户端（stdio 单例）
    kb-sub-agent.ts       # 示例：知识库 ReAct 子 agent
  /apis                   # 业务 API（按分类子目录）
  /config
    api-config.ts         # API 分类等全局配置
  /core
    registry.ts           # API 注册中心
    loader.ts             # 动态加载机制
    server.ts             # MCP Streamable HTTP 服务器
  index.ts                # 入口文件

# 构建并启动
npm run start

# 仅构建
npm run build

import { z } from "zod";
import { ApiCategories } from "../../config/api-config";

export default {
  id: "yourApiId",
  name: "你的 API 名称",
  description: "API 功能描述",
  category: ApiCategories.COMMON,
  // 若 handler 内部使用了子 agent 并会推送进度通知，声明此字段
  // supportsProgress: true,
  schema: {
    param1: z.string().describe("参数说明"),
    param2: z.number().optional().describe("可选参数"),
  },
  handler: async ({ param1, param2 = 0 }, context) => {
    // context.onProgress 可用于推送进度通知
    return JSON.stringify({ result: `${param1}, ${param2}` });
  },
  examples: [
    { description: "示例", params: { param1: "test" } }
  ],
};