Initial commit
This commit is contained in:
Vendored
+36
@@ -0,0 +1,36 @@
|
||||
/**
|
||||
* OpenRouter LLM Provider
|
||||
* Handles communication with OpenRouter API for LLM interactions
|
||||
*/
|
||||
import { LlmProvider, LlmConfig, ActionRequest, ActionResponse, NarrativeRequest, NarrativeResponse } from '../interfaces/llm';
|
||||
export declare class OpenRouterProvider implements LlmProvider {
|
||||
private apiKey;
|
||||
private model;
|
||||
private client;
|
||||
private temperature;
|
||||
private maxTokens;
|
||||
/**
|
||||
* Initialize the OpenRouter provider with configuration
|
||||
*/
|
||||
initialize(config: LlmConfig): Promise<void>;
|
||||
/**
|
||||
* Translate player input into a structured action for the game engine
|
||||
*/
|
||||
translateAction(request: ActionRequest): Promise<ActionResponse>;
|
||||
/**
|
||||
* Generate narrative prose based on game events
|
||||
*/
|
||||
generateNarrative(request: NarrativeRequest): Promise<NarrativeResponse>;
|
||||
/**
|
||||
* Build the system and user prompts for action translation
|
||||
*/
|
||||
private buildActionPrompt;
|
||||
/**
|
||||
* Build the system and user prompts for narrative generation
|
||||
*/
|
||||
private buildNarrativePrompt;
|
||||
/**
|
||||
* Validate and normalize the action response
|
||||
*/
|
||||
private validateActionResponse;
|
||||
}
|
||||
Vendored
+192
@@ -0,0 +1,192 @@
|
||||
"use strict";
|
||||
/**
|
||||
* OpenRouter LLM Provider
|
||||
* Handles communication with OpenRouter API for LLM interactions
|
||||
*/
|
||||
var __importDefault = (this && this.__importDefault) || function (mod) {
|
||||
return (mod && mod.__esModule) ? mod : { "default": mod };
|
||||
};
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
exports.OpenRouterProvider = void 0;
|
||||
const axios_1 = __importDefault(require("axios"));
|
||||
class OpenRouterProvider {
|
||||
constructor() {
|
||||
this.apiKey = '';
|
||||
this.model = '';
|
||||
this.temperature = 0.7;
|
||||
this.maxTokens = 800;
|
||||
}
|
||||
/**
|
||||
* Initialize the OpenRouter provider with configuration
|
||||
*/
|
||||
async initialize(config) {
|
||||
this.apiKey = config.apiKey;
|
||||
this.model = config.model;
|
||||
this.temperature = config.temperature ?? 0.7;
|
||||
this.maxTokens = config.maxTokens ?? 800;
|
||||
this.client = axios_1.default.create({
|
||||
baseURL: 'https://openrouter.ai/api/v1',
|
||||
headers: {
|
||||
'Authorization': `Bearer ${this.apiKey}`,
|
||||
'Content-Type': 'application/json'
|
||||
}
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Translate player input into a structured action for the game engine
|
||||
*/
|
||||
async translateAction(request) {
|
||||
try {
|
||||
const prompt = this.buildActionPrompt(request);
|
||||
const response = await this.client.post('/chat/completions', {
|
||||
model: this.model,
|
||||
messages: [
|
||||
{
|
||||
role: 'system',
|
||||
content: prompt.system
|
||||
},
|
||||
{
|
||||
role: 'user',
|
||||
content: prompt.user
|
||||
}
|
||||
],
|
||||
temperature: 0.2, // Lower temperature for more deterministic outputs
|
||||
max_tokens: 150,
|
||||
response_format: { type: 'json_object' }
|
||||
});
|
||||
const content = response.data.choices[0].message.content;
|
||||
const parsedResponse = JSON.parse(content);
|
||||
return this.validateActionResponse(parsedResponse);
|
||||
}
|
||||
catch (error) {
|
||||
console.error('Error translating action:', error);
|
||||
// Fallback to a simple "look" action when errors occur
|
||||
return {
|
||||
action: 'look',
|
||||
confidence: 0.5
|
||||
};
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Generate narrative prose based on game events
|
||||
*/
|
||||
async generateNarrative(request) {
|
||||
try {
|
||||
const prompt = this.buildNarrativePrompt(request);
|
||||
const response = await this.client.post('/chat/completions', {
|
||||
model: this.model,
|
||||
messages: [
|
||||
{
|
||||
role: 'system',
|
||||
content: prompt.system
|
||||
},
|
||||
{
|
||||
role: 'user',
|
||||
content: prompt.user
|
||||
}
|
||||
],
|
||||
temperature: this.temperature,
|
||||
max_tokens: this.maxTokens
|
||||
});
|
||||
const content = response.data.choices[0].message.content;
|
||||
// Check if response is JSON format or plain text
|
||||
try {
|
||||
const parsedResponse = JSON.parse(content);
|
||||
return {
|
||||
text: parsedResponse.text,
|
||||
suggestions: parsedResponse.suggestions || []
|
||||
};
|
||||
}
|
||||
catch {
|
||||
// Plain text response, just use the content directly
|
||||
return {
|
||||
text: content
|
||||
};
|
||||
}
|
||||
}
|
||||
catch (error) {
|
||||
console.error('Error generating narrative:', error);
|
||||
return {
|
||||
text: `Something happened, but the narrator is at a loss for words. (Error: ${error instanceof Error ? error.message : String(error)})`
|
||||
};
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Build the system and user prompts for action translation
|
||||
*/
|
||||
buildActionPrompt(request) {
|
||||
const systemPrompt = `You are an AI assistant that translates natural language input into structured action commands for an interactive fiction game.
|
||||
Your task is to convert player input into a JSON object representing an action that can be understood by the game engine.
|
||||
|
||||
The player is currently in the "${request.currentRoom}" room.
|
||||
Visible objects: ${request.visibleObjects.join(', ')}
|
||||
Visible characters: ${request.visibleCharacters.join(', ')}
|
||||
Inventory: ${request.inventory.join(', ')}
|
||||
Available actions: ${request.possibleActions.join(', ')}
|
||||
|
||||
Game context: ${request.gameContext}
|
||||
|
||||
Respond ONLY with a JSON object that follows this structure:
|
||||
{
|
||||
"action": "string", // Name of the action (e.g., "take", "examine", "go", "talk", etc.)
|
||||
"object": "string", // Optional: Primary object of the action
|
||||
"target": "string", // Optional: Secondary object/target of the action
|
||||
"parameters": {}, // Optional: Additional parameters as key-value pairs
|
||||
"confidence": number // How confident you are in this interpretation (0.0-1.0)
|
||||
}
|
||||
|
||||
Choose the action from the list of available actions. If the player's input is ambiguous or doesn't map well to an available action, choose the closest match and set a lower confidence score.`;
|
||||
const userPrompt = request.playerInput;
|
||||
return {
|
||||
system: systemPrompt,
|
||||
user: userPrompt
|
||||
};
|
||||
}
|
||||
/**
|
||||
* Build the system and user prompts for narrative generation
|
||||
*/
|
||||
buildNarrativePrompt(request) {
|
||||
const tone = request.tone || 'descriptive';
|
||||
const systemPrompt = `You are an AI assistant that generates engaging narrative prose for an interactive fiction game.
|
||||
Your task is to describe what happens when a player performs an action in the game world.
|
||||
|
||||
Craft a vivid, ${tone} description that tells the player what happened as a result of their action. Make your prose engaging and atmospheric.
|
||||
|
||||
Current room description: "${request.roomDescription}"
|
||||
Visible objects: ${request.visibleObjects.join(', ')}
|
||||
Visible characters: ${request.visibleCharacters.join(', ')}
|
||||
|
||||
${request.previousContext ? `Previous context: ${request.previousContext}` : ''}
|
||||
|
||||
Respond with engaging prose that describes the outcome of the player's action.
|
||||
You can optionally include 1-3 subtle hints about interesting things to try next.`;
|
||||
const userPrompt = `The player has performed this action: "${request.action}".
|
||||
The result of the action is: "${request.result}".
|
||||
Please describe what happens in an engaging, narrative way.`;
|
||||
return {
|
||||
system: systemPrompt,
|
||||
user: userPrompt
|
||||
};
|
||||
}
|
||||
/**
|
||||
* Validate and normalize the action response
|
||||
*/
|
||||
validateActionResponse(response) {
|
||||
const validatedResponse = {
|
||||
action: typeof response.action === 'string' ? response.action : 'look',
|
||||
confidence: typeof response.confidence === 'number' ? response.confidence : 0.5
|
||||
};
|
||||
if (typeof response.object === 'string') {
|
||||
validatedResponse.object = response.object;
|
||||
}
|
||||
if (typeof response.target === 'string') {
|
||||
validatedResponse.target = response.target;
|
||||
}
|
||||
if (response.parameters && typeof response.parameters === 'object') {
|
||||
validatedResponse.parameters = response.parameters;
|
||||
}
|
||||
return validatedResponse;
|
||||
}
|
||||
}
|
||||
exports.OpenRouterProvider = OpenRouterProvider;
|
||||
//# sourceMappingURL=openrouter-provider.js.map
|
||||
Vendored
+1
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"openrouter-provider.js","sourceRoot":"","sources":["../../src/llm/openrouter-provider.ts"],"names":[],"mappings":"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"}
|
||||
Reference in New Issue
Block a user