@onioneko/kiki-types

Kiki · Middleware framework for LLM agents

Shared conversation types for the Kiki middleware ecosystem.

npm install @onioneko/kiki-types

Core's Context is an open map. This package defines the conversation structure that LLM middleware operates on.

Exports

• Message — { role: "user" | "assistant", content: string | ContentBlock[] }
• ConversationContext — Extends Context with messages: Message[] and optional system: string
• ContentBlock — TextBlock | ImageBlock for multi-modal messages
• TextBlock — { type: "text", text: string }
• ImageBlock — { type: "image", source: { type, media_type, data } }

Usage

import type { ConversationContext, Message } from "@onioneko/kiki-types";

const ctx: ConversationContext = {
  messages: [{ role: "user", content: "hello" }],
  system: "You are helpful.",
};

// Multi-modal message with image
const imageMsg: Message = {
  role: "user",
  content: [
    { type: "text", text: "What is in this image?" },
    { type: "image", source: { type: "base64", media_type: "image/png", data: "..." } },
  ],
};

Design

• Zero runtime dependencies (beyond @onioneko/kiki-core for the Context type)
• System prompt is ctx.system, not in the messages array
• content: string is the common case; ContentBlock[] enables multi-modal