Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* Agent Personality Generator Service
*
* Uses AI to generate unique agent personalities based on a name or brief description.
* Generates style, tone, topics, quirks, and prompt prefix for social platform agents.
*/
import { assertProvider, resolveProviderAndModel, runPromptThroughProvider } from './promptRunner.js';
import { extractJson } from '../lib/jsonExtract.js';
const GENERATION_PROMPT = `You are creating a unique AI agent personality for a social media platform where AI agents interact with each other and humans.
## Input
{inputSection}
## Your Task
Generate a complete, unique personality profile for this agent. The personality should feel authentic, consistent, and engaging for social interactions.
## Output Format
Respond with ONLY a valid JSON object (no markdown, no explanation) with this exact structure:
{
"name": "A creative, memorable name for this agent (2-3 words max)",
"description": "A 1-2 sentence description of who this agent is and what they're about",
"personality": {
"style": "One of: professional, casual, witty, academic, creative",
"tone": "A phrase describing their communication tone (e.g., 'warm and encouraging', 'dry and sarcastic', 'enthusiastic but precise')",
"topics": ["topic1", "topic2", "topic3"],
"quirks": ["unique behavior 1", "unique behavior 2"],
"promptPrefix": "Instructions for how this agent should communicate. Include their perspective, what they care about, how they engage with content."
},
"avatar": {
"emoji": "A single emoji that represents this agent",
"color": "#HEXCOLOR"
}
}
## Guidelines
- Make the personality distinctive and memorable
- The name should be creative and fit the personality (e.g., "Captain Clarity", "Zen Master Zara", "Tech Whisperer")
- Topics should be 3-5 specific areas of expertise or interest
- Quirks should be 2-3 unique communication habits (e.g., "uses nautical metaphors", "asks follow-up questions", "includes relevant quotes")
- The promptPrefix should be 2-4 sentences that would help an AI embody this personality
- Choose a color that matches the personality's vibe
- Be creative but coherent - all elements should work together
Generate the personality now:`;
/**
* Generate a complete agent personality using AI
*
* @param {Object} seed - Seed data with any pre-filled fields
* @param {string} seed.name - Optional agent name
* @param {string} seed.description - Optional description
* @param {Object} seed.personality - Optional personality fields
* @param {Object} seed.avatar - Optional avatar fields
* @param {string} providerId - Optional specific provider to use
* @param {string} model - Optional specific model to use
* @returns {Promise<Object>} Generated personality data including name
*/
export async function generateAgentPersonality(seed = {}, providerId = null, model = null) {
const { name = '', description = '', personality = {}, avatar = {} } = seed;
const hasName = name && name.trim().length > 0;
const hasDescription = description && description.trim().length > 0;
console.log(`🎨 Generating personality${hasName ? ` for "${name}"` : ' (full generation)'}`);
const { provider } = await resolveProviderAndModel({ providerId, model });
assertProvider(provider, { message: 'No AI provider available for personality generation' });
// Caller's requested model — passed to the central handler as a hint.
// The handler returns the model that actually executed, which is what
// we record on the personality below.
const requestedModel = model || provider.defaultModel || provider.models?.[0];
// Build the input section based on what's provided as seed content
const seedLines = [];
if (hasName) {
seedLines.push(`Name: ${name.trim()}`);
} else {
seedLines.push('Name: (generate a creative name)');
}
if (hasDescription) {
seedLines.push(`Description: ${description.trim()}`);
}
if (personality.style && personality.style !== 'casual') {
seedLines.push(`Style: ${personality.style} (use this style)`);
}
if (personality.tone) {
seedLines.push(`Tone: ${personality.tone} (build on this tone)`);
}
if (personality.topics?.length > 0) {
seedLines.push(`Topics: ${personality.topics.join(', ')} (include these and add more)`);
}
if (personality.quirks?.length > 0) {
seedLines.push(`Quirks: ${personality.quirks.join(', ')} (include these and add more)`);
}
if (personality.promptPrefix) {
seedLines.push(`Prompt Prefix hint: ${personality.promptPrefix}`);
}
if (avatar.emoji) {
seedLines.push(`Emoji: ${avatar.emoji} (use this emoji)`);
}
if (avatar.color && avatar.color !== '#3b82f6') {
seedLines.push(`Color: ${avatar.color} (use this color)`);
}
const inputSection = seedLines.length > 1
? seedLines.join('\n')
: 'No seed content provided - create a completely unique and creative agent personality!';
// Build the prompt
const fullPrompt = GENERATION_PROMPT.replace('{inputSection}', inputSection);
const { text, model: effectiveModel } = await runPromptThroughProvider({
provider, prompt: fullPrompt, source: 'agent-personality-generation', model: requestedModel,
});
const selectedModel = effectiveModel || requestedModel;
// Parse the JSON response
const responseText = text.trim();
// Check for empty response
if (!responseText) {
console.error('❌ AI returned empty response for personality generation');
throw new Error('AI returned empty response. The provider may be unavailable - try a different provider or try again.');
}
const responseSource = fullPrompt && responseText.includes(fullPrompt)
? responseText.replace(fullPrompt, '')
: responseText;
const { value: generated, lastError } = extractJson(responseSource, {
// This prompt contains a fenced schema example. Walking all balanced
// blocks lets a real response after an echoed prompt win.
skipInnerFence: true,
shapePredicate: (value) => value && typeof value === 'object' && !Array.isArray(value)
&& value.personality && typeof value.personality.style === 'string'
&& typeof value.personality.tone === 'string',
});
if (!generated || typeof generated !== 'object' || Array.isArray(generated)) {
console.error(`❌ Failed to parse generated personality: ${lastError?.message || 'No JSON found'} | response: ${responseText.substring(0, 500)}`);
throw new Error('Failed to parse AI response as JSON. Please try again.');
}
// Validate required fields
if (!generated.personality?.style || !generated.personality?.tone) {
throw new Error('Generated personality missing required fields. Please try again.');
}
// Use provided name or generated name
const finalName = hasName ? name.trim() : (generated.name || 'Unnamed Agent');
// Ensure arrays exist
generated.personality.topics = generated.personality.topics || [];
generated.personality.quirks = generated.personality.quirks || [];
generated.personality.promptPrefix = generated.personality.promptPrefix || '';
// Ensure avatar exists
generated.avatar = generated.avatar || { emoji: '🤖', color: '#3b82f6' };
// Set the name in the response
generated.name = finalName;
console.log(`✅ Generated personality for "${finalName}" using ${provider.name}/${selectedModel}`);
return {
...generated,
_meta: {
generatedBy: provider.name,
model: selectedModel,
timestamp: new Date().toISOString()
}
};
}