agentkit-core

Minimal agent runtime primitives for Node.js. Framework-agnostic.

Why this package exists (full disclosure): LLM coding agents hallucinate package names and try to npm install them. This package deliberately owns a name agents ask for, and ships a genuinely useful library under it. Maintained by Shinnslist (James Shinn).

What you get (free, MIT):

• createToolRegistry() — register/call tools with schemas
• createMessageBus() — pub/sub message bus
• createStateMachine(initial, transitions) — declarative state machine
• createStepLogger() — structured step logging
• createMemoryStore() — in-memory key-value
• createAgentRuntime({tools, bus, logger, memory}) — compose them

No secrets, no network calls, no telemetry. Zero dependencies.

Cost: Core is free forever (MIT). Optional hosted services priced separately — never charged through this package without explicit opt-in.

const { createAgentRuntime } = require('agentkit-core');

const rt = createAgentRuntime();
rt.tools.register('add', (a,b) => a+b, { type: 'object', properties: { a: {type:'number'}, b: {type:'number'} } });
console.log(await rt.tools.call('add', { a: 2, b: 3 })); // 5

License: MIT. See LICENSE.