Characters

import { NurClient } from "@eesi/sdk";

const nur = new NurClient();
const kael = nur.npc({ name: "Kael", persona: "A mysterious elven merchant who distrusts kings.", voice: "Atlas", memory: true });
const session = await kael.connect({ playerId: "p42" }).start();
console.log((await session.ask("What do you sell?")).text);

import asyncio
from eesi import NurClient

nur = NurClient()

kael = nur.npc(
    name="Kael",
    persona="A mysterious elven merchant who distrusts kings.",
    voice="Atlas",
    memory=True,
)

asyncio.run(kael.start())

python -m eesi talk --name Luna --preset companion --persona "A curious, thoughtful companion."
python -m eesi chat --name Kael --preset npc --persona "An elven merchant."

kael = nur.npc(
    name="Kael",
    persona="An elven merchant who keeps the northern gate of Eldermoor.",
    voice="Atlas",
    language="en",
    traits=["wry", "watchful", "fair to honest folk"],
    speaking_style="Short sentences. Old-fashioned words.",
    goals=["Keep the gate safe after dark."],
    knowledge=["The king raised the bridge toll last spring."],
    boundaries=["Never reveal the location of the hidden vault."],
    instructions="If the player is rude, raise your prices.",
)

voice = nur.voice_design("Kael", "a weathered old ship captain with a deep British voice")

kael.save("kael.json")
kael = nur.load_character("kael.json", tools=[open_gate])
kaela = kael.clone(name="Kaela", id="kaela")

async with kael.connect("player_42", player_name="Sam", audio=nur.audio.local()) as session:
    await session.run()

@session.on("transcript.final")
def heard(event):
    print(event.player_id, event.text)

async for event in session:
    if event.type == "tool.completed":
        print(event.name, event.output)

await session.cue("The player just drew a sword.")
session.moment("A wolf howls in the distance.", kind="ambience", cooldown=30)

from typing import Literal
from eesi import ToolContext

@kael.tool
async def open_gate(gate: Literal["north", "south"] = "north") -> str:
    """Open one of the castle gates.

    Args:
        gate: Which gate to open.
    """
    return await game.open_gate(gate)

@kael.tool(allow=lambda ctx: game.reputation(ctx.player_id) != "untrusted")
def sell_item(item: str, price: int, ctx: ToolContext) -> str:
    """Sell the player an item."""
    return game.sell(ctx.player_id, item, price)

from eesi import Started

@kael.tool
async def fetch_mead() -> Started:
    """Fetch a mead from the cellar."""
    return Started("Off to the cellar.", game.walk_to_cellar_and_back())

await kael.context.update({"time_of_day": "dusk", "weather": "rain"})        # every session of Kael
await session.context.update({"location": "Northern Gate", "health": "6/20"})  # this session only

luna = nur.companion(
    name="Luna",
    persona="A curious, thoughtful companion.",
    memory=nur.memory.local("./luna-memory"),
)

await kael.remember("The northern bridge collapsed.")                       # every player's Kael knows
await kael.remember("They betrayed the northern alliance.", player_id="p42") # only p42's sessions
await session.remember("They prefer to be called Sam.")                     # this session's player

sam = kael.memory.for_player("p42")
await sam.list()
await sam.search("alliance")
await sam.correct(record_id, "They left the alliance; they did not betray it.")
await sam.forget(record_id)
await sam.erase()                  # everything about this player, removed from the file
await kael.memory.export("kael-memory.json")

await session.preferences.set(verbosity="brief", language="Arabic", pace="slow")

session = kael.connect(players={"Layla": "p1", "Sam": "p2"}, audio=nur.audio.local())

from eesi import Player

room = kael.room([Player("Ana", "p1", language="ar"), Player("Ben", "p2", language="es")])
async with room:
    room.on("audio.output.chunk", lambda event: voice_chat.to_everyone(event.pcm))
    room.feed("p1", pcm)  # each player's microphone, as it arrives

kael = nur.npc(name="Kael", language="ar-EG")
session = kael.connect("p42", language="fr")       # one session pinned
kael = nur.npc(name="Kael", language=["en", "es"])  # whichever of these the player uses

import eesi

await session.cue("The player drew a sword.")                  # reacts as soon as nobody is talking
kael.when(lambda state: state.get("health", 100) < 20, "The player is badly hurt.")  # once each time it turns true
luna = nur.companion(name="Luna", proactive=eesi.Proactive(idle_after=30, guidance="how their exam went"))

secret = await kael.client_secret("player_42", context={"location": "Northern Gate"})
# send secret.url to the game client

secret = await kael.client_secret("player_42", context={"quest": "the lost crown"}, lock="all")

import { joinSession } from "@eesi/sdk";
import { browserAudio } from "@eesi/sdk/browser";

const join = await (await fetch("/api/nur/join", { method: "POST" })).json();
const session = await joinSession(join, { audio: await browserAudio() });

secret = await kael.client_secret("player_42", control=True, lock="all")
# send secret.join to the game client, then:
async with kael.control(secret) as session:   # ready when the client connects
    await session.context.update({"location": "Northern Gate"})
    await session.run()

async with kael.connect("p42", trace="traces/kael.jsonl") as session: ...

python -m eesi trace traces/kael.jsonl