The Clerk's Back Room

` +\n `

Only the broadcaster or an approved moderator may adjust these settings.

` +\n `

`,\n 200,\n { \"set-cookie\": stateCookie },\n );\n}\n\nfunction renderAdminDashboard(\n login: string,\n currentChannel: string,\n allChannels: string[],\n flags: Record,\n): Response {\n const channelTabs = allChannels.map((c) => {\n const isCurrent = c === currentChannel;\n const style = isCurrent\n ? \"display:inline-block;padding:6px 14px;margin:0 6px 6px 0;background:#9146FF;color:white;border-radius:6px;text-decoration:none;font-weight:bold;\"\n : \"display:inline-block;padding:6px 14px;margin:0 6px 6px 0;background:#eee;color:#333;border-radius:6px;text-decoration:none;\";\n return `#${c}`;\n }).join(\"\");\n\n const rows = FEATURE_DEFS.map((def) => {\n const enabled = flags[def.key];\n const nextValue = enabled ? \"0\" : \"1\";\n const statusColor = enabled ? \"#2e7a3e\" : \"#7a2e2e\";\n const btnColor = enabled ? \"#7a2e2e\" : \"#2e7a3e\";\n const btnLabel = enabled ? \"Turn off\" : \"Turn on\";\n return `\n \n \n ${def.label}
\n ${def.description}\n \n \n ${\n enabled ? \"ON\" : \"OFF\"\n }\n \n \n \n \n `;\n }).join(\"\");\n\n return adminPage(\n `

The Clerk's Back Room

` +\n `

Signed in as ${login} — sign out

` +\n `

Settings for:

` +\n `

${channelTabs}

` +\n `${rows}

` +\n `

These settings apply only to #${currentChannel} — other channels the Clerk serves keep their own. Changes take effect within a few minutes.

`,\n );\n}\n\ninterface CommandEntry {\n name: string;\n desc: string;\n}\ninterface CommandSection {\n title: string;\n commands: CommandEntry[];\n}\n\nconst COMMAND_SECTIONS: CommandSection[] = [\n {\n title: \"Getting Started\",\n commands: [\n { name: \"!help\", desc: \"The Clerk points you to this very ledger.\" },\n {\n name: \"!start\",\n desc: \"A quick status check, plus a hint at what to do next.\",\n },\n {\n name: \"!enlist <name>\",\n desc:\n \"Have your name entered on the rolls and begin your legend. Try !enlist random if you'd rather the Clerk pick a name for you.\",\n },\n ],\n },\n {\n title: \"Character & Combat\",\n commands: [\n {\n name: \"!chars\",\n desc:\n \"Read your character sheet — level, HP, AC, gold, and gear. !ledger works too.\",\n },\n {\n name: \"!chars <username>\",\n desc:\n \"Peek at someone else's sheet instead, e.g. !chars thistle_the_bold (their Twitch username, not their character's name).\",\n },\n {\n name: \"!hunt\",\n desc: \"Fight a level-appropriate monster for XP and gold.\",\n },\n {\n name: \"!hunt <monster name>\",\n desc:\n \"Seek out a specific monster by name, e.g. !hunt wolf — useful for working a bounty on the Quest Board.\",\n },\n {\n name: \"!autohunt\",\n desc:\n \"Chain fights automatically until you level up or need to rest. !auto works too.\",\n },\n { name: \"!rest\", desc: \"Recover to full health.\" },\n ],\n },\n {\n title: \"The Merchant's Stall\",\n commands: [\n {\n name: \"!merchant\",\n desc: \"See what's currently for sale. !shop works too.\",\n },\n {\n name: \"!buy <#|item name>\",\n desc:\n \"Purchase an offer from the stall, e.g. !buy 1 or !buy rapier.\",\n },\n {\n name: \"!sell <item>\",\n desc:\n \"Sell an item from your pack back to the stall for half its purchase price.\",\n },\n {\n name: \"!coinpurse\",\n desc:\n \"Check your gold, and whether you can afford anything on offer. !purse works too.\",\n },\n {\n name: \"!inventory\",\n desc: \"See everything you're carrying. !inv works too.\",\n },\n {\n name: \"!item\",\n desc:\n \"Look up the full details on whatever you're currently wielding or wearing.\",\n },\n {\n name: \"!item <item name>\",\n desc:\n \"Look up any item by name, whether you own it or not, e.g. !item greataxe. !iteminfo works too.\",\n },\n {\n name: \"!use <item>\",\n desc: \"Drink a potion, or equip a weapon or armor.\",\n },\n { name: \"!drop <item>\", desc: \"Discard an item from your pack.\" },\n ],\n },\n {\n title: \"The Quest Board\",\n commands: [\n {\n name: \"!quests\",\n desc:\n \"See the current bounties and your progress toward each. !board or !questboard work too.\",\n },\n {\n name: \"(auto turn-in)\",\n desc:\n \"Complete a bounty by hunting its target monster enough times — the reward is paid out the moment it's met, no extra command needed.\",\n },\n ],\n },\n {\n title: \"Starting Over\",\n commands: [\n {\n name: \"!discharge confirm\",\n desc:\n \"Retire your current character for good, so you can enlist a new one. The Clerk asks you to confirm first if you just say !discharge.\",\n },\n ],\n },\n {\n title: \"For Moderators & the Broadcaster\",\n commands: [\n {\n name: \"!clerkchannels\",\n desc: \"List every channel the Clerk currently serves. Open to anyone.\",\n },\n {\n name: \"!clerkjoin <channel>\",\n desc:\n \"Have the Clerk set up a desk in another channel. That channel's broadcaster must have already granted permission via the one-click invite link.\",\n },\n {\n name: \"!clerkleave <channel>\",\n desc: \"Stop the Clerk from replying in a channel.\",\n },\n ],\n },\n];\n\nfunction commandsGuidePage(): Response {\n const sectionsHtml = COMMAND_SECTIONS.map((section) => `\n

${section.title}

${c.name}: ${c.desc}

\n `).join(\"\");\n\n const html = `\n\n\n\n\nThe Wandering Clerk's Ledger\n\n\n\n\n\n

The Wandering Clerk's Ledger

Being a Complete Charter of Commands for Hunt & Hoard

\n ${sectionsHtml}\n \n

\n\n`;\n\n return new Response(html, {\n status: 200,\n headers: { \"content-type\": \"text/html\" },\n });\n}\n\nfunction json(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data), {\n status,\n headers: { \"content-type\": \"application/json\" },\n });\n}\n\nfunction isAuthorized(req: Request): boolean {\n return !!API_SECRET &&\n req.headers.get(\"authorization\") === `Bearer ${API_SECRET}`;\n}\n\nexport default async function (req: Request): Promise {\n const url = new URL(req.url);\n const path = url.pathname.replace(/\\/{2,}/g, \"/\");\n\n if (path === \"/commands\") {\n return commandsGuidePage();\n }\n\n // --- Moderator-locked admin panel ---\n if (path === \"/admin\") {\n const login = await verifySession(req);\n if (!login) return renderAdminSignIn(req);\n const extraChannels = await getChannels();\n const allChannels = [\n HOME_CHANNEL,\n ...extraChannels.filter((c) => c !== HOME_CHANNEL),\n ];\n // A channel's own broadcaster only gets a tab for their own channel;\n // only super admins (you, or ADMIN_USERNAMES) can browse every channel\n // the Clerk serves.\n const visibleChannels = isSuperAdmin(login)\n ? allChannels\n : allChannels.filter((c) => c === login);\n const requested = (url.searchParams.get(\"channel\") || \"\").toLowerCase();\n const currentChannel = visibleChannels.includes(requested)\n ? requested\n : (visibleChannels[0] || HOME_CHANNEL);\n const flags = await getFeatureFlags(currentChannel);\n return renderAdminDashboard(login, currentChannel, visibleChannels, flags);\n }\n\n if (path === \"/admin/callback\") {\n const error = url.searchParams.get(\"error\");\n if (error) {\n return adminPage(`

Sign-in cancelled

${error}

`, 400);\n }\n\n const returnedState = url.searchParams.get(\"state\");\n const expectedState = getCookie(req, \"hh_admin_state\");\n const clearStateCookie =\n `hh_admin_state=; HttpOnly; Secure; SameSite=Strict; Path=/admin; Max-Age=0`;\n if (\n !returnedState || !expectedState ||\n !timingSafeEqual(returnedState, expectedState)\n ) {\n return adminPage(\n `

Sign-in failed

Couldn't verify this sign-in request. Go back to /admin and try again.

`,\n 400,\n { \"set-cookie\": clearStateCookie },\n );\n }\n\n const code = url.searchParams.get(\"code\");\n if (!code) {\n return adminPage(\n `

Missing authorization code

Go back to /admin and try again.

`,\n 400,\n { \"set-cookie\": clearStateCookie },\n );\n }\n\n const token = await exchangeCodeForToken(code, adminRedirectUriFor(req));\n if (!token) {\n return adminPage(\n `

Something went wrong

Couldn't complete sign-in with Twitch. Try again in a moment.

`,\n 500,\n { \"set-cookie\": clearStateCookie },\n );\n }\n\n const user = await getAuthorizingUser(token.access_token);\n if (!user) {\n return adminPage(\n `

Something went wrong

Couldn't identify your Twitch account.

`,\n 500,\n { \"set-cookie\": clearStateCookie },\n );\n }\n\n if (!(await isAuthorizedAdmin(user.login))) {\n return adminPage(\n `

Not authorized

Signed in as ${user.display_name}, but this account isn't set up as a moderator or the broadcaster for this bot. If that's wrong, ask the bot owner to add you.

`,\n 403,\n { \"set-cookie\": clearStateCookie },\n );\n }\n\n const sessionCookie = await makeSessionCookie(user.login);\n const headers = new Headers({ location: \"/admin\" });\n headers.append(\"set-cookie\", sessionCookie);\n headers.append(\"set-cookie\", clearStateCookie);\n return new Response(null, { status: 302, headers });\n }\n\n if (path === \"/admin/logout\") {\n const headers = new Headers({ location: \"/admin\" });\n headers.set(\"set-cookie\", clearSessionCookie());\n return new Response(null, { status: 302, headers });\n }\n\n if (path === \"/admin/toggle\") {\n if (req.method !== \"POST\") {\n return adminPage(`

Method not allowed

`, 405);\n }\n const login = await verifySession(req);\n if (!login) {\n return adminPage(\n `

Session expired

Please sign in again.

`,\n 401,\n );\n }\n\n const form = await req.formData();\n const channel = String(form.get(\"channel\") || \"\").toLowerCase();\n const key = String(form.get(\"key\") || \"\");\n const extraChannels = await getChannels();\n const allChannels = [\n HOME_CHANNEL,\n ...extraChannels.filter((c) => c !== HOME_CHANNEL),\n ];\n if (!allChannels.includes(channel)) {\n return adminPage(`

Unknown channel

`, 400);\n }\n if (!isSuperAdmin(login) && channel !== login) {\n return adminPage(`

Not authorized for that channel

`, 403);\n }\n if (!FEATURE_KEYS.includes(key)) {\n return adminPage(`

Unknown setting

`, 400);\n }\n const enabled = String(form.get(\"enabled\")) === \"1\";\n await setFeatureFlag(channel, key, enabled);\n return new Response(null, {\n status: 303,\n headers: { location: `/admin?channel=${encodeURIComponent(channel)}` },\n });\n }\n\n // --- Step 1: broadcaster lands here and clicks the single \"Authorize\" button ---\n if (path === \"/onboard\") {\n const authorizeUrl = new URL(\"https://id.twitch.tv/oauth2/authorize\");\n authorizeUrl.searchParams.set(\"client_id\", CLIENT_ID);\n authorizeUrl.searchParams.set(\"redirect_uri\", redirectUriFor(req));\n authorizeUrl.searchParams.set(\"response_type\", \"code\");\n authorizeUrl.searchParams.set(\"scope\", \"channel:bot\");\n return page(\n `

Bring The Wandering Clerk to your channel

` +\n `

Click below and log in as the broadcaster of the channel you want the Clerk to serve. ` +\n `This only grants permission for the bot to read and post in your chat — nothing else.

` +\n `

Authorize The Wandering Clerk

`,\n );\n }\n\n // --- Step 2: Twitch redirects back here with a code once they authorize ---\n if (path === \"/oauth/callback\") {\n const error = url.searchParams.get(\"error\");\n if (error) {\n return page(`

Authorization cancelled

${error}

`, 400);\n }\n\n const code = url.searchParams.get(\"code\");\n if (!code) {\n return page(\n `

Missing authorization code

Try the onboarding link again.

`,\n 400,\n );\n }\n\n const token = await exchangeCodeForToken(code, redirectUriFor(req));\n if (!token) {\n return page(\n `

Something went wrong

Couldn't complete authorization with Twitch. Try again in a moment.

`,\n 500,\n );\n }\n\n const user = await getAuthorizingUser(token.access_token);\n if (!user) {\n return page(\n `

Something went wrong

Couldn't identify your Twitch account.

`,\n 500,\n );\n }\n\n await addChannel(user.login, user.login);\n return page(\n `

You're all set, ${user.display_name}!

` +\n `

The Wandering Clerk checks for new channels every few minutes while it's running. ` +\n `Watch your chat for a message, or try typing !help.

`,\n );\n }\n\n // --- Storage API for the GitHub Actions-hosted bot process ---\n if (path.startsWith(\"/api/\")) {\n if (!isAuthorized(req)) return json({ error: \"unauthorized\" }, 401);\n\n if (path === \"/api/merchant\") {\n if (req.method === \"GET\") return json(await getMerchantOffers());\n if (req.method === \"PUT\") {\n await saveMerchantOffers(await req.json());\n return json({ ok: true });\n }\n }\n\n if (path === \"/api/quests\") {\n if (req.method === \"GET\") return json(await getQuestBoard());\n if (req.method === \"PUT\") {\n await saveQuestBoard(await req.json());\n return json({ ok: true });\n }\n }\n\n if (path === \"/api/channels\") {\n if (req.method === \"GET\") return json(await getChannels());\n if (req.method === \"POST\") {\n const body = await req.json();\n await addChannel(body.channel, body.addedBy);\n return json({ ok: true });\n }\n }\n\n const channelMatch = path.match(/^\\/api\\/channels\\/([^/]+)$/);\n if (channelMatch && req.method === \"DELETE\") {\n await removeChannel(decodeURIComponent(channelMatch[1]));\n return json({ ok: true });\n }\n\n const charMatch = path.match(/^\\/api\\/characters\\/([^/]+)$/);\n if (charMatch) {\n const username = decodeURIComponent(charMatch[1]);\n if (req.method === \"GET\") {\n const c = await getCharacter(username);\n return c ? json(c) : json({ error: \"not found\" }, 404);\n }\n if (req.method === \"PUT\") {\n await saveCharacter(await req.json());\n return json({ ok: true });\n }\n if (req.method === \"DELETE\") {\n await deleteCharacter(username);\n return json({ ok: true });\n }\n }\n\n const metaMatch = path.match(/^\\/api\\/meta\\/([^/]+)$/);\n if (metaMatch) {\n const key = decodeURIComponent(metaMatch[1]);\n if (req.method === \"GET\") {\n const value = await getMeta(key);\n return value === null\n ? json({ error: \"not found\" }, 404)\n : json({ value });\n }\n if (req.method === \"PUT\") {\n const body = await req.json();\n await setMeta(key, String(body.value));\n return json({ ok: true });\n }\n }\n\n return json({ error: \"not found\" }, 404);\n }\n\n return new Response(\n \"GuildBreak: Hunt & Hoard storage + onboarding service is running.\",\n {\n status: 200,\n headers: { \"content-type\": \"text/plain\" },\n },\n );\n}","huntandhoardbot",[160],"a19ccef9-1eec-4de8-99db-22eddcd6f514","helix.ts","ef32123e-aa1d-11f1-940f-1607ee4eb77e",62,["D",1789172971701],6,"// =============================================================================\n// helix.ts — small Helix API client. This bot uses the modern chat stack\n// (EventSub for reading, Helix REST for sending) instead of legacy IRC.\n// =============================================================================\n\nconst CLIENT_ID = Deno.env.get(\"TWITCH_CLIENT_ID\") || \"\";\nconst CLIENT_SECRET = Deno.env.get(\"TWITCH_CLIENT_SECRET\") || \"\";\nconst REFRESH_TOKEN = Deno.env.get(\"TWITCH_BOT_REFRESH_TOKEN\") || \"\";\nlet currentAccessToken = Deno.env.get(\"TWITCH_BOT_ACCESS_TOKEN\") || \"\";\n\nif (!CLIENT_ID) {\n console.error(\"Missing TWITCH_CLIENT_ID env var.\");\n}\nif (!currentAccessToken && !REFRESH_TOKEN) {\n console.error(\n \"Missing both TWITCH_BOT_ACCESS_TOKEN and TWITCH_BOT_REFRESH_TOKEN — the bot has no way to authenticate.\",\n );\n}\n\nconst BASE = \"https://api.twitch.tv/helix\";\n\nfunction authHeaders(): HeadersInit {\n return {\n \"Client-Id\": CLIENT_ID,\n \"Authorization\": `Bearer ${currentAccessToken}`,\n \"Content-Type\": \"application/json\",\n };\n}\n\n// Separate from the bot's user-token auth above: sendChatMessage needs an\n// App Access Token (client-credentials grant) so it can pass\n// for_source_only during Shared Chat — see sendChatMessage below. Cached at\n// module scope so it's reused across calls instead of re-fetched every send.\nlet appAccessToken = \"\";\nlet appAccessTokenExpiresAt = 0;\n\nasync function getAppAccessToken(): Promise {\n if (appAccessToken && Date.now() < appAccessTokenExpiresAt - 60_000) {\n return appAccessToken;\n }\n const params = new URLSearchParams({\n client_id: CLIENT_ID,\n client_secret: CLIENT_SECRET,\n grant_type: \"client_credentials\",\n });\n const res = await fetch(\n `https://id.twitch.tv/oauth2/token?${params.toString()}`,\n { method: \"POST\" },\n );\n if (!res.ok) {\n console.error(\"getAppAccessToken failed:\", res.status, await res.text());\n throw new Error(\"Could not obtain app access token\");\n }\n const json = await res.json();\n appAccessToken = json.access_token;\n appAccessTokenExpiresAt = Date.now() + json.expires_in * 1000;\n return appAccessToken;\n}\n\n// Twitch user access tokens expire (typically ~4 hours) but refresh\n// tokens don't, so this can be called as often as needed. Called\n// proactively at startup and periodically during long runs (see\n// twitch.ts), and reactively whenever a call comes back 401 — matching\n// Twitch's own recommended pattern (see helixFetch below).\nexport async function refreshAccessToken(): Promise {\n if (!CLIENT_ID || !CLIENT_SECRET || !REFRESH_TOKEN) {\n console.error(\n \"Cannot refresh access token — missing TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET, or TWITCH_BOT_REFRESH_TOKEN.\",\n );\n return false;\n }\n const params = new URLSearchParams({\n client_id: CLIENT_ID,\n client_secret: CLIENT_SECRET,\n grant_type: \"refresh_token\",\n refresh_token: REFRESH_TOKEN,\n });\n const res = await fetch(\n `https://id.twitch.tv/oauth2/token?${params.toString()}`,\n { method: \"POST\" },\n );\n if (!res.ok) {\n console.error(\"refreshAccessToken failed:\", res.status, await res.text());\n return false;\n }\n const json = await res.json();\n currentAccessToken = json.access_token;\n console.log(\"Refreshed the bot's Twitch access token.\");\n return true;\n}\n\n// Wraps fetch with Twitch's recommended pattern: on a 401, refresh the\n// token once and retry the request before giving up.\nasync function helixFetch(\n url: string,\n init: RequestInit = {},\n): Promise {\n let res = await fetch(url, {\n ...init,\n headers: { ...authHeaders(), ...(init.headers || {}) },\n });\n if (res.status === 401) {\n const refreshed = await refreshAccessToken();\n if (refreshed) {\n res = await fetch(url, {\n ...init,\n headers: { ...authHeaders(), ...(init.headers || {}) },\n });\n }\n }\n return res;\n}\n\nexport interface HelixUser {\n id: string;\n login: string;\n display_name: string;\n}\n\nconst userCache = new Map();\n\nexport async function getUser(login: string): Promise {\n const key = login.toLowerCase();\n if (userCache.has(key)) return userCache.get(key)!;\n const res = await helixFetch(\n `${BASE}/users?login=${encodeURIComponent(key)}`,\n );\n if (!res.ok) {\n console.error(\"getUser failed:\", res.status, await res.text());\n return null;\n }\n const json = await res.json();\n const user = json.data?.[0] as HelixUser | undefined;\n if (!user) return null;\n userCache.set(key, user);\n return user;\n}\n\n// Subscribes the bot (user_id) to chat messages in a given channel\n// (broadcaster_user_id) over the already-open EventSub WebSocket session.\n// This call fails with 403 if that broadcaster hasn't granted this\n// Client ID the channel:bot permission (see setup steps).\nexport async function createChatMessageSubscription(\n broadcasterId: string,\n botId: string,\n sessionId: string,\n): Promise {\n const res = await helixFetch(`${BASE}/eventsub/subscriptions`, {\n method: \"POST\",\n body: JSON.stringify({\n type: \"channel.chat.message\",\n version: \"1\",\n condition: { broadcaster_user_id: broadcasterId, user_id: botId },\n transport: { method: \"websocket\", session_id: sessionId },\n }),\n });\n if (!res.ok) {\n console.error(\n \"createChatMessageSubscription failed:\",\n res.status,\n await res.text(),\n );\n return false;\n }\n return true;\n}\n\nexport async function sendChatMessage(\n broadcasterId: string,\n senderId: string,\n text: string,\n): Promise {\n const appToken = await getAppAccessToken();\n const res = await fetch(`${BASE}/chat/messages`, {\n method: \"POST\",\n headers: {\n \"Client-Id\": CLIENT_ID,\n \"Authorization\": `Bearer ${appToken}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n broadcaster_id: broadcasterId,\n sender_id: senderId,\n message: text,\n for_source_only: true,\n }),\n });\n if (!res.ok) {\n console.error(\n \"sendChatMessage HTTP failure:\",\n res.status,\n await res.text(),\n );\n return;\n }\n const json = await res.json();\n const result = json.data?.[0];\n // Twitch can return 200 OK and still silently drop the message — e.g.\n // AutoMod held it, or a chat mode (slow/unique/followers-only) blocked\n // a non-moderator bot. Surface that instead of failing silently.\n if (result && result.is_sent === false) {\n console.error(\n \"sendChatMessage was NOT delivered — drop_reason:\",\n result.drop_reason?.message || \"(none given)\",\n );\n }\n}\n\n// Checks which of the given channels are currently live, in a single\n// batched call (Twitch's Get Streams endpoint accepts multiple\n// user_login params at once). Used to keep the Clerk's unprompted,\n// periodic chat lines quiet in channels that aren't streaming.\nexport async function getLiveChannels(logins: string[]): Promise> {\n if (!logins.length) return new Set();\n const params = logins.map((l) => `user_login=${encodeURIComponent(l)}`).join(\n \"&\",\n );\n const res = await helixFetch(`${BASE}/streams?${params}`);\n if (!res.ok) {\n console.error(\"getLiveChannels failed:\", res.status, await res.text());\n return new Set();\n }\n const json = await res.json();\n const live = new Set();\n for (const stream of json.data || []) {\n if (stream.user_login) live.add(String(stream.user_login).toLowerCase());\n }\n return live;\n}\n\n// -----------------------------------------------------------------------\n// One-click broadcaster onboarding (Authorization Code flow). A broadcaster\n// clicking the /onboard link authorizes just the channel:bot scope; we\n// exchange the resulting code for a short-lived token, use it only to\n// identify who authorized (their user id/login), then discard it — the\n// bot keeps running on its own long-lived TWITCH_BOT_ACCESS_TOKEN.\n// -----------------------------------------------------------------------\nexport async function exchangeCodeForToken(\n code: string,\n redirectUri: string,\n): Promise<{ access_token: string } | null> {\n const params = new URLSearchParams({\n client_id: CLIENT_ID,\n client_secret: CLIENT_SECRET,\n code,\n grant_type: \"authorization_code\",\n redirect_uri: redirectUri,\n });\n const res = await fetch(\n `https://id.twitch.tv/oauth2/token?${params.toString()}`,\n { method: \"POST\" },\n );\n if (!res.ok) {\n console.error(\"exchangeCodeForToken failed:\", res.status, await res.text());\n return null;\n }\n return await res.json();\n}\n\nexport async function getAuthorizingUser(\n accessToken: string,\n): Promise {\n const res = await fetch(`${BASE}/users`, {\n headers: {\n \"Client-Id\": CLIENT_ID,\n \"Authorization\": `Bearer ${accessToken}`,\n },\n });\n if (!res.ok) {\n console.error(\"getAuthorizingUser failed:\", res.status, await res.text());\n return null;\n }\n const json = await res.json();\n return (json.data?.[0] as HelixUser) ?? null;\n}",[167],"de9affa4-65c7-4fcb-8919-4ca05a03d375","game.ts","6bc49524-aa1e-11f1-88d3-1607ee4eb77e",56,["D",1789171975782],5,"// =============================================================================\n// game.ts — ⚙️ GITHUB REPO COPY (sheastolp/The-Wandering-Clerk)\n// Used by: commands.ts, twitch.ts (the live bot process)\n// This is the FULL, ACTIVE copy — combat, the merchant, quests, item\n// lore, passive HP regen, all of it. If you're editing game rules,\n// balance numbers, or Advisor hints, this is the file that matters.\n//\n// A second copy of this filename lives in the separate Val Town project\n// (sheastolp's huntandhoardbot val) — that one is a trimmed-down,\n// storage-only subset (just enough for type-checking store.ts and\n// rolling default merchant/quest data on first run). The two are NOT\n// auto-synced; changes here don't propagate there and vice versa. If\n// you're not sure which one you're looking at, check this banner.\n// =============================================================================\n// game.ts — all the stateless game math and rules. Nothing in here talks\n// to Twitch or SQLite; it only operates on the plain objects below.\n// =============================================================================\nimport {\n ClassDef,\n classes,\n ItemDef,\n items,\n itemStoryTemplates,\n merchantNames,\n MonsterDef,\n monsters,\n nameEpithet,\n nameFirst,\n RaceDef,\n races,\n xpThresholds,\n} from \"./data.ts\";\n\nexport type { MonsterDef } from \"./data.ts\";\n\nexport interface InventoryItem extends ItemDef {\n qty: number;\n}\n\nexport interface Character {\n username: string;\n name: string;\n race: RaceDef;\n cls: ClassDef;\n hitDie: number;\n conMod: number;\n level: number;\n xp: number;\n gold: number;\n ac: number;\n hp: number;\n hpMax: number;\n inventory: InventoryItem[];\n equipped: { weapon: InventoryItem | null; armor: InventoryItem | null };\n createdAt: number;\n questProgress: Record; // quest id -> kills logged toward it\n lastHealTickAt: number; // for passive regen — see Rules.applyPassiveHealing\n}\n\nexport interface MerchantOffer {\n merchant: string;\n item: ItemDef;\n postedAt: number;\n}\n\n// -----------------------------------------------------------------------\n// Util\n// -----------------------------------------------------------------------\nexport const Util = {\n pick(arr: T[]): T {\n return arr[Math.floor(Math.random() * arr.length)];\n },\n rollDie(sides: number): number {\n return 1 + Math.floor(Math.random() * sides);\n },\n rollDice(count: number, sides: number): number {\n let total = 0;\n for (let i = 0; i < count; i++) total += Util.rollDie(sides);\n return total;\n },\n clamp(n: number, min: number, max: number): number {\n return Math.max(min, Math.min(max, n));\n },\n modifier(score: number): number {\n return Math.floor((score - 10) / 2);\n },\n sampleUnique(arr: T[], count: number): T[] {\n if (arr.length <= count) return arr.slice();\n const pool = arr.slice();\n const out: T[] = [];\n for (let i = 0; i < count; i++) {\n const idx = Math.floor(Math.random() * pool.length);\n out.push(pool[idx]);\n pool.splice(idx, 1);\n }\n return out;\n },\n};\n\n// -----------------------------------------------------------------------\n// Rules — character math\n// -----------------------------------------------------------------------\nexport const Rules = {\n PASSIVE_HEAL_INTERVAL_MS: 15 * 60 * 1000, // 15 minutes\n PASSIVE_HEAL_AMOUNT: 3,\n\n // Catch-up healing: called whenever a character is loaded (see\n // storeClient.ts), not on any timer of its own — so it heals correctly\n // for however much real time has actually passed since the last check,\n // even across gaps between bot runs. Returns true if any healing was\n // applied (i.e., the character needs to be saved).\n applyPassiveHealing(character: Character): boolean {\n if (!character.lastHealTickAt) {\n character.lastHealTickAt = Date.now(); // back-compat: no retroactive burst for old characters\n return false;\n }\n if (character.hp >= character.hpMax) {\n character.lastHealTickAt = Date.now(); // fully healed — no ticks to bank while topped up\n return false;\n }\n const elapsed = Date.now() - character.lastHealTickAt;\n const ticks = Math.floor(elapsed / Rules.PASSIVE_HEAL_INTERVAL_MS);\n if (ticks <= 0) return false;\n const healed = ticks * Rules.PASSIVE_HEAL_AMOUNT;\n character.hp = Util.clamp(character.hp + healed, 0, character.hpMax);\n character.lastHealTickAt += ticks * Rules.PASSIVE_HEAL_INTERVAL_MS; // keep leftover partial-interval progress\n return true;\n },\n\n rollRandomName(): string {\n return Util.pick(nameFirst) + \" \" + Util.pick(nameEpithet);\n },\n\n levelForXp(xp: number): number {\n let level = 1;\n for (let i = xpThresholds.length - 1; i >= 0; i--) {\n if (xp >= xpThresholds[i]) {\n level = i + 1;\n break;\n }\n }\n return Util.clamp(level, 1, 20);\n },\n\n maxHpForLevel(\n character: Pick,\n ): number {\n const perLevel = Math.max(\n 1,\n Math.floor(character.hitDie / 2) + 1 + character.conMod,\n );\n const base = Math.max(1, character.hitDie + character.conMod);\n return base + (character.level - 1) * perLevel +\n character.race.hpBonus * character.level;\n },\n\n createCharacter(username: string, name: string): Character {\n const race = Util.pick(races);\n const cls = Util.pick(classes);\n const conMod = Util.modifier(Util.rollDice(3, 6) + 5); // biased toward positive CON\n const character: Character = {\n username: username.trim().toLowerCase(),\n name,\n race,\n cls,\n hitDie: cls.hitDie,\n conMod,\n level: 1,\n xp: 0,\n gold: 10,\n ac: 10 + Math.max(0, conMod),\n inventory: [],\n equipped: { weapon: null, armor: null },\n createdAt: Date.now(),\n questProgress: {},\n lastHealTickAt: Date.now(),\n hp: 0,\n hpMax: 0,\n };\n character.hpMax = Rules.maxHpForLevel(character);\n character.hp = character.hpMax;\n return character;\n },\n\n attackBonusFor(character: Character): number {\n const base = character.cls.atkBonus + Math.floor(character.level / 3);\n const weaponBonus = character.equipped.weapon\n ? (character.equipped.weapon.atkBonus ?? 0)\n : 0;\n return base + weaponBonus;\n },\n\n armorClassFor(character: Character): number {\n const armorBonus = character.equipped.armor\n ? (character.equipped.armor.acBonus ?? 0)\n : 0;\n return character.ac + armorBonus;\n },\n\n sheetLine(character: Character): string {\n const hpBar = character.hp + \"/\" + character.hpMax + \" HP\";\n const weapon = character.equipped.weapon\n ? character.equipped.weapon.name\n : \"bare fists\";\n const armor = character.equipped.armor\n ? character.equipped.armor.name\n : \"no armor\";\n return character.name + \" — Level \" + character.level + \" \" +\n character.race.name + \" \" + character.cls.name +\n \" | \" + hpBar + \" | AC \" + Rules.armorClassFor(character) + \" | XP \" +\n character.xp + \" | Gold \" + character.gold +\n \" | Wielding: \" + weapon + \" | Wearing: \" + armor;\n },\n};\n\n// -----------------------------------------------------------------------\n// Combat\n// -----------------------------------------------------------------------\nexport interface HuntResult {\n monster: MonsterDef;\n won: boolean;\n log: string[];\n xpGained: number;\n goldGained: number;\n leveledTo: number | null;\n hpLeft: number;\n hpMax: number;\n}\n\nexport const Combat = {\n pickMonsterForLevel(level: number): MonsterDef {\n const targetCr = Util.clamp((level + 1) / 4, 0.125, 20);\n const hardCeiling = Util.clamp(targetCr * 2 + 0.5, 1, 24);\n const pool = monsters.filter((m) => m.cr <= hardCeiling);\n const weights = pool.map((m) => {\n if (m.cr <= targetCr) return 3;\n if (m.cr <= targetCr * 1.15) return 1.2;\n return 0.4;\n });\n const total = weights.reduce((a, b) => a + b, 0);\n let roll = Math.random() * total;\n for (let i = 0; i < pool.length; i++) {\n roll -= weights[i];\n if (roll <= 0) return pool[i];\n }\n return pool[pool.length - 1];\n },\n\n huntMonster(character: Character, forcedMonster?: MonsterDef): HuntResult {\n const monster = forcedMonster ??\n Combat.pickMonsterForLevel(character.level);\n let monsterHp = monster.hp;\n let playerHp = character.hp;\n const atkBonus = Rules.attackBonusFor(character);\n const ac = Rules.armorClassFor(character);\n const log: string[] = [];\n let swings = 0;\n\n while (playerHp > 0 && monsterHp > 0 && swings < 40) {\n swings++;\n const pRoll = Util.rollDie(20);\n const pHit = pRoll === 20 ||\n (pRoll !== 1 && pRoll + atkBonus >= monster.ac);\n if (pHit) {\n const dmg =\n Math.max(1, Util.rollDice(1, 8) + Math.floor(character.level / 2)) *\n (pRoll === 20 ? 2 : 1);\n monsterHp = Math.max(0, monsterHp - dmg);\n log.push(\"you hit for \" + dmg);\n } else {\n log.push(\"you miss\");\n }\n if (monsterHp <= 0) break;\n\n const mRoll = Util.rollDie(20);\n const mHit = mRoll === 20 || (mRoll !== 1 && mRoll + monster.atk >= ac);\n if (mHit) {\n const dmg = Math.max(\n 1,\n Util.rollDice(monster.dmgDice, monster.dmgSides) + monster.dmgBonus,\n );\n playerHp = Math.max(0, playerHp - dmg);\n log.push(monster.name + \" hits you for \" + dmg);\n } else {\n log.push(monster.name + \" misses\");\n }\n }\n\n const won = monsterHp <= 0 && playerHp > 0;\n character.hp = Math.max(1, playerHp); // never actually die — worst case, stagger away at 1 HP\n\n let xpGained = 0;\n let goldGained = 0;\n let leveledTo: number | null = null;\n\n if (won) {\n xpGained = monster.xp;\n goldGained = monster.goldMin +\n Math.floor(Math.random() * (monster.goldMax - monster.goldMin + 1));\n character.xp += xpGained;\n character.gold += goldGained;\n const newLevel = Rules.levelForXp(character.xp);\n if (newLevel > character.level) {\n character.level = newLevel;\n const oldMax = character.hpMax;\n character.hpMax = Rules.maxHpForLevel(character);\n character.hp = Util.clamp(\n character.hp + (character.hpMax - oldMax),\n 1,\n character.hpMax,\n );\n leveledTo = newLevel;\n }\n } else {\n xpGained = 5 + character.level * 3;\n character.xp += xpGained;\n }\n\n return {\n monster,\n won,\n log,\n xpGained,\n goldGained,\n leveledTo,\n hpLeft: character.hp,\n hpMax: character.hpMax,\n };\n },\n};\n\n// -----------------------------------------------------------------------\n// MonsterLookup — used by !hunt to target a specific\n// monster instead of a random level-appropriate encounter.\n// -----------------------------------------------------------------------\nexport const MonsterLookup = {\n find(needle: string): MonsterDef | undefined {\n const n = needle.trim().toLowerCase();\n return monsters.find((m) => m.name.toLowerCase() === n) ||\n monsters.find((m) => m.name.toLowerCase().indexOf(n) !== -1);\n },\n};\n\n// -----------------------------------------------------------------------\n// ItemLookup — used by !item to look up any item's full details\n// by name (exact or partial), whether or not the caller owns it.\n// -----------------------------------------------------------------------\nexport const ItemLookup = {\n find(needle: string): ItemDef | undefined {\n const n = needle.trim().toLowerCase();\n if (!n) return undefined;\n return items.find((i) => i.key.toLowerCase() === n) ||\n items.find((i) => i.name.toLowerCase() === n) ||\n items.find((i) => i.name.toLowerCase().indexOf(n) !== -1);\n },\n\n describe(itemDef: ItemDef): string {\n const bonus = itemDef.type === \"weapon\"\n ? \"+\" + (itemDef.atkBonus ?? 0) + \" to hunt rolls\"\n : itemDef.type === \"armor\"\n ? \"+\" + (itemDef.acBonus ?? 0) + \" AC\"\n : itemDef.type === \"potion\" && itemDef.heal\n ? \"heals \" + itemDef.heal[0] + \"d\" + itemDef.heal[1] + \"+\" +\n itemDef.heal[2] + \" HP\"\n : \"no mechanical bonus, purely for flavor\";\n return itemDef.name + \" (\" + itemDef.type + \") — \" + bonus + \" — \" +\n itemDef.price + \" gold — \" + itemDef.desc;\n },\n};\n\n// -----------------------------------------------------------------------\n// Inventory\n// -----------------------------------------------------------------------\nexport const Inventory = {\n find(character: Character, needle: string): InventoryItem | undefined {\n const n = needle.trim().toLowerCase();\n return character.inventory.find((it) =>\n it.key.toLowerCase() === n || it.name.toLowerCase().indexOf(n) !== -1\n );\n },\n add(character: Character, itemDef: ItemDef): void {\n const existing = character.inventory.find((it) => it.key === itemDef.key);\n if (existing) {\n existing.qty += 1;\n } else {\n character.inventory.push({ ...itemDef, qty: 1 });\n }\n },\n removeOne(character: Character, invItem: InventoryItem): void {\n invItem.qty -= 1;\n if (invItem.qty <= 0) {\n character.inventory = character.inventory.filter((it) => it !== invItem);\n }\n },\n};\n\n// -----------------------------------------------------------------------\n// Merchant\n// -----------------------------------------------------------------------\nexport const Merchant = {\n SLOT_COUNT: 3,\n AD_INTERVAL_MS: 8 * 60 * 1000, // 8 minutes\n AD_JITTER_MS: 4 * 60 * 1000, // up to +4 minutes extra\n\n rollOffer(): MerchantOffer {\n return {\n merchant: Util.pick(merchantNames),\n item: Util.pick(items),\n postedAt: Date.now(),\n };\n },\n\n rollOffers(): MerchantOffer[] {\n const picked = Util.sampleUnique(items, Merchant.SLOT_COUNT);\n return picked.map((item) => ({\n merchant: Util.pick(merchantNames),\n item,\n postedAt: Date.now(),\n }));\n },\n\n pickAdOffer(currentOffers: MerchantOffer[] | null): MerchantOffer {\n if (currentOffers && currentOffers.length) return Util.pick(currentOffers);\n return Merchant.rollOffer();\n },\n\n formatAd(offer: MerchantOffer): string {\n return \"🛒 \" + offer.merchant + \" is hawking \" + offer.item.name + \" (\" +\n offer.item.desc + \") for \" +\n offer.item.price +\n \" gold! Say !merchant to see the full stall, or !buy to grab it.\";\n },\n\n findOffer(\n offers: MerchantOffer[],\n needle: string,\n ): { offer: MerchantOffer; index: number } | null {\n const trimmed = needle.trim();\n const asNumber = parseInt(trimmed, 10);\n if (\n !isNaN(asNumber) && String(asNumber) === trimmed && asNumber >= 1 &&\n asNumber <= offers.length\n ) {\n return { offer: offers[asNumber - 1], index: asNumber - 1 };\n }\n const n = trimmed.toLowerCase();\n for (let i = 0; i < offers.length; i++) {\n if (offers[i].item.name.toLowerCase().indexOf(n) !== -1) {\n return { offer: offers[i], index: i };\n }\n }\n return null;\n },\n\n cheapestAffordable(\n offers: MerchantOffer[],\n gold: number,\n ): MerchantOffer | null {\n let best: MerchantOffer | null = null;\n offers.forEach((offer) => {\n if (\n offer.item.price <= gold &&\n (!best || offer.item.price < best.item.price)\n ) best = offer;\n });\n return best;\n },\n\n describeOffers(offers: MerchantOffer[]): string {\n return offers\n .map((offer, i) =>\n \"#\" + (i + 1) + \" \" + offer.item.name + \" (\" + offer.item.desc +\n \") — \" + offer.item.price + \" gold [\" + offer.merchant + \"]\"\n )\n .join(\" | \");\n },\n};\n\n// -----------------------------------------------------------------------\n// Advisor — the \"what should I do next\" hint shared by nearly every command\n// -----------------------------------------------------------------------\nexport const Advisor = {\n LOW_HP_FRACTION: 0.3,\n\n isLowHp(character: Character): boolean {\n return character.hp <=\n Math.max(1, Math.ceil(character.hpMax * Advisor.LOW_HP_FRACTION));\n },\n\n recommendNextAction(\n character: Character | null,\n offers: MerchantOffer[] | null,\n ): string {\n if (!character) {\n return \"Next: !enlist (or !enlist random) to roll up a hero.\";\n }\n\n const potion = character.inventory.find((it) => it.type === \"potion\");\n\n if (character.hp <= 1) {\n return potion\n ? \"Next: !use \" + potion.name +\n \" to patch yourself up, or !rest — you are barely standing.\"\n : \"Next: !rest — you are barely standing.\";\n }\n if (Advisor.isLowHp(character)) {\n return potion\n ? \"Next: !use \" + potion.name +\n \" for a quick heal, or !rest to patch up before your next fight.\"\n : \"Next: !rest to patch up before your next fight.\";\n }\n\n const unequippedWeapon = character.inventory.find((it) =>\n it.type === \"weapon\" &&\n (!character.equipped.weapon ||\n (it.atkBonus ?? 0) > (character.equipped.weapon.atkBonus ?? 0))\n );\n if (unequippedWeapon) {\n return \"Next: !use \" + unequippedWeapon.name +\n \" — it beats what you have equipped.\";\n }\n\n const unequippedArmor = character.inventory.find((it) =>\n it.type === \"armor\" &&\n (!character.equipped.armor ||\n (it.acBonus ?? 0) > (character.equipped.armor.acBonus ?? 0))\n );\n if (unequippedArmor) {\n return \"Next: !use \" + unequippedArmor.name +\n \" — it beats what you have equipped.\";\n }\n\n const affordable = offers &&\n Merchant.cheapestAffordable(offers, character.gold);\n if (affordable) {\n return \"Next: !buy \" + affordable.item.name + \" — you can afford it (\" +\n affordable.item.price + \" gold) from \" + affordable.merchant + \".\";\n }\n return \"Next: !hunt for more XP and gold, or !autohunt to chain fights automatically.\";\n },\n};\n\n// -----------------------------------------------------------------------\n// AutoHunt — timed autohunt sessions. A session fires one hunt roughly\n// every HUNT_INTERVAL_MS, for up to durationMs, auto-resting instead of\n// fighting whenever HP dips below the same \"low HP\" line Advisor already\n// uses elsewhere. Sessions are persisted as a flat list (see\n// storeClient.getAutohuntSessions/saveAutohuntSessions) rather than on\n// the Character itself, so twitch.ts can discover all active sessions\n// without a \"list every character\" API. Only one session per username\n// at a time (enforced in commands.ts).\n// -----------------------------------------------------------------------\nexport interface AutoHuntSession {\n username: string;\n channel: string;\n startedAt: number;\n endsAt: number;\n intervalMs: number;\n nextActionAt: number;\n hunts: number;\n wins: number;\n losses: number;\n totalXp: number;\n totalGold: number;\n levelsGained: number;\n}\n\nexport const AutoHunt = {\n DEFAULT_DURATION_MS: 15 * 60 * 1000, // 15 minutes\n MIN_DURATION_MS: 5 * 60 * 1000, // 5 minutes\n MAX_DURATION_MS: 2 * 60 * 60 * 1000, // 2 hours\n HUNT_INTERVAL_MS: 3 * 60 * 1000, // a bout roughly every 3 minutes\n HEAL_RESTORE_FRACTION: 0.8, // same target !rest uses\n\n // Parses \"20m\", \"1h\", \"1h30m\", or a bare number (minutes). Empty input\n // means \"use the default\". Returns null if the input can't be parsed\n // at all; otherwise clamps to [MIN_DURATION_MS, MAX_DURATION_MS].\n parseDuration(raw: string): number | null {\n const trimmed = raw.trim().toLowerCase();\n if (!trimmed) return AutoHunt.DEFAULT_DURATION_MS;\n if (/^\\d+$/.test(trimmed)) {\n return Util.clamp(\n parseInt(trimmed, 10) * 60 * 1000,\n AutoHunt.MIN_DURATION_MS,\n AutoHunt.MAX_DURATION_MS,\n );\n }\n const match = trimmed.match(/^(?:(\\d+)h)?(?:(\\d+)m)?$/);\n if (!match || (!match[1] && !match[2])) return null;\n const hours = parseInt(match[1] || \"0\", 10);\n const minutes = parseInt(match[2] || \"0\", 10);\n const ms = (hours * 60 + minutes) * 60 * 1000;\n if (ms <= 0) return null;\n return Util.clamp(ms, AutoHunt.MIN_DURATION_MS, AutoHunt.MAX_DURATION_MS);\n },\n\n formatDuration(ms: number): string {\n const totalMinutes = Math.max(1, Math.round(ms / 60000));\n const hours = Math.floor(totalMinutes / 60);\n const minutes = totalMinutes % 60;\n if (hours && minutes) return hours + \"h\" + minutes + \"m\";\n if (hours) return hours + \"h\";\n return minutes + \"m\";\n },\n\n start(\n character: Character,\n channel: string,\n durationMs: number,\n ): AutoHuntSession {\n const now = Date.now();\n return {\n username: character.username,\n channel,\n startedAt: now,\n endsAt: now + durationMs,\n intervalMs: AutoHunt.HUNT_INTERVAL_MS,\n nextActionAt: now, // fire the first bout right away\n hunts: 0,\n wins: 0,\n losses: 0,\n totalXp: 0,\n totalGold: 0,\n levelsGained: 0,\n };\n },\n\n isDue(session: AutoHuntSession): boolean {\n return Date.now() >= session.nextActionAt;\n },\n\n isExpired(session: AutoHuntSession): boolean {\n return Date.now() >= session.endsAt;\n },\n\n // One tick against a freshly-loaded character. Mutates both the\n // character and the session — caller saves both afterward. If HP is\n // low, this rests instead of fighting (and reports monsterWon: null,\n // so the caller knows not to touch quest progress this tick).\n tick(\n character: Character,\n session: AutoHuntSession,\n ): { message: string; leveledTo: number | null; monsterWon: string | null } {\n if (Advisor.isLowHp(character)) {\n const target = Math.min(\n character.hpMax,\n Math.ceil(character.hpMax * AutoHunt.HEAL_RESTORE_FRACTION),\n );\n if (character.hp < target) {\n character.hp = target;\n session.nextActionAt = Date.now() + session.intervalMs;\n return {\n message: character.name + \" breaks off to patch up, resting to \" +\n character.hp + \"/\" + character.hpMax + \" HP.\",\n leveledTo: null,\n monsterWon: null,\n };\n }\n }\n const result = Combat.huntMonster(character);\n session.hunts++;\n session.totalXp += result.xpGained;\n session.totalGold += result.goldGained;\n if (result.won) session.wins++;\n else session.losses++;\n if (result.leveledTo) session.levelsGained++;\n session.nextActionAt = Date.now() + session.intervalMs;\n const highlight = result.log.slice(-3).join(\", \");\n const outcome = result.won\n ? \"felled a \" + result.monster.name + \" (\" + highlight + \") — +\" +\n result.xpGained + \" XP, +\" + result.goldGained + \" gold.\"\n : \"was bested by a \" + result.monster.name + \" (\" + highlight +\n \") but logged +\" + result.xpGained + \" XP for the effort.\";\n return {\n message: character.name + \" \" + outcome + \" HP \" + character.hp + \"/\" +\n character.hpMax + \".\",\n leveledTo: result.leveledTo,\n monsterWon: result.won ? result.monster.name : null,\n };\n },\n\n summary(\n character: Character,\n session: AutoHuntSession,\n stopReason: string,\n ): string {\n const levelMsg = session.levelsGained\n ? \" 🎉 leveled up \" + session.levelsGained + \" time\" +\n (session.levelsGained === 1 ? \"\" : \"s\") + \"!\"\n : \"\";\n return character.name + \" wraps the autohunt after \" +\n AutoHunt.formatDuration(Date.now() - session.startedAt) + \" (\" +\n stopReason + \"): \" + session.hunts + \" bout\" +\n (session.hunts === 1 ? \"\" : \"s\") + \" (\" + session.wins + \"W/\" +\n session.losses + \"L), +\" + session.totalXp + \" XP, +\" +\n session.totalGold + \" gold. HP \" + character.hp + \"/\" +\n character.hpMax + \".\" + levelMsg;\n },\n};\n\n// -----------------------------------------------------------------------\n// ItemLore — picks a random item currently on the merchant's stall and\n// spins a short ambient story about it, for the periodic \"item lore\" chat\n// event.\n// -----------------------------------------------------------------------\nexport const ItemLore = {\n pickOffer(offers: MerchantOffer[]): MerchantOffer | null {\n if (!offers.length) return null;\n return Util.pick(offers);\n },\n\n story(offer: MerchantOffer): string {\n const templates = itemStoryTemplates[offer.item.type] ||\n itemStoryTemplates[\"trinket\"];\n const template = Util.pick(templates);\n return template\n .split(\"{owner}\").join(offer.merchant)\n .split(\"{item}\").join(offer.item.name)\n .split(\"{desc}\").join(offer.item.desc);\n },\n};",[175],"816edd05-7741-4ced-a78a-5d16f076082d","data.ts","80742f66-aa1e-11f1-be6f-1607ee4eb77e",63,["D",1789173371805],"// =============================================================================\n// data.ts — every tunable game table. No logic here, just data, so\n// balancing the game never means touching game.ts / commands.ts.\n// =============================================================================\n\nexport interface RaceDef {\n name: string;\n hpBonus: number;\n}\nexport interface ClassDef {\n name: string;\n hitDie: number;\n atkBonus: number;\n}\nexport interface MonsterDef {\n name: string;\n cr: number;\n ac: number;\n hp: number;\n atk: number;\n dmgDice: number;\n dmgSides: number;\n dmgBonus: number;\n xp: number;\n goldMin: number;\n goldMax: number;\n}\nexport interface ItemDef {\n key: string;\n name: string;\n type: \"potion\" | \"weapon\" | \"armor\" | \"trinket\";\n price: number;\n desc: string;\n heal?: [number, number, number]; // [diceCount, diceSides, flatBonus]\n atkBonus?: number;\n acBonus?: number;\n}\n\nexport const races: RaceDef[] = [\n { name: \"Human\", hpBonus: 0 },\n { name: \"Elf\", hpBonus: 0 },\n { name: \"Dwarf\", hpBonus: 2 },\n { name: \"Halfling\", hpBonus: 0 },\n { name: \"Half-Orc\", hpBonus: 1 },\n { name: \"Tiefling\", hpBonus: 0 },\n { name: \"Dragonborn\", hpBonus: 1 },\n { name: \"Gnome\", hpBonus: 0 },\n];\n\nexport const classes: ClassDef[] = [\n { name: \"Fighter\", hitDie: 10, atkBonus: 2 },\n { name: \"Rogue\", hitDie: 8, atkBonus: 2 },\n { name: \"Wizard\", hitDie: 6, atkBonus: 0 },\n { name: \"Cleric\", hitDie: 8, atkBonus: 1 },\n { name: \"Ranger\", hitDie: 10, atkBonus: 1 },\n { name: \"Barbarian\", hitDie: 12, atkBonus: 2 },\n { name: \"Bard\", hitDie: 8, atkBonus: 0 },\n { name: \"Paladin\", hitDie: 10, atkBonus: 1 },\n];\n\nexport const nameFirst: string[] = [\n \"Kaelen\",\n \"Thoradin\",\n \"Lyra\",\n \"Sable\",\n \"Varric\",\n \"Elowen\",\n \"Brannor\",\n \"Isolde\",\n \"Doran\",\n \"Fenwick\",\n \"Maerwyn\",\n \"Corvin\",\n \"Sylas\",\n \"Thessaly\",\n \"Grimnir\",\n \"Aveline\",\n \"Baelor\",\n \"Nyx\",\n \"Orrin\",\n \"Perrin\",\n \"Ravenna\",\n \"Torin\",\n \"Wrenna\",\n \"Aldric\",\n \"Bryn\",\n \"Caius\",\n \"Delphine\",\n \"Eamon\",\n \"Fira\",\n \"Gideon\",\n \"Halcyon\",\n \"Ione\",\n \"Jorah\",\n \"Kestrel\",\n \"Liora\",\n \"Marek\",\n \"Nadia\",\n \"Osric\",\n \"Petra\",\n \"Quill\",\n \"Roswyn\",\n \"Soren\",\n \"Talon\",\n \"Ursa\",\n \"Vesper\",\n \"Wystan\",\n \"Yara\",\n \"Zephyrine\",\n];\n\nexport const nameEpithet: string[] = [\n \"the Bold\",\n \"the Quiet\",\n \"the Wanderer\",\n \"Stormrider\",\n \"Ashborn\",\n \"the Steadfast\",\n \"Nightwhisper\",\n \"the Reckless\",\n \"Ironhand\",\n \"the Unbroken\",\n \"of the Hollow\",\n \"Duskwalker\",\n \"the Lucky\",\n \"Ravensworn\",\n \"the Grim\",\n \"Sunforged\",\n \"the Wayward\",\n \"Grimoak\",\n \"the Silent Blade\",\n \"Frostmantle\",\n \"the Ember-Eyed\",\n \"Wolfsbane\",\n \"the Undaunted\",\n \"Thornfield\",\n \"the Last Word\",\n \"Moonshadow\",\n];\n\n// Cumulative XP thresholds, 5e-inspired, levels 1-20.\nexport const xpThresholds: number[] = [\n 0,\n 300,\n 900,\n 2700,\n 6500,\n 14000,\n 23000,\n 34000,\n 48000,\n 64000,\n 85000,\n 100000,\n 120000,\n 140000,\n 165000,\n 195000,\n 225000,\n 265000,\n 305000,\n 355000,\n];\n\nexport const monsters: MonsterDef[] = [\n // --- Trivial (CR ~0-1/4) ---\n {\n name: \"Giant Rat\",\n cr: 0.125,\n ac: 10,\n hp: 6,\n atk: 2,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 0,\n xp: 10,\n goldMin: 0,\n goldMax: 2,\n },\n {\n name: \"Stirge\",\n cr: 0.125,\n ac: 12,\n hp: 4,\n atk: 3,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 1,\n xp: 10,\n goldMin: 0,\n goldMax: 1,\n },\n {\n name: \"Kobold Skirmisher\",\n cr: 0.125,\n ac: 12,\n hp: 5,\n atk: 3,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 1,\n xp: 15,\n goldMin: 1,\n goldMax: 3,\n },\n {\n name: \"Giant Centipede\",\n cr: 0.125,\n ac: 11,\n hp: 6,\n atk: 2,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 0,\n xp: 15,\n goldMin: 0,\n goldMax: 2,\n },\n {\n name: \"Goblin Scavenger\",\n cr: 0.25,\n ac: 13,\n hp: 8,\n atk: 3,\n dmgDice: 1,\n dmgSides: 6,\n dmgBonus: 1,\n xp: 25,\n goldMin: 1,\n goldMax: 5,\n },\n {\n name: \"Twig Blight\",\n cr: 0.25,\n ac: 13,\n hp: 7,\n atk: 2,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 0,\n xp: 25,\n goldMin: 0,\n goldMax: 1,\n },\n {\n name: \"Skeleton Sentry\",\n cr: 0.25,\n ac: 13,\n hp: 9,\n atk: 3,\n dmgDice: 1,\n dmgSides: 6,\n dmgBonus: 1,\n xp: 30,\n goldMin: 1,\n goldMax: 4,\n },\n {\n name: \"Flying Snake\",\n cr: 0.25,\n ac: 14,\n hp: 5,\n atk: 4,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 2,\n xp: 25,\n goldMin: 0,\n goldMax: 2,\n },\n\n // --- Easy (CR ~1/2-1) ---\n {\n name: \"Zombie Shambler\",\n cr: 0.5,\n ac: 8,\n hp: 14,\n atk: 3,\n dmgDice: 1,\n dmgSides: 6,\n dmgBonus: 1,\n xp: 50,\n goldMin: 1,\n goldMax: 5,\n },\n {\n name: \"Wolf\",\n cr: 0.5,\n ac: 13,\n hp: 11,\n atk: 4,\n dmgDice: 2,\n dmgSides: 4,\n dmgBonus: 2,\n xp: 50,\n goldMin: 0,\n goldMax: 2,\n },\n {\n name: \"Giant Wasp\",\n cr: 0.5,\n ac: 12,\n hp: 9,\n atk: 4,\n dmgDice: 1,\n dmgSides: 4,\n dmgBonus: 2,\n xp: 50,\n goldMin: 0,\n goldMax: 2,\n },\n {\n name: \"Cultist\",\n cr: 0.5,\n ac: 12,\n hp: 9,\n atk: 3,\n dmgDice: 1,\n dmgSides: 6,\n dmgBonus: 1,\n xp: 50,\n goldMin: 2,\n goldMax: 8,\n },\n {\n name: \"Orc Raider\",\n cr: 1,\n ac: 13,\n hp: 15,\n atk: 5,\n dmgDice: 1,\n dmgSides: 8,\n dmgBonus: 2,\n xp: 100,\n goldMin: 3,\n goldMax: 10,\n },\n {\n name: \"Gnoll Hunter\",\n cr: 1,\n ac: 15,\n hp: 22,\n atk: 4,\n dmgDice: 2,\n dmgSides: 4,\n dmgBonus: 2,\n xp: 100,\n goldMin: 2,\n goldMax: 8,\n },\n {\n name: \"Thug\",\n cr: 1,\n ac: 11,\n hp: 32,\n atk: 4,\n dmgDice: 1,\n dmgSides: 6,\n dmgBonus: 2,\n xp: 100,\n goldMin: 4,\n goldMax: 12,\n },\n {\n name: \"Giant Spider\",\n cr: 1,\n ac: 14,\n hp: 26,\n atk: 5,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 3,\n xp: 100,\n goldMin: 2,\n goldMax: 6,\n },\n {\n name: \"Dire Wolf\",\n cr: 1,\n ac: 14,\n hp: 37,\n atk: 5,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 3,\n xp: 100,\n goldMin: 1,\n goldMax: 4,\n },\n\n // --- Moderate (CR ~2-3) ---\n {\n name: \"Bugbear Ambusher\",\n cr: 2,\n ac: 16,\n hp: 27,\n atk: 5,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 3,\n xp: 200,\n goldMin: 5,\n goldMax: 15,\n },\n {\n name: \"Ogre Brute\",\n cr: 2,\n ac: 11,\n hp: 59,\n atk: 6,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 4,\n xp: 200,\n goldMin: 6,\n goldMax: 18,\n },\n {\n name: \"Harpy\",\n cr: 1,\n ac: 11,\n hp: 19,\n atk: 4,\n dmgDice: 1,\n dmgSides: 6,\n dmgBonus: 2,\n xp: 100,\n goldMin: 2,\n goldMax: 6,\n },\n {\n name: \"Gray Ooze\",\n cr: 2,\n ac: 8,\n hp: 22,\n atk: 5,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 3,\n xp: 200,\n goldMin: 0,\n goldMax: 3,\n },\n {\n name: \"Displacer Beast\",\n cr: 3,\n ac: 13,\n hp: 85,\n atk: 6,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 4,\n xp: 450,\n goldMin: 5,\n goldMax: 15,\n },\n {\n name: \"Minotaur Skulker\",\n cr: 3,\n ac: 14,\n hp: 76,\n atk: 6,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 4,\n xp: 450,\n goldMin: 8,\n goldMax: 20,\n },\n {\n name: \"Wight\",\n cr: 3,\n ac: 14,\n hp: 45,\n atk: 4,\n dmgDice: 1,\n dmgSides: 8,\n dmgBonus: 2,\n xp: 450,\n goldMin: 6,\n goldMax: 16,\n },\n {\n name: \"Werewolf\",\n cr: 3,\n ac: 12,\n hp: 58,\n atk: 5,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 3,\n xp: 450,\n goldMin: 4,\n goldMax: 14,\n },\n\n // --- Dangerous (CR ~4-6) ---\n {\n name: \"Owlbear\",\n cr: 3,\n ac: 13,\n hp: 59,\n atk: 7,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 5,\n xp: 450,\n goldMin: 6,\n goldMax: 18,\n },\n {\n name: \"Ettin\",\n cr: 4,\n ac: 12,\n hp: 85,\n atk: 7,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 5,\n xp: 1100,\n goldMin: 10,\n goldMax: 25,\n },\n {\n name: \"Manticore\",\n cr: 3,\n ac: 14,\n hp: 68,\n atk: 6,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 4,\n xp: 700,\n goldMin: 8,\n goldMax: 20,\n },\n {\n name: \"Black Pudding\",\n cr: 4,\n ac: 7,\n hp: 85,\n atk: 7,\n dmgDice: 3,\n dmgSides: 6,\n dmgBonus: 4,\n xp: 1100,\n goldMin: 0,\n goldMax: 5,\n },\n {\n name: \"Troll\",\n cr: 5,\n ac: 15,\n hp: 84,\n atk: 7,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 5,\n xp: 1800,\n goldMin: 10,\n goldMax: 30,\n },\n {\n name: \"Hill Giant\",\n cr: 5,\n ac: 13,\n hp: 105,\n atk: 8,\n dmgDice: 3,\n dmgSides: 8,\n dmgBonus: 5,\n xp: 1800,\n goldMin: 15,\n goldMax: 35,\n },\n {\n name: \"Wyvern\",\n cr: 6,\n ac: 13,\n hp: 110,\n atk: 8,\n dmgDice: 2,\n dmgSides: 8,\n dmgBonus: 5,\n xp: 2300,\n goldMin: 15,\n goldMax: 40,\n },\n {\n name: \"Chimera\",\n cr: 6,\n ac: 14,\n hp: 114,\n atk: 8,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 5,\n xp: 2300,\n goldMin: 15,\n goldMax: 40,\n },\n\n // --- Deadly (CR ~7-10) ---\n {\n name: \"Stone Giant\",\n cr: 7,\n ac: 17,\n hp: 126,\n atk: 9,\n dmgDice: 3,\n dmgSides: 8,\n dmgBonus: 6,\n xp: 2900,\n goldMin: 20,\n goldMax: 50,\n },\n {\n name: \"Young Green Dragon\",\n cr: 8,\n ac: 18,\n hp: 136,\n atk: 10,\n dmgDice: 2,\n dmgSides: 10,\n dmgBonus: 6,\n xp: 3900,\n goldMin: 30,\n goldMax: 75,\n },\n {\n name: \"Hezrou (Demon)\",\n cr: 8,\n ac: 16,\n hp: 136,\n atk: 9,\n dmgDice: 3,\n dmgSides: 8,\n dmgBonus: 6,\n xp: 3900,\n goldMin: 20,\n goldMax: 55,\n },\n {\n name: \"Fire Giant\",\n cr: 9,\n ac: 18,\n hp: 162,\n atk: 11,\n dmgDice: 3,\n dmgSides: 10,\n dmgBonus: 7,\n xp: 5000,\n goldMin: 35,\n goldMax: 90,\n },\n {\n name: \"Young Red Dragon\",\n cr: 10,\n ac: 18,\n hp: 178,\n atk: 11,\n dmgDice: 2,\n dmgSides: 10,\n dmgBonus: 7,\n xp: 5900,\n goldMin: 40,\n goldMax: 100,\n },\n {\n name: \"Aboleth\",\n cr: 10,\n ac: 17,\n hp: 135,\n atk: 9,\n dmgDice: 2,\n dmgSides: 6,\n dmgBonus: 6,\n xp: 5900,\n goldMin: 20,\n goldMax: 60,\n },\n\n // --- Legendary (CR ~12+, endgame flavor with no actual \"end\") ---\n {\n name: \"Frost Giant Jarl\",\n cr: 12,\n ac: 16,\n hp: 190,\n atk: 12,\n dmgDice: 3,\n dmgSides: 12,\n dmgBonus: 8,\n xp: 8400,\n goldMin: 50,\n goldMax: 120,\n },\n {\n name: \"Adult Black Dragon\",\n cr: 14,\n ac: 19,\n hp: 195,\n atk: 13,\n dmgDice: 2,\n dmgSides: 10,\n dmgBonus: 8,\n xp: 11500,\n goldMin: 60,\n goldMax: 150,\n },\n {\n name: \"Balor (Demon Lord's Herald)\",\n cr: 19,\n ac: 19,\n hp: 262,\n atk: 14,\n dmgDice: 3,\n dmgSides: 10,\n dmgBonus: 9,\n xp: 22000,\n goldMin: 100,\n goldMax: 250,\n },\n {\n name: \"Ancient Red Dragon\",\n cr: 24,\n ac: 22,\n hp: 546,\n atk: 17,\n dmgDice: 2,\n dmgSides: 10,\n dmgBonus: 10,\n xp: 62000,\n goldMin: 150,\n goldMax: 400,\n },\n];\n\nexport const items: ItemDef[] = [\n // --- Potions ---\n {\n key: \"minor_potion\",\n name: \"Potion of Minor Healing\",\n type: \"potion\",\n heal: [2, 4, 2],\n price: 8,\n desc: \"restores 2d4+2 HP when drunk\",\n },\n {\n key: \"greater_potion\",\n name: \"Potion of Healing\",\n type: \"potion\",\n heal: [4, 6, 4],\n price: 20,\n desc: \"restores 4d6+4 HP when drunk\",\n },\n {\n key: \"superior_potion\",\n name: \"Superior Potion of Healing\",\n type: \"potion\",\n heal: [6, 8, 6],\n price: 40,\n desc: \"restores 6d8+6 HP when drunk\",\n },\n {\n key: \"draught_of_vigor\",\n name: \"Draught of Vigor\",\n type: \"potion\",\n heal: [3, 4, 3],\n price: 12,\n desc: \"restores 3d4+3 HP, tastes faintly of cinnamon\",\n },\n {\n key: \"travelers_tonic\",\n name: \"Traveler's Tonic\",\n type: \"potion\",\n heal: [1, 4, 1],\n price: 5,\n desc: \"restores 1d4+1 HP, better than nothing\",\n },\n {\n key: \"elixir_of_vitality\",\n name: \"Elixir of Vitality\",\n type: \"potion\",\n heal: [8, 10, 8],\n price: 65,\n desc: \"restores 8d10+8 HP when drunk\",\n },\n\n // --- Weapons ---\n {\n key: \"rusty_shortsword\",\n name: \"Rusty Shortsword\",\n type: \"weapon\",\n atkBonus: 1,\n price: 15,\n desc: \"+1 to hunt rolls while equipped\",\n },\n {\n key: \"iron_longsword\",\n name: \"Iron Longsword\",\n type: \"weapon\",\n atkBonus: 2,\n price: 35,\n desc: \"+2 to hunt rolls while equipped\",\n },\n {\n key: \"fine_rapier\",\n name: \"Finely Balanced Rapier\",\n type: \"weapon\",\n atkBonus: 3,\n price: 60,\n desc: \"+3 to hunt rolls while equipped\",\n },\n {\n key: \"steel_greataxe\",\n name: \"Steel Greataxe\",\n type: \"weapon\",\n atkBonus: 4,\n price: 90,\n desc: \"+4 to hunt rolls while equipped\",\n },\n {\n key: \"ancient_blade\",\n name: \"Ancient Blade of Unknown Make\",\n type: \"weapon\",\n atkBonus: 5,\n price: 130,\n desc: \"+5 to hunt rolls while equipped\",\n },\n {\n key: \"twin_daggers\",\n name: \"Twin Daggers\",\n type: \"weapon\",\n atkBonus: 2,\n price: 35,\n desc: \"+2 to hunt rolls while equipped\",\n },\n {\n key: \"runed_warhammer\",\n name: \"Runed Warhammer\",\n type: \"weapon\",\n atkBonus: 4,\n price: 90,\n desc: \"+4 to hunt rolls while equipped\",\n },\n {\n key: \"wanderers_cursed_blade\",\n name: \"Wanderer's Cursed Blade\",\n type: \"weapon\",\n atkBonus: 6,\n price: 180,\n desc: \"+6 to hunt rolls while equipped, whispers faintly at night\",\n },\n\n // --- Armor ---\n {\n key: \"padded_vest\",\n name: \"Padded Leather Vest\",\n type: \"armor\",\n acBonus: 1,\n price: 15,\n desc: \"+1 AC while equipped\",\n },\n {\n key: \"chain_shirt\",\n name: \"Chain Shirt\",\n type: \"armor\",\n acBonus: 2,\n price: 35,\n desc: \"+2 AC while equipped\",\n },\n {\n key: \"plate_scraps\",\n name: \"Salvaged Plate Scraps\",\n type: \"armor\",\n acBonus: 3,\n price: 60,\n desc: \"+3 AC while equipped\",\n },\n {\n key: \"reinforced_plate\",\n name: \"Reinforced Plate\",\n type: \"armor\",\n acBonus: 4,\n price: 90,\n desc: \"+4 AC while equipped\",\n },\n {\n key: \"dragonhide_cloak\",\n name: \"Dragonhide Cloak\",\n type: \"armor\",\n acBonus: 5,\n price: 130,\n desc: \"+5 AC while equipped\",\n },\n {\n key: \"wolfskin_mantle\",\n name: \"Wolfskin Mantle\",\n type: \"armor\",\n acBonus: 2,\n price: 35,\n desc: \"+2 AC while equipped\",\n },\n {\n key: \"runed_bulwark\",\n name: \"Runed Bulwark\",\n type: \"armor\",\n acBonus: 4,\n price: 90,\n desc: \"+4 AC while equipped\",\n },\n {\n key: \"wyrmscale_aegis\",\n name: \"Wyrmscale Aegis\",\n type: \"armor\",\n acBonus: 6,\n price: 180,\n desc: \"+6 AC while equipped, faintly warm to the touch\",\n },\n\n // --- Trinkets (flavor only) ---\n {\n key: \"lucky_coin\",\n name: \"Merchant's Lucky Coin\",\n type: \"trinket\",\n price: 5,\n desc: \"brings no measurable luck, but it is shiny\",\n },\n {\n key: \"dragon_scale_dyed\",\n name: \"'Authentic' Dragon Scale (dyed lizard)\",\n type: \"trinket\",\n price: 4,\n desc: \"not a real dragon scale\",\n },\n {\n key: \"chalk_wards\",\n name: \"Bundle of Warding Chalk\",\n type: \"trinket\",\n price: 3,\n desc: \"mostly unbroken chalk sticks\",\n },\n {\n key: \"cracked_mirror\",\n name: \"Cracked Scrying Mirror\",\n type: \"trinket\",\n price: 10,\n desc: \"only ever shows yesterday\",\n },\n {\n key: \"owlbear_whiskers\",\n name: \"Jar of Pickled Owlbear Whiskers\",\n type: \"trinket\",\n price: 6,\n desc: \"for luck, allegedly\",\n },\n {\n key: \"tarnished_locket\",\n name: \"Tarnished Locket\",\n type: \"trinket\",\n price: 7,\n desc: \"empty; the portrait fell out years ago\",\n },\n {\n key: \"whistling_stone\",\n name: \"Whistling Stone\",\n type: \"trinket\",\n price: 2,\n desc: \"hums faintly in a strong wind\",\n },\n {\n key: \"moth_eaten_cloak\",\n name: 'Moth-Eaten \"Invisibility\" Cloak',\n type: \"trinket\",\n price: 9,\n desc: \"does not, in fact, turn you invisible\",\n },\n {\n key: \"mostly_empty_bag\",\n name: \"Bag of Holding (mostly empty)\",\n type: \"trinket\",\n price: 18,\n desc: \"holds slightly more than it should\",\n },\n {\n key: \"dubious_map\",\n name: \"Dubious Treasure Map\",\n type: \"trinket\",\n price: 5,\n desc: \"X marks a spot that is now a well-known bakery\",\n },\n {\n key: \"bent_spoon\",\n name: \"Suspiciously Bent Spoon\",\n type: \"trinket\",\n price: 3,\n desc: \"bends further if you stare at it\",\n },\n {\n key: \"empty_bottle\",\n name: \"Empty Potion Bottle\",\n type: \"trinket\",\n price: 1,\n desc: \"smells faintly of adventure\",\n },\n {\n key: \"singed_parchment\",\n name: \"Singed Parchment Scrap\",\n type: \"trinket\",\n price: 4,\n desc: \"the important part burned off\",\n },\n {\n key: \"necklace_of_ears\",\n name: \"Necklace of Suspicious Ears\",\n type: \"trinket\",\n price: 8,\n desc: 'the merchant insists they are \"ethically sourced\"',\n },\n {\n key: \"unlucky_die\",\n name: \"Unlucky Six-Sided Die\",\n type: \"trinket\",\n price: 2,\n desc: \"has never once rolled a 6\",\n },\n {\n key: \"tin_crown\",\n name: \"Tin Crown\",\n type: \"trinket\",\n price: 12,\n desc: \"makes you feel briefly regal\",\n },\n];\n\nexport const merchantNames: string[] = [\n \"Wobble\",\n \"Pruneface Yorik\",\n \"Tansy Ninefingers\",\n \"Old Corrin\",\n \"Tam Pockets\",\n \"Squint\",\n \"Nan Gullyfoot\",\n \"Kettle\",\n \"Sella Windrags\",\n];\n\n// Story snippets for the periodic \"item lore\" ambient event (see twitch.ts).\n// Templated with {owner} (the merchant hawking it), {item} (item name), and\n// {desc} (the item's short flavor description) — filled in at post time,\n// keyed by item type so a weapon gets a different flavor of story than a\n// trinket. These describe wares currently sitting on the stall.\nexport const itemStoryTemplates: Record = {\n potion: [\n \"{owner} swears the {item} still smells faintly of the alchemist's cellar where it was brewed.\",\n \"{owner} won't say where the {item} came from, only that it works — mostly.\",\n \"According to {owner}, the {item} was mixed during a thunderstorm. Make of that what you will.\",\n \"{owner} keeps the {item} wrapped in cloth on the cart, just in case it's more fragile than it looks.\",\n \"{owner} has never actually watched the {item} get made, and has decided it's best not to ask.\",\n ],\n weapon: [\n \"{owner} claims the {item} saw at least one real battle before it reached the stall.\",\n \"The {item} on {owner}'s cart has a nick along the edge — {owner} tells a different story about it every time asked.\",\n \"{owner} insists the {item} balances better than it has any right to for the price.\",\n \"Nobody's quite sure who owned the {item} before {owner}, least of all {owner}.\",\n \"{owner} keeps meaning to have the {item} properly appraised. Hasn't happened yet.\",\n ],\n armor: [\n \"{owner} says the dent in the {item} was already there when it arrived — no questions asked, no answers given.\",\n \"The {item} {owner} has on offer saw at least one battle before it ever reached the cart.\",\n \"{owner} keeps meaning to have the {item} properly cleaned up. Hasn't happened yet.\",\n \"{owner} found a second buckle sewn inside the {item}. Still hasn't figured out why.\",\n \"The {item} on {owner}'s cart creaks a little in the cold. {owner} calls that character.\",\n ],\n trinket: [\n \"{owner} isn't entirely sure what the {item} does, only that it seemed worth hauling to market.\",\n \"{owner} claims the {item} is good luck. The Clerk's ledger shows no evidence either way.\",\n \"Nobody quite remembers where {owner} got the {item}. {owner} isn't telling.\",\n \"{owner} has caught themselves talking to the {item} more than once on the road. It has never answered.\",\n \"{owner} keeps dropping the price on the {item} just to see if anyone will bite. So far, no one has.\",\n ],\n};",[183],"3d0e1f87-12e7-4bd1-a99a-f39c0abb56aa","commands.ts","95021c76-ae3e-11f1-a725-1607ee4eb77e",54,["D",1789171944478],"// =============================================================================\n// commands.ts — one async function per player-facing command. Each takes\n// (username, display, args) and returns the reply string.\n// To add a new command: write the function here, then add one line to\n// COMMAND_DEFS at the bottom of twitch.ts.\n// =============================================================================\nimport {\n Advisor,\n AutoHunt,\n Character,\n Combat,\n Inventory,\n ItemLookup,\n Merchant,\n MonsterLookup,\n Rules,\n Util,\n} from \"./game.ts\";\nimport { QuestBoard } from \"./quests.ts\";\nimport * as Store from \"./storeClient.ts\";\n\nconst GUIDE_URL = \"https://huntandhoardbot.val.run/commands\";\n\n// Checks the current quest board for a bounty on `monsterName`, logs\n// `kills` toward it for this character, and auto turns it in (grants\n// reward, rerolls that board slot) the moment it's met. Returns a message\n// fragment to tack onto the hunt reply, or \"\" if no quest was touched.\nexport async function applyQuestProgress(\n c: Character,\n monsterName: string,\n kills: number,\n): Promise {\n if (kills <= 0) return \"\";\n const board = await Store.getQuestBoard();\n const found = QuestBoard.findByMonsterName(board, monsterName);\n if (!found) return \"\";\n\n const { quest, index } = found;\n const updated = (c.questProgress[quest.id] || 0) + kills;\n\n if (updated >= quest.targetCount) {\n c.gold += quest.goldReward;\n let rewardMsg = \"+\" + quest.goldReward + \" gold\";\n if (quest.itemReward) {\n Inventory.add(c, quest.itemReward);\n rewardMsg += \" and a \" + quest.itemReward.name;\n }\n delete c.questProgress[quest.id];\n board[index] = QuestBoard.rollQuest();\n await Store.saveQuestBoard(board);\n return \" 📜 Bounty fulfilled! The Clerk unseals the coffer for the \" +\n quest.monsterName + \" contract — \" + rewardMsg +\n \". A fresh posting goes up on the board.\";\n }\n\n c.questProgress[quest.id] = updated;\n return \" 📜 Bounty progress: \" + quest.monsterName + \" \" + updated + \"/\" +\n quest.targetCount + \".\";\n}\n\nexport async function help(\n _username: string,\n display: string,\n): Promise {\n return \"@\" + display +\n \" 📜 The Clerk keeps the full charter of commands sealed at this scroll: \" +\n GUIDE_URL;\n}\n\nconst LURK_LINES = [\n \" slips into the shadows at the back of the guildhall, cloak drawn — still within earshot of the bounty board.\",\n \" takes a quiet seat in the corner booth, boots up on the table, one eye on the room.\",\n \" melts into the tavern crowd, nursing a drink and watching the door.\",\n ' retreats to the archive stacks to \"study,\" though the Clerk suspects a nap is more likely.',\n \" posts up by the hearth, hood low, content to let the other adventurers take the spotlight.\",\n \" signs the guest ledger and disappears into the rafters like a proper rogue.\",\n \" leans against the back wall near the notice board, present but unbothered.\",\n \" ducks behind a stack of crates in the storeroom — technically still on guild grounds.\",\n \" curls up with the guild cat by the window and goes very, very still.\",\n \" steps into the scrying pool's reflection, watching from just out of frame.\",\n];\n\nexport async function lurk(\n _username: string,\n display: string,\n): Promise {\n const line = LURK_LINES[Math.floor(Math.random() * LURK_LINES.length)];\n return \"@\" + display + \" 🥷\" + line +\n \" The Clerk marks you present in the ledger all the same.\";\n}\n\nexport async function start(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" Ah, a new face at the desk! The Clerk hasn't yet entered your name in the ledger — say !enlist \" +\n \"(or !enlist random) to be sworn in, then !hunt or !autohunt to make your mark on the world. The full charter awaits at !help.\";\n }\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" The ledger reads: \" + Rules.sheetLine(c) + \" \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function createchar(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const existing = await Store.getCharacter(username);\n if (existing) {\n return \"@\" + display + \" the ledger already bears your name — \" +\n existing.name + \", Level \" + existing.level +\n '. Only one entry per adventurer is permitted; say \"!discharge confirm\" to close that file before opening a new one.';\n }\n const raw = args.join(\" \").trim();\n let name: string;\n if (!raw || raw.toLowerCase() === \"random\") {\n name = Rules.rollRandomName();\n } else if (raw.length > 24) {\n return \"@\" + display +\n \" that name won't fit the ledger's margin (24 characters max). Try again, or say \\\"!enlist random\\\" and let the Clerk choose.\";\n } else if (!/^[a-zA-Z' -]+$/.test(raw)) {\n return \"@\" + display +\n ' the Clerk\\'s quill only forms letters, spaces, apostrophes, and hyphens. Try again, or say \"!enlist random\".';\n } else {\n name = raw;\n }\n const character = Rules.createCharacter(username, name);\n await Store.saveCharacter(character);\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" the quill scratches across the ledger — \" +\n character.name + \" is sworn in as a Level 1 \" +\n character.race.name + \" \" + character.cls.name + \"! \" +\n Rules.sheetLine(character) + \". \" +\n Advisor.recommendNextAction(character, offers);\n}\n\nexport async function character(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const targetArg = (args[0] || \"\").replace(/^@/, \"\").trim();\n\n if (!targetArg) {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" the ledger has no entry under your name yet. Say !enlist or !enlist random to begin.\";\n }\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" The ledger reads: \" + Rules.sheetLine(c) + \" \" +\n Advisor.recommendNextAction(c, offers);\n }\n\n // Looking up someone else's entry — targetArg is their Twitch username\n // (how records are keyed), not their in-game character name.\n const target = await Store.getCharacter(targetArg);\n if (!target) {\n return \"@\" + display + ' no ledger entry found for \"' + targetArg + '\".';\n }\n return \"@\" + display + \" \" + target.name + \"'s ledger entry: \" +\n Rules.sheetLine(target);\n}\n\nexport async function hunt(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" the Clerk can't send an unlisted adventurer into the field — !enlist or !enlist random first.\";\n }\n if (c.hp <= 1) {\n return \"@\" + display + \" \" + c.name + \" can barely stand (\" + c.hp + \"/\" +\n c.hpMax +\n \" HP) — the Clerk insists on !rest (or a potion) before another bout.\";\n }\n\n const targetName = args.join(\" \").trim();\n let targetMonster = undefined as ReturnType;\n if (targetName) {\n targetMonster = MonsterLookup.find(targetName);\n if (!targetMonster) {\n return \"@\" + display + ' no such quarry is known as \"' + targetName +\n '\". Check !quests for the board, or !hunt with no name and let fate pick your foe.';\n }\n }\n\n const result = Combat.huntMonster(c, targetMonster);\n const questMsg = result.won\n ? await applyQuestProgress(c, result.monster.name, 1)\n : \"\";\n await Store.saveCharacter(c);\n const offers = await Store.getMerchantOffers();\n const highlight = result.log.slice(-3).join(\", \");\n const rec = Advisor.recommendNextAction(c, offers);\n if (result.won) {\n const levelMsg = result.leveledTo\n ? \" 🎉 The bards will sing of it — leveled up to \" + result.leveledTo +\n \"!\"\n : \"\";\n return \"@\" + display + \" \" + c.name + \" crossed blades with a \" +\n result.monster.name + \" (\" + highlight + \") and prevailed! +\" +\n result.xpGained + \" XP, +\" + result.goldGained + \" gold. HP \" +\n result.hpLeft + \"/\" + result.hpMax + \".\" + levelMsg + questMsg + \" \" +\n rec;\n }\n return \"@\" + display + \" \" + c.name + \" was overmatched by a \" +\n result.monster.name + \" (\" + highlight +\n \") and beat a hasty retreat. +\" + result.xpGained +\n \" XP logged for the effort. HP \" + result.hpLeft + \"/\" + result.hpMax +\n \" — \" + rec;\n}\n\nexport async function autohunt(\n username: string,\n display: string,\n args: string[],\n channel: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" the Clerk can't send an unlisted adventurer into the field — !enlist or !enlist random first.\";\n }\n if (c.hp <= 1) {\n return \"@\" + display + \" \" + c.name + \" can barely stand (\" + c.hp + \"/\" +\n c.hpMax +\n \" HP) — the Clerk insists on !rest (or a potion) before another bout.\";\n }\n const sessions = await Store.getAutohuntSessions();\n if (sessions.some((s) => s.username === c.username)) {\n return \"@\" + display + \" \" + c.name +\n \" is already out on an autohunt — say !autohuntstop to call it back early, or !autohuntstatus to check in.\";\n }\n const raw = args.join(\" \").trim();\n const durationMs = AutoHunt.parseDuration(raw);\n if (durationMs === null) {\n return \"@\" + display +\n ' the Clerk doesn\\'t follow that duration — try \"!autohunt 20m\", \"!autohunt 1h\", or just \"!autohunt\" for the default ' +\n AutoHunt.formatDuration(AutoHunt.DEFAULT_DURATION_MS) + \".\";\n }\n sessions.push(AutoHunt.start(c, channel, durationMs));\n await Store.saveAutohuntSessions(sessions);\n return \"@\" + display + \" \" + c.name + \" heads out for \" +\n AutoHunt.formatDuration(durationMs) +\n \" of autohunting, resting up automatically if HP runs low. Say !autohuntstop to recall early, or !autohuntstatus to check in.\";\n}\n\nexport async function autohuntstop(\n username: string,\n display: string,\n): Promise {\n const sessions = await Store.getAutohuntSessions();\n const idx = sessions.findIndex((s) => s.username === username.toLowerCase());\n if (idx === -1) {\n return \"@\" + display + \" no autohunt is currently running for you.\";\n }\n const [session] = sessions.splice(idx, 1);\n await Store.saveAutohuntSessions(sessions);\n const c = await Store.getCharacter(username);\n return \"@\" + display + \" \" +\n (c\n ? AutoHunt.summary(c, session, \"called back early\")\n : \"the Clerk recalls the party.\");\n}\n\nexport async function autohuntstatus(\n username: string,\n display: string,\n): Promise {\n const sessions = await Store.getAutohuntSessions();\n const session = sessions.find((s) => s.username === username.toLowerCase());\n if (!session) {\n return \"@\" + display +\n \" no autohunt is currently running for you. Say !autohunt to start one.\";\n }\n const remaining = Math.max(0, session.endsAt - Date.now());\n return \"@\" + display + \" autohunt in progress: \" + session.hunts + \" bout\" +\n (session.hunts === 1 ? \"\" : \"s\") + \" so far (\" +\n session.wins + \"W/\" + session.losses + \"L), +\" + session.totalXp +\n \" XP, +\" + session.totalGold + \" gold, about \" +\n AutoHunt.formatDuration(remaining) + \" left.\";\n}\n\nexport async function rest(username: string, display: string): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display + \" the ledger has no entry under your name yet.\";\n }\n const offers = await Store.getMerchantOffers();\n const REST_RESTORE_FRACTION = 0.8; // resting patches you up, but doesn't fully heal you\n const target = Math.min(c.hpMax, Math.ceil(c.hpMax * REST_RESTORE_FRACTION));\n if (c.hp >= target) {\n return \"@\" + display + \" \" + c.name + \" is already well-rested (\" + c.hp +\n \"/\" + c.hpMax + \") — little more to gain from another sit by the fire. \" +\n Advisor.recommendNextAction(c, offers);\n }\n c.hp = target;\n await Store.saveCharacter(c);\n return \"@\" + display + \" \" + c.name + \" makes camp and recovers to \" + c.hp +\n \"/\" + c.hpMax + \" HP. \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function quests(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n const board = await Store.getQuestBoard();\n const desc = QuestBoard.describeBoard(\n board,\n (q) => (c ? c.questProgress[q.id] || 0 : 0),\n );\n const hint = c\n ? ' Say !hunt to take up a bounty, e.g. \"!hunt ' +\n board[0].monsterName + '\".'\n : \" Enlist with !enlist to start logging your progress against the board.\";\n return \"@\" + display + \" 📜 The bounty board reads: \" + desc + \".\" + hint;\n}\n\nexport async function merchant(\n _username: string,\n display: string,\n): Promise {\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" 🛒 Today's wares at the stall: \" +\n Merchant.describeOffers(offers) +\n '. Say !buy <#|item name> to make a purchase, e.g. \"!buy 1\".';\n}\n\nexport async function coinpurse(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" you've no entry in the ledger, so no purse for the Clerk to check.\";\n }\n const offers = await Store.getMerchantOffers();\n const affordable = Merchant.cheapestAffordable(offers, c.gold);\n const purseLine = \"@\" + display + \" \" + c.name + \"'s coinpurse holds \" +\n c.gold + \" gold.\";\n if (affordable) {\n return purseLine + \" Enough for \" + affordable.item.name + \" (\" +\n affordable.item.price + \" gold) at !merchant — !buy it.\";\n }\n if (offers.length) {\n const cheapest = offers.reduce((\n a,\n b,\n ) => (a.item.price <= b.item.price ? a : b));\n const short = cheapest.item.price - c.gold;\n return purseLine + \" Need \" + short +\n \" more gold for the cheapest ware on offer (\" + cheapest.item.name +\n \"). \" +\n Advisor.recommendNextAction(c, offers);\n }\n return purseLine + \" \" + Advisor.recommendNextAction(c, offers);\n}\n\nexport async function buy(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" the Clerk can't send an unlisted adventurer into the field — !enlist or !enlist random first.\";\n }\n const offers = await Store.getMerchantOffers();\n const needle = args.join(\" \").trim();\n if (!needle) {\n return \"@\" + display + \" buy which one? \" +\n Merchant.describeOffers(offers) +\n ' — try \"!buy 1\" or \"!buy \".';\n }\n const found = Merchant.findOffer(offers, needle);\n if (!found) {\n return \"@\" + display + ' no ware on the stall matches \"' + needle +\n '\". Current stall: ' + Merchant.describeOffers(offers);\n }\n const offer = found.offer;\n if (c.gold < offer.item.price) {\n return \"@\" + display + \" \" + offer.item.price + \" gold is needed for the \" +\n offer.item.name + \", but your purse holds only \" +\n c.gold + \". The road (!hunt) pays better than standing still.\";\n }\n c.gold -= offer.item.price;\n Inventory.add(c, offer.item);\n offers[found.index] = Merchant.rollOffer(); // only the purchased slot restocks\n await Store.saveCharacter(c);\n await Store.saveMerchantOffers(offers);\n return \"@\" + display + \" \" + offer.item.name +\n \" changes hands — bought from \" + offer.merchant + \" for \" +\n offer.item.price +\n \" gold. Check !inventory, and !use it when the moment calls. The stall has a fresh offer in that slot. \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function item(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const needle = args.join(\" \").trim();\n\n if (needle) {\n const found = ItemLookup.find(needle);\n if (!found) {\n return \"@\" + display + ' no such ware is known to the Clerk as \"' +\n needle + \"\\\". Check !merchant for what's currently on the stall.\";\n }\n return \"@\" + display + \" \" + ItemLookup.describe(found);\n }\n\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" the ledger has no entry under your name yet. Try !item to look something up directly.\";\n }\n const { weapon, armor } = c.equipped;\n if (!weapon && !armor) {\n return \"@\" + display +\n \" bare fists and no armor — nothing on you for the Clerk to appraise. Try !item to look something up directly.\";\n }\n const parts: string[] = [];\n if (weapon) parts.push(ItemLookup.describe(weapon));\n if (armor) parts.push(ItemLookup.describe(armor));\n return \"@\" + display + \" \" + parts.join(\" | \");\n}\n\nexport async function inventory(\n username: string,\n display: string,\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display + \" the ledger has no entry under your name yet.\";\n }\n if (!c.inventory.length) {\n return \"@\" + display + \" \" + c.name +\n \"'s pack is empty. Try !merchant and !buy to fill it.\";\n }\n const offers = await Store.getMerchantOffers();\n const list = c.inventory.map((it) =>\n it.name + (it.qty > 1 ? \" x\" + it.qty : \"\")\n ).join(\", \");\n return \"@\" + display + \" \" + c.name + \"'s pack holds: \" + list + \". \" +\n Advisor.recommendNextAction(c, offers);\n}\n\nexport async function use(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display + \" the ledger has no entry under your name yet.\";\n }\n const needle = args.join(\" \").trim();\n if (!needle) {\n return \"@\" + display + \" use what? Try !use , e.g. !use potion.\";\n }\n const invItem = Inventory.find(c, needle);\n if (!invItem) {\n const have = c.inventory.length\n ? c.inventory.map((it) => it.name).join(\", \")\n : \"(nothing)\";\n return \"@\" + display + ' nothing in your pack matches \"' + needle +\n '\". You carry: ' + have;\n }\n\n let msg: string;\n if (invItem.type === \"potion\") {\n const heal = invItem.heal!;\n const healed = Util.rollDice(heal[0], heal[1]) + heal[2];\n c.hp = Util.clamp(c.hp + healed, 0, c.hpMax);\n Inventory.removeOne(c, invItem);\n msg = \"@\" + display + \" \" + c.name + \" drinks down the \" + invItem.name +\n \" and recovers \" + healed + \" HP (\" + c.hp + \"/\" + c.hpMax + \").\";\n } else if (invItem.type === \"weapon\") {\n const previous = c.equipped.weapon;\n c.equipped.weapon = invItem;\n Inventory.removeOne(c, invItem);\n if (previous) Inventory.add(c, previous);\n msg = \"@\" + display + \" \" + c.name + \" draws the \" + invItem.name +\n \" and takes up arms.\";\n } else if (invItem.type === \"armor\") {\n const previous = c.equipped.armor;\n c.equipped.armor = invItem;\n Inventory.removeOne(c, invItem);\n if (previous) Inventory.add(c, previous);\n msg = \"@\" + display + \" \" + c.name + \" straps on the \" + invItem.name + \".\";\n } else {\n msg = \"@\" + display + \" the \" + invItem.name +\n \" is little more than a curiosity — nothing happens when you put it to use.\";\n }\n await Store.saveCharacter(c);\n const offers = await Store.getMerchantOffers();\n return msg + \" \" + Advisor.recommendNextAction(c, offers);\n}\n\nexport async function drop(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display + \" the ledger has no entry under your name yet.\";\n }\n const needle = args.join(\" \").trim();\n if (!needle) return \"@\" + display + \" drop what? Try !drop .\";\n const invItem = Inventory.find(c, needle);\n if (!invItem) {\n const have = c.inventory.length\n ? c.inventory.map((it) => it.name).join(\", \")\n : \"(nothing)\";\n return \"@\" + display + ' nothing in your pack matches \"' + needle +\n '\". You carry: ' + have;\n }\n Inventory.removeOne(c, invItem);\n await Store.saveCharacter(c);\n return \"@\" + display + \" the \" + invItem.name +\n \" is left behind on the road.\";\n}\n\nexport async function sell(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display + \" the ledger has no entry under your name yet.\";\n }\n const needle = args.join(\" \").trim();\n if (!needle) return \"@\" + display + \" sell what? Try !sell .\";\n const invItem = Inventory.find(c, needle);\n if (!invItem) {\n const have = c.inventory.length\n ? c.inventory.map((it) => it.name).join(\", \")\n : \"(nothing)\";\n return \"@\" + display + ' nothing in your pack matches \"' + needle +\n '\". You carry: ' + have;\n }\n const sellPrice = Math.max(1, Math.floor(invItem.price / 2));\n Inventory.removeOne(c, invItem);\n c.gold += sellPrice;\n await Store.saveCharacter(c);\n const offers = await Store.getMerchantOffers();\n return \"@\" + display + \" \" + c.name + \" sells the \" + invItem.name +\n \" back to the stall for \" + sellPrice +\n \" gold. \" + Advisor.recommendNextAction(c, offers);\n}\n\nexport async function resetchar(\n username: string,\n display: string,\n args: string[],\n): Promise {\n const c = await Store.getCharacter(username);\n if (!c) {\n return \"@\" + display +\n \" there's no entry under your name for the Clerk to close.\";\n }\n if ((args[0] || \"\").toLowerCase() !== \"confirm\") {\n return \"@\" + display + \" this will strike \" + c.name +\n ' from the ledger for good — say \"!discharge confirm\" if you\\'re certain.';\n }\n await Store.deleteCharacter(username);\n return \"@\" + display + \" the Clerk closes \" + c.name +\n \"'s file with a heavy seal. Say !enlist when you're ready to open a new one.\";\n}\n\nexport const Commands: Record<\n string,\n (\n username: string,\n display: string,\n args: string[],\n channel: string,\n ) => Promise\n> = {\n help,\n start,\n createchar,\n character,\n hunt,\n autohunt,\n autohuntstop,\n autohuntstatus,\n rest,\n merchant,\n coinpurse,\n buy,\n inventory,\n item,\n use,\n drop,\n sell,\n resetchar,\n quests,\n lurk,\n};",[190],"pulls","branches",1,"forks","envVars",{"_204":179,"_206":42},"connections",{"_204":42,"_205":42},"count","unfilledCount","emptyCount",{"_18":189,"_20":190,"_121":191,"_123":-5,"_124":71,"_125":192,"_127":38,"_22":241,"_68":129,"_130":131,"_132":194,"_134":26,"_135":-5,"_217":242,"_89":243},{"_18":182,"_20":183,"_121":184,"_123":-5,"_124":71,"_125":185,"_127":38,"_22":238,"_68":142,"_130":131,"_132":187,"_134":26,"_135":-5,"_217":239,"_89":240},{"_18":174,"_20":175,"_121":176,"_123":-5,"_124":71,"_125":177,"_127":38,"_22":235,"_68":179,"_130":131,"_132":180,"_134":26,"_135":-5,"_217":236,"_89":237},{"_18":166,"_20":167,"_121":168,"_123":-5,"_124":71,"_125":169,"_127":38,"_22":232,"_68":171,"_130":131,"_132":172,"_134":26,"_135":-5,"_217":233,"_89":234},{"_18":159,"_20":160,"_121":36,"_123":-5,"_124":71,"_125":69,"_127":38,"_22":229,"_68":148,"_130":162,"_132":163,"_134":26,"_135":164,"_217":230,"_89":231},{"_18":152,"_20":153,"_121":154,"_123":-5,"_124":71,"_125":155,"_127":38,"_22":226,"_68":129,"_130":131,"_132":157,"_134":26,"_135":-5,"_217":227,"_89":228},{"_18":145,"_20":146,"_121":147,"_123":-5,"_124":71,"_125":148,"_127":38,"_22":223,"_68":129,"_130":131,"_132":150,"_134":26,"_135":-5,"_217":224,"_89":225},{"_18":137,"_20":138,"_121":139,"_123":-5,"_124":71,"_125":140,"_127":38,"_22":220,"_68":142,"_130":131,"_132":143,"_134":26,"_135":-5,"_217":221,"_89":222},{"_18":119,"_20":120,"_121":122,"_123":-5,"_124":71,"_125":126,"_127":38,"_22":216,"_68":129,"_130":131,"_132":133,"_134":26,"_135":-5,"_217":218,"_89":219},["D",1789172000609],"children",[],[120],["D",1788756910186],[],[138],["D",1788718301227],[],[146],["D",1789172956527],[],[153],["D",1789326312713],[],[160],["D",1789172971701],[],[167],["D",1789171975782],[],[175],["D",1789173371805],[],[183],["D",1789171944478],[],[190],["D",1788715747973],["D",1789500689328],{"_16":17,"_87":83},{"_16":17,"_80":81,"_82":83,"_33":34,"_84":85,"_86":26},{"_68":69,"_20":70,"_18":71,"_72":19,"_73":-5,"_74":-5,"_75":-5,"_76":-5,"_77":-5,"_78":21,"_79":17},"ctx",{"_61":-5,"_107":282,"_283":284,"_285":286,"_287":26,"_288":26,"_289":26,"_290":38,"_291":-5,"_292":-7,"_293":-7,"_294":42,"_295":26,"_296":26,"_297":-5,"_298":26,"_299":26,"_300":26,"_301":-5},"ENV",{"_253":254,"_255":256,"_257":70,"_258":259,"_260":261,"_262":263,"_264":265,"_266":267,"_268":269,"_270":271,"_272":273,"_274":275,"_276":277,"_278":279,"_280":281},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]