71 lines
2.5 KiB
TypeScript
71 lines
2.5 KiB
TypeScript
/**
|
|
* Custom Personas — user-created personas stored as JSON in ~/.waggle/personas/
|
|
* Loaded at startup and merged with built-in PERSONAS.
|
|
*/
|
|
|
|
import fs from 'node:fs';
|
|
import path from 'node:path';
|
|
import type { AgentPersona } from './personas.js';
|
|
|
|
const PERSONAS_DIR = 'personas';
|
|
const INVALID_PORTABLE_ID_CHARACTERS = /[<>:"/\\|?*]/;
|
|
const WINDOWS_RESERVED_BASENAME = /^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])$/i;
|
|
|
|
/** True when an ID is safe as one portable Windows/macOS filename segment. */
|
|
export function isValidCustomPersonaId(id: string): boolean {
|
|
if (id.length === 0 || id.length > 200 || id === '.' || id === '..') return false;
|
|
const hasControlCharacter = [...id].some((character) => {
|
|
const codePoint = character.codePointAt(0) ?? 0;
|
|
return codePoint <= 0x1f || codePoint === 0x7f;
|
|
});
|
|
if (hasControlCharacter || INVALID_PORTABLE_ID_CHARACTERS.test(id) || /[ .]$/.test(id)) return false;
|
|
|
|
// Windows reserves device basenames even when an extension is present.
|
|
const basename = (id.split('.')[0] ?? id).trimEnd();
|
|
return !WINDOWS_RESERVED_BASENAME.test(basename);
|
|
}
|
|
|
|
export function assertValidCustomPersonaId(id: string): void {
|
|
if (!isValidCustomPersonaId(id)) {
|
|
throw new Error('Invalid custom persona ID');
|
|
}
|
|
}
|
|
|
|
export function loadCustomPersonas(dataDir: string): AgentPersona[] {
|
|
const dir = path.join(dataDir, PERSONAS_DIR);
|
|
if (!fs.existsSync(dir)) return [];
|
|
|
|
const personas: AgentPersona[] = [];
|
|
try {
|
|
const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
|
|
for (const file of files) {
|
|
try {
|
|
const content = fs.readFileSync(path.join(dir, file), 'utf-8');
|
|
const persona = JSON.parse(content) as AgentPersona;
|
|
if (persona.id && persona.name && persona.systemPrompt) {
|
|
personas.push(persona);
|
|
}
|
|
} catch { /* skip malformed */ }
|
|
}
|
|
} catch { /* dir read failed */ }
|
|
return personas;
|
|
}
|
|
|
|
export function saveCustomPersona(dataDir: string, persona: AgentPersona): void {
|
|
assertValidCustomPersonaId(persona.id);
|
|
const dir = path.join(dataDir, PERSONAS_DIR);
|
|
if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
|
|
const filePath = path.join(dir, `${persona.id}.json`);
|
|
fs.writeFileSync(filePath, JSON.stringify(persona, null, 2), 'utf-8');
|
|
}
|
|
|
|
export function deleteCustomPersona(dataDir: string, id: string): boolean {
|
|
assertValidCustomPersonaId(id);
|
|
const filePath = path.join(dataDir, PERSONAS_DIR, `${id}.json`);
|
|
if (fs.existsSync(filePath)) {
|
|
fs.unlinkSync(filePath);
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|