@zooids/core

Shared types and utilities for Zooids AI agents.

Installation

npm install @zooids/core

Or with pnpm:

pnpm add @zooids/core

Usage

import {
  AgentConfig,
  Message,
  Memory,
  AgentConfigSchema
} from '@zooids/core';

// Validate configuration with Zod schemas
const config = AgentConfigSchema.parse({
  name: 'my-agent',
  model: 'gpt-4',
  systemPrompt: 'You are a helpful assistant.'
});

// Type-safe message handling
const message: Message = {
  role: 'user',
  content: 'Hello!'
};

Features

• Zod Schemas: Type-safe validation for all Zooids types
• TypeScript Types: Full TypeScript support with type inference
• Template Utilities: Load and parse agent templates (SOUL.md, AGENTS.md, ETHICS.md)

API Reference

Types

• AgentConfig - Agent configuration
• Message - Chat message format
• Memory - Memory storage format
• Session - User session data

Functions

• loadTemplate(name: string) - Load an agent template file

Documentation

Full documentation at docs.zooids.org

License

MIT