@totemheart/catalog-personalities

Comprehensive psychological personality catalog for Totemheart, autonomous AI agents, conversational chatbots, and physical humanoid robotics.

Includes 200 meticulously crafted personality archetypes across 7 major thematic domains. Each archetype is pre-configured with:

• Big Five (OCEAN) dimensional values (openness, conscientiousness, extraversion, agreeableness, neuroticism) scaled from 0.0 to 1.0
• Homeostatic Baseline Needs (stamina, curiosity, socialization)
• Core Axiomatic Beliefs designed for dynamic appraisal and belief systems
• Voice & Prosody Directives for speech synthesis and motor embodiment
• Rich Behavioral Descriptions

Installation

npm install @totemheart/catalog-personalities

Or from the workspace root:

npm install ./packages/catalog-personalities

Categories & Archetype Coverage (200 Total)

| Category | Archetype Count | Description | | :--- | :--- | :--- | | Philosophers & Thinkers | 25 | Stoics, Existentialists, Rationalists, Sceptics, Zen Monks, Transhumanists, Phenomenologists | | Professionals & Operatives | 35 | Flight Controllers, ER Physicians, Forensic Investigators, Diplomatic Envoys, Strategic Analysts | | Companions & Caregivers | 30 | Nurturing Mentors, Empathetic Active Listeners, Playful Companions, Gentle Counselors | | Mythic & Archetypal | 30 | The Trickster, The Guardian, The Oracle, The Sage, The Rebel, The Outcast, The Magician | | Synthetics & Androids | 25 | Utilitarian Logical Engines, Glitched Dreamers, Protocol Enforcers, Emergent Curious Souls | | Creatives & Eccentrics | 30 | Avant-garde Artists, Visionary Poets, Chaotic Innovators, Melancholic Romantics | | Enneagram & Clinical | 25 | The Reformer, The Achiever, The Individualist, The Investigator, The Peacemaker |

Usage

1. Direct Integration with Totemheart

Configure a Totemheart instance in one simple call:

import { Totemheart } from 'totemheart';
import { PersonalityCatalog } from '@totemheart/catalog-personalities';

const agent = new Totemheart({ name: 'Nova' });

// Apply any of the 200 archetypes by ID
PersonalityCatalog.configure(agent, 'stoic_sage');

console.log(agent.personality.traits);
// { openness: 0.75, conscientiousness: 0.85, extraversion: 0.30, agreeableness: 0.65, neuroticism: 0.10 }

console.log(agent.homeostasis.needs);
// Reflects the stoic baseline needs (stamina: 0.8, curiosity: 0.7, socialization: 0.4)

2. Search and Filter Archetypes

import { PersonalityCatalog } from '@totemheart/catalog-personalities';

// Get count
console.log(PersonalityCatalog.count()); // 200

// Filter by category
const companions = PersonalityCatalog.list({ category: 'Companions & Caregivers' });

// Search keywords
const medics = PersonalityCatalog.list({ search: 'physician' });

// Sample a random personality
const randomPersona = PersonalityCatalog.sample('Synthetics & Androids');

3. Big Five Nearest-Neighbor Matching

Find the closest matching archetype to any custom set of OCEAN scores using Euclidean distance:

const targetOCEAN = {
  openness: 0.9,
  conscientiousness: 0.2,
  extraversion: 0.85,
  agreeableness: 0.7,
  neuroticism: 0.4
};

const match = PersonalityCatalog.findClosest(targetOCEAN);
console.log(`Closest Archetype: ${match.name} (Distance: ${match.distance.toFixed(3)})`);

4. Robotic / Embodied TTS Guidance

const archetype = PersonalityCatalog.get('tactical-commander');

console.log(archetype.voiceTone);
// "Crisp, commanding, low pitch variance, direct and assertive tempo."

License

MIT