AI Text Generator

Text generation workers for game content including narratives, dialogue, item descriptions, quest text, NPC backstories, and environment descriptions.

Installation

npm install @gamevault/ai-text-generator

Usage

import { getTextWorkerRegistry, handleTextGeneration } from '@gamevault/ai-text-generator';

// Get registry and generate text
const registry = getTextWorkerRegistry();
const worker = registry.get('gemini-2.5-flash');

const result = await worker.generate({
  prompt: 'Write a short fantasy item description for a magical sword',
  taskType: 'itemDescription',
  maxTokens: 500,
  temperature: 0.7,
});

// Or use the route handler
const response = await handleTextGeneration({
  prompt: 'Write a quest called "The Lost Temple" with 3 objectives',
  taskType: 'questText',
}, 'basic');

Models

| Model | Description | Best For | |-------|-------------|----------| | gemini-2.5-flash-lite | Fast, cost-effective | Simple descriptions, short text | | gemini-2.5-flash | Balanced performance | Most text generation tasks | | gemini-3.1-flash | Premium quality | Complex narratives, dialogue |

Task Types

• narrative - Story, lore, and world-building text
• dialogue - Character dialogue and conversations
• itemDescription - Item, equipment, and loot descriptions
• questText - Quest objectives and descriptions
• npcBackstory - NPC background and personality
• environment - Location and environment descriptions

API Routes

The package exports route handlers for use in Fastify/Next.js:

• handleTextGeneration(body, tier) - Generate text
• handleBatchTextGeneration(items, tier, model?) - Batch generation
• handleListModels(tier) - List available models
• handleHealthCheck() - Worker health status

Environment Variables

• GOOGLE_AI_API_KEY - Google AI API key for Gemini access