@platanai/core

Agent orchestration, provider ports, and Zod schemas for platan.ai. This package is the library the @platanai/cli is built on. Most users want the CLI, not this package directly — consume @platanai/core when you're embedding the agent or its image tools in your own Node app.

What's inside

• Config loader — walks up from cwd to find platanai.config.{ts,mjs,js}, validates with Zod, returns a typed LoadedConfig.
• Provider ports + adapters — ImageProvider (generate/edit) and TextProvider (JSON output) with first-party Gemini + OpenAI adapters behind simple registries.
• Agent runtime — runChatTurn, routeIntent, createAgentRuntime. Transport-agnostic — HTTP/CLI/desktop all wrap these.
• Image tools — pure-function sharp wrappers: flipHorizontal, resizeImage, removeBackground, trimImage, tintImage, etc.
• Storage ports — SessionStore + ImageStore with in-memory and filesystem adapters.
• Browser-safe schemas — import from @platanai/core/schemas in frontend code (no sharp or server-only deps pulled in).

Install

npm install @platanai/core

Quick usage

import {
  createAgentRuntime,
  createImageProviderGetter,
  createIntentRouterGetter,
  FsImageStore,
  InMemorySessionStore,
  loadConfig,
} from "@platanai/core";

const config = await loadConfig();
const runtime = createAgentRuntime({
  sessions: new InMemorySessionStore(),
  images: new FsImageStore(),
});
const getImageProvider = createImageProviderGetter(config);
const getIntentRouter = createIntentRouterGetter(config);

const session = runtime.createSession();
await runtime.runChatTurn({
  intentRouter: getIntentRouter(),
  imageProvider: getImageProvider(),
  sessionId: session.id,
  message: "a pixel art sword",
  onEvent: (ev) => console.log(ev),
  imageUrl: (sid, iid) => `/img/${sid}/${iid}`,
});

Adding a new LLM provider

Drop an adapter in adapters/<vendor>-image-provider.ts (or <vendor>-text-provider.ts), add a case to the matching registry switch, and widen the model union in config.schema.ts. Config users pick it via:

providers: {
  image: { provider: "anthropic", model: "...", apiKey: process.env... },
}

Supported today: gemini, openai.

Browser-safe schemas

import {
  PublicLoadedConfigSchema,
  ToolCallSchema,
} from "@platanai/core/schemas";

This entry has no server-only dependencies — safe to import from a Vite/Webpack bundle.

Links

• Source
• platan.ai
• @platanai/cli

License

Apache-2.0.