@character-foundry/voxta

Voxta package (.voxpkg) reader/writer with multi-character and scenario support.

Installation

npm install @character-foundry/voxta

Features

• Multi-character packages - Read/write packages with multiple characters
• Scenario support - Full VoxtaScenario with Roles, Events, Contexts
• Delta exports - Update packages with minimal changes
• Lorebook preservation - Maintain character book associations

Quick Start

import {
  readVoxta,
  writeVoxta,
  getPackageManifest,
  mergeCharacterEdits,
} from '@character-foundry/voxta';

// Read package
const data = readVoxta(buffer);
const manifest = getPackageManifest(data);
// manifest.characters: [{ id, name }, ...]
// manifest.books: [{ id, name, usedBy: [charIds] }, ...]

// Edit character
const updated = mergeCharacterEdits(data.characters[0], {
  Name: 'New Name',
  Description: 'Updated description',
});

// Write back
const newBuffer = writeVoxta(data, { includePackageJson: true });

Documentation

See docs/voxta.md for full API documentation.

License

MIT