import { LewNPC } from 'lewnpc';

const client = new LewNPC({
  apiKey: process.env.LEWNPC_API_KEY,
});

// Create an NPC with Big Five personality traits
const edric = await client.createNPC({
  id: "edric_blacksmith",
  role: "Village blacksmith and veteran of the Northern War",
  backstory: "Lost his partner Maren to an avalanche on the northern pass. Quiet but warm once trust is earned.",
  traits: {
    openness: 0.3,         // Traditional, practical
    conscientiousness: 0.8, // Meticulous craftsman
    extraversion: 0.5,     // Opens up over time
    agreeableness: 0.7,    // Kind but not a pushover
    neuroticism: 0.2,      // Steady, rarely rattled
  },
});

// Send a player message
const response = await client.message({
  npc_id: "edric_blacksmith",
  player_id: "player_7f2a",
  message: "I need a sword for the northern pass.",
});

console.log(response.text);
// "The northern pass? That route's been closed since the avalanche took
//  Maren's caravan. I can forge you a short blade — but you'll want a
//  cloak more than a sword up there."

console.log(response.emotion);       // "concerned"
console.log(response.memory_delta);  // ["Player intends to travel the northern pass", ...]
console.log(response.memory_count);  // 2
console.log(response.latency_ms);    // 174

// Next session — same npc_id + player_id, different day
const laterResponse = await client.message({
  npc_id: "edric_blacksmith",
  player_id: "player_7f2a",
  message: "I made it back from the pass.",
});

console.log(laterResponse.text);
// "Ha! Told you about the cloak, didn't I? Maren would've said the same —
//  she knew those mountains better than anyone. Come, let me see that blade."

console.log(laterResponse.emotion); // "warm"

const client = new LewNPC({
  apiKey: string,      // required — get one at lewnpc.com
  baseUrl?: string,    // default: https://api.lewnpc.com/v1
  timeout?: number,    // default: 30000ms
});

await client.createNPC({
  id: string,                  // unique ID — you choose it
  role: string,                // character role/title
  backstory?: string,          // optional backstory
  traits: {
    openness: number,          // 0.0–1.0
    conscientiousness: number,
    extraversion: number,
    agreeableness: number,
    neuroticism: number,
  },
  initial_memories?: string[], // optional seed memories
  metadata?: object,           // arbitrary data, not used by model
});

await client.message({
  npc_id: string,       // which NPC
  player_id: string,    // which player — memory is per (npc, player) pair
  message: string,      // the player's message
  context?: string,     // optional per-turn context ("Player just defeated the boss")
  temperature?: number, // default: 0.7
  max_tokens?: number,  // default: 512
});

{
  text: string,          // the NPC's dialogue
  emotion: string,       // current emotional state ("warm", "concerned", "nostalgic", ...)
  memory_delta: string[], // what the NPC learned this turn
  memory_count: number,  // total memories held for this player
  latency_ms: number,    // actual inference time
  model: string,         // "lewis-2.0"
}

const { memories, total } = await client.listMemories({
  npc_id: "edric_blacksmith",
  player_id: "player_7f2a",
  limit: 50,   // optional, default 50
  offset: 0,   // optional, for pagination
});

memories.forEach(m => console.log(`[Turn ${m.turn}] ${m.content}`));
// [Turn 1] Player intends to travel the northern pass
// [Turn 1] Player may not know about the avalanche
// [Turn 3] Player survived the northern pass
// [Turn 3] Relationship: strengthening — shared experience

await client.resetMemory({
  npc_id: "edric_blacksmith",
  player_id: "player_7f2a",
});

import { LewNPC, LewNPCError, LewNPCRateLimitError, LewNPCAuthError } from 'lewnpc';

try {
  const response = await client.message({ ... });
} catch (err) {
  if (err instanceof LewNPCAuthError) {
    console.error("Invalid API key — get one at lewnpc.com");
  } else if (err instanceof LewNPCRateLimitError) {
    console.error(`Rate limited. Retry after ${err.retryAfter}s`);
  } else if (err instanceof LewNPCError) {
    console.error(`LewNPC error ${err.status}: ${err.message} (${err.code})`);
  } else {
    throw err;
  }
}