Caution

Joggr is shut down. This repository is archived and unmaintained. Do not depend on it for production use.

The published npm package remains available but will receive no further updates.

---

A composable AI microframework built on ai-sdk, curried with funk-tional programming flair.

Features

• ⚡ Functions all the way down — agent, tool, flowAgent are functions returning plain objects.
• 🧩 Composition over configuration — Combine small pieces instead of configuring large ones.
• 🛡️ Result, never throw — Every public method returns Result<T>.
• 🔒 Closures are state — Flow agent state is just variables in your handler.
• 📐 Type-driven design — Zod schemas, discriminated unions, exhaustive matching.

Install

npm install @funkai/agents @funkai/prompts

Usage

Create an agent

import { agent } from "@funkai/agents";
import { openai } from "@ai-sdk/openai";

const writer = agent({
  name: "writer",
  model: openai("gpt-4.1"),
  system: "You are a helpful writer.",
  tools: { search },
});

const result = await writer.generate({ prompt: "Write about closures" });

Define a prompt

---
name: writer
schema:
  tone: string
---
You are a {{ tone }} writer.

Generate typed prompts

npx funkai prompts generate --out .prompts/client --includes "src/agents/**"

Packages

Package	Description
@funkai/agents	Lightweight agent, tool, and flow agent orchestration
@funkai/models	Model catalog, provider resolution, and cost calculations
@funkai/prompts	Prompt SDK with LiquidJS templating, Zod validation, and CLI codegen
@funkai/cli	CLI for the funkai prompt SDK

License

MIT