Agentic Kit Monorepo

A provider-portable LLM toolkit with structured streaming, model registries, cross-provider message normalization, and an optional stateful agent runtime.

Packages

• agentic-kit — low-level portability layer with model descriptors, registries, structured event streams, and compatibility helpers
• @agentic-kit/agent — minimal stateful runtime with sequential tool execution and lifecycle events
• @agentic-kit/ollama — adapter for local Ollama inference
• @agentic-kit/anthropic — adapter for Anthropic Claude models
• @agentic-kit/openai — generalized adapter for OpenAI-compatible chat completion APIs

Getting Started

git clone git@github.com:constructive-io/agentic-kit.git
cd agentic-kit
pnpm install
pnpm build
pnpm test

Usage

import { complete, getModel } from "agentic-kit";

const model = getModel("openai", "gpt-4o-mini");
const message = await complete(model!, {
  messages: [{ role: "user", content: "Hello", timestamp: Date.now() }],
});

console.log(message.content);

Consuming from webpack / Next.js

The packages publish ESM with .js-suffixed relative imports (e.g. from './foo.js'), which is the correct ESM-with-TS pattern. Webpack does not auto-rewrite .js → .ts when reading TypeScript sources directly (e.g. when linking the workspace from apps/), so add an extensionAlias to your next.config.mjs:

// next.config.mjs
export default {
  transpilePackages: [
    'agentic-kit',
    '@agentic-kit/agent',
    '@agentic-kit/react',
    '@agentic-kit/openai',
    '@agentic-kit/anthropic',
    '@agentic-kit/ollama',
  ],
  webpack: (config) => {
    config.resolve.extensionAlias = {
      '.js': ['.ts', '.tsx', '.js'],
      '.mjs': ['.mts', '.mjs'],
    };
    return config;
  },
};

Once a published artifact is installed (npm install agentic-kit), the compiled dist/ is what resolves and no extensionAlias is required — this workaround only matters when reading TypeScript source through webpack.

Vite, Bun, and esbuild handle .js → .ts natively. Vite users who want to consume the workspace TypeScript source via the package "source" condition can opt in with:

// vite.config.ts
export default {
  resolve: {
    conditions: ['source', 'import', 'module', 'browser', 'default'],
  },
};

Contributing

See individual package READMEs for docs and local dev instructions.

Testing

Default tests stay deterministic and local:

pnpm test

There is also a local-only Ollama live lane that does not hit hosted providers. The default root command runs the fast smoke tier:

OLLAMA_LIVE_MODEL=qwen3.5:4b pnpm test:live:ollama

Run the broader lane explicitly when you want slower behavioral coverage:

OLLAMA_LIVE_MODEL=qwen3.5:4b pnpm test:live:ollama:extended

The Ollama live script performs a preflight against OLLAMA_BASE_URL and exits cleanly if the local server or requested model is unavailable. If nomic-embed-text:latest is installed, the lane also exercises local embedding generation.