@mk-co/neox-sdk

Neox Agent SDK · Build production-grade AI agents with one-line setup.

🚧 v0.0.0-alpha — API 骨架已就位,impl 将在 v0.1.0 (P8) 填充.

Install

npm install @mk-co/neox-sdk zod

3-line Hello World

import { Agent } from '@mk-co/neox-sdk';

const agent = new Agent({
  model: 'claude-sonnet-4-6',
  systemPrompt: 'You are a helpful coding assistant.',
});

const result = await agent.run('What is 2 + 2?');
console.log(result.text);

With Tools

import { Agent, tool } from '@mk-co/neox-sdk';
import { z } from 'zod';

const weather = tool({
  name: 'get_weather',
  description: 'Get weather for a city',
  schema: z.object({ city: z.string() }),
  handler: async ({ city }) => ({ temp: 22, city }),
});

const agent = new Agent({
  model: 'claude-sonnet-4-6',
  tools: [weather],
});

for await (const event of agent.stream('Weather in Tokyo?')) {
  if (event.type === 'text_delta') process.stdout.write(event.delta);
}

Feature Set

| Feature | v0.0.0-alpha | v0.1.0 (P8) | v1.0.0 | |---------|:---:|:---:|:---:| | Agent.run() / .stream() | 🟡 stub | ✅ | ✅ | | tool() with Zod | ✅ | ✅ | ✅ | | Multi-provider (Anthropic/OpenAI/DeepSeek/...) | — | ✅ | ✅ | | Session + checkpoint/resume | 🟡 stub | ✅ | ✅ | | Sub-agents (handoffs) | — | ✅ | ✅ | | MCP support | — | ✅ | ✅ | | Built-in tools (fs/shell/web) | 🟡 stub | ✅ | ✅ | | Headless server + client SDK | — | ✅ | ✅ | | Testing helpers (mockLlm / replay) | 🟡 stub | ✅ | ✅ | | Middleware (auth / rateLimit) | — | — | ✅ |

API Docs

See NEOX_SDK_V1_API.md for the full contract.

License

MIT