pi-roundtable 0.1.0

package/src/core/i18n/agent-panel.ts

@@ -0,0 +1,96 @@
+import type { CatalogContext } from "./types.ts";
+
+/** The agent panel of `/<root> profile`: its text, buttons, and forms. */
+export function agentPanelEn(ctx: CatalogContext) {
+	return {
+		agentSkillBuiltin: (name: string) => `\`${name}\` (built in)`,
+		agentSkills: (names: readonly string[]) =>
+			`**Skills** · ${names.join(", ")}`,
+		agentSkillMissing: (name: string, reason: string) =>
+			`⚠️ \`${name}\` could not be loaded: ${reason}`,
+		agentGroupChannel: `This is a group channel with no agent of its own. See its members and host with \`/${ctx.root} status\`; to change a member, use \`/${ctx.root} profile\` in its channel.`,
+		agentNoAgent: `This channel has no agent. \`/${ctx.root} profile\` works in an agent's channel in the agent server.`,
+		agentFollowsAssistant: `(follows ${ctx.assistant})`,
+		agentHeader: (v: {
+			displayName: string;
+			name: string;
+			model: string;
+			thinking: string;
+			follows: string;
+			skills: string;
+		}) =>
+			`### ${v.displayName}\n-# agent name \`${v.name}\`, cannot be changed\n**Model** · \`${v.model}\` · thinking \`${v.thinking}\`${v.follows}\n${v.skills}\n-# To add or remove a skill, ask any agent to use agent_skills.`,
+		agentAvatarPromptText: (prompt: string) => `**Avatar prompt**\n${prompt}`,
+		agentPromptInline: (prompt: string) =>
+			`**Prompt**\n\`\`\`\n${prompt}\n\`\`\``,
+		agentPromptFile: (length: number) =>
+			`**Prompt** · ${length} characters, the full text is in the file below.`,
+		agentEditPromptLabel: "Edit prompt",
+		agentRedrawLabel: "Redraw avatar",
+		agentNewAvatarPromptLabel: "New avatar prompt",
+		agentEditAvatarLabel: "Edit avatar",
+		agentModelLabel: "Model",
+		agentDefaultNote:
+			"A changed prompt takes effect from this agent's next turn; the conversation history is kept.",
+		agentNotFound: "That agent was not found.",
+		agentFollowAssistant: (value: string) =>
+			`Follow ${ctx.assistant} (${value})`,
+		agentModelModalTitle: (displayName: string) => `${displayName}'s model`,
+		agentEditModalTitle: (displayName: string) => `Edit ${displayName}`,
+		agentDisplayNameLabel: "Display name",
+		agentPromptLabel: "Prompt",
+		agentAvatarPromptLabel: "Avatar prompt (state the background colour)",
+		agentEditAvatarField: "How to change it (for example: add a hat)",
+		agentSaved: "Saved; it takes effect from the next turn.",
+		agentAvatarRedrawn: "The new avatar shows from this agent's next message.",
+		agentAvatarFailed: (message: string) =>
+			`The avatar was not drawn: ${message}`,
+	};
+}
+
+export function agentPanelZhTW(
+	ctx: CatalogContext,
+): ReturnType<typeof agentPanelEn> {
+	return {
+		agentSkillBuiltin: (name: string) => `\`${name}\`（內建）`,
+		agentSkills: (names: readonly string[]) => `**Skill**　${names.join("、")}`,
+		agentSkillMissing: (name: string, reason: string) =>
+			`⚠️ \`${name}\` 無法載入：${reason}`,
+		agentGroupChannel: `這是群組頻道，沒有自己的 agent。成員和主持人請用 \`/${ctx.root} status\` 查看；要改某個成員，到它的頻道用 \`/${ctx.root} profile\`。`,
+		agentNoAgent: `這個頻道沒有 agent。\`/${ctx.root} profile\` 要在 agent 伺服器裡某個 agent 的頻道使用。`,
+		agentFollowsAssistant: `（跟隨 ${ctx.assistant}）`,
+		agentHeader: (v: {
+			displayName: string;
+			name: string;
+			model: string;
+			thinking: string;
+			follows: string;
+			skills: string;
+		}) =>
+			`### ${v.displayName}\n-# agent 名稱 \`${v.name}\`，不能更改\n**模型**　\`${v.model}\`　thinking \`${v.thinking}\`${v.follows}\n${v.skills}\n-# 要增減 skill，請任一個 agent 用 agent_skills。`,
+		agentAvatarPromptText: (prompt: string) => `**頭像提示詞**\n${prompt}`,
+		agentPromptInline: (prompt: string) =>
+			`**提示詞**\n\`\`\`\n${prompt}\n\`\`\``,
+		agentPromptFile: (length: number) =>
+			`**提示詞**　${length} 字，完整內容在下面的檔案。`,
+		agentEditPromptLabel: "編輯提示詞",
+		agentRedrawLabel: "重畫頭像",
+		agentNewAvatarPromptLabel: "新頭像提示詞",
+		agentEditAvatarLabel: "修改頭像",
+		agentModelLabel: "模型",
+		agentDefaultNote:
+			"提示詞改完，從這個 agent 的下一回合開始生效；對話紀錄保留。",
+		agentNotFound: "找不到這個 agent。",
+		agentFollowAssistant: (value: string) =>
+			`跟隨 ${ctx.assistant}（${value}）`,
+		agentModelModalTitle: (displayName: string) => `${displayName} 的模型`,
+		agentEditModalTitle: (displayName: string) => `編輯 ${displayName}`,
+		agentDisplayNameLabel: "顯示名",
+		agentPromptLabel: "提示詞",
+		agentAvatarPromptLabel: "頭像提示詞（寫明背景色）",
+		agentEditAvatarField: "要怎麼改（例如：加一頂帽子）",
+		agentSaved: "已儲存，從下一回合開始生效。",
+		agentAvatarRedrawn: "新頭像從這個 agent 的下一則訊息開始顯示。",
+		agentAvatarFailed: (message: string) => `頭像沒有畫成：${message}`,
+	};
+}

package/src/core/i18n/cards.ts

@@ -0,0 +1,64 @@
+import type { CatalogContext } from "./types.ts";
+
+/** The owner's approval and question cards. */
+export function cardsEn(ctx: CatalogContext) {
+	return {
+		cardRunLabel: "Run",
+		cardCancelLabel: "Cancel",
+		cardApprovalFooter:
+			"If nobody answers within 30 minutes, it falls back to waiting for your confirmation in text.",
+		cardQuestionFooter: "Valid for 30 minutes.",
+		cardStopped: "⏹️ This round was stopped.",
+		cardExpired: "⌛ Timed out with no answer.",
+		cardOwnerOnly: `Only ${ctx.assistant}'s owner can answer this card.`,
+		cardApproversNote: (minTier: string) =>
+			`-# Who can approve: ${minTier} and above`,
+		cardApproversRefusal: (minTier: string) =>
+			`This card needs ${minTier} or above to answer.`,
+		cardAskerNote: (userId: string) => `-# Who can answer: <@${userId}>`,
+		cardAskerRefusal: "This question is for another speaker.",
+		cardInactive: `This card is no longer active (it timed out, or ${ctx.assistant} restarted); reply in text if you need to.`,
+		cardApproved: "✅ Approved to run.",
+		cardDeclined: "❌ Cancelled.",
+		cardAnswerLabel: "Answer…",
+		cardOtherLabel: "Other…",
+		cardOtherDescription: "Write your own answer",
+		cardPickManyPlaceholder: "Pick as many as you like",
+		cardPickOnePlaceholder: "Pick one",
+		cardModalTitle: "Answer",
+		cardModalField: "Your answer",
+		cardQuote: (text: string) => `“${text}”`,
+		cardAnswered: (parts: readonly string[]) =>
+			`Answered: ${parts.join(", ").slice(0, 300)}`,
+	};
+}
+
+export function cardsZhTW(ctx: CatalogContext): ReturnType<typeof cardsEn> {
+	return {
+		cardRunLabel: "執行",
+		cardCancelLabel: "取消",
+		cardApprovalFooter: "30 分鐘內沒回覆，就改成等你用文字確認。",
+		cardQuestionFooter: "30 分鐘內有效。",
+		cardStopped: "⏹️ 這一輪已停止。",
+		cardExpired: "⌛ 已逾時，沒有回答。",
+		cardOwnerOnly: `只有 ${ctx.assistant} 的擁有者能回答這張卡片。`,
+		cardApproversNote: (minTier: string) => `-# 可以核准的人：${minTier} 以上`,
+		cardApproversRefusal: (minTier: string) =>
+			`這張卡片要 ${minTier} 以上才能回答。`,
+		cardAskerNote: (userId: string) => `-# 可以回答的人：<@${userId}>`,
+		cardAskerRefusal: "這張問題是問另一位發話者的。",
+		cardInactive: `這張卡片已經失效（逾時，或 ${ctx.assistant} 重新啟動過）；需要的話直接打字回覆。`,
+		cardApproved: "✅ 已核准執行。",
+		cardDeclined: "❌ 已取消。",
+		cardAnswerLabel: "回答…",
+		cardOtherLabel: "其他…",
+		cardOtherDescription: "自己寫答案",
+		cardPickManyPlaceholder: "可以選好幾個",
+		cardPickOnePlaceholder: "選一個",
+		cardModalTitle: "回答",
+		cardModalField: "你的回答",
+		cardQuote: (text: string) => `「${text}」`,
+		cardAnswered: (parts: readonly string[]) =>
+			`已回答：${parts.join("、").slice(0, 300)}`,
+	};
+}

package/src/core/i18n/channels.ts

@@ -0,0 +1,28 @@
+import type { CatalogContext } from "./types.ts";
+
+/** What each channel operation is called in the owner's grant panels. */
+export function channelsEn(_ctx: CatalogContext) {
+	return {
+		opRead: "Read messages and channel data",
+		opSend: "Send text, images, and attachments",
+		opEdit: "Edit the bot's messages and attachments",
+		opPin: "Pin and unpin",
+		opDelete: "Delete messages",
+		opChannel: "Change channel settings",
+		opPermissions: "Change channel permissions",
+	};
+}
+
+export function channelsZhTW(
+	_ctx: CatalogContext,
+): ReturnType<typeof channelsEn> {
+	return {
+		opRead: "讀取訊息與頻道資料",
+		opSend: "發送文字、圖片與附件",
+		opEdit: "修改 Bot 訊息與附件",
+		opPin: "置頂與取消置頂",
+		opDelete: "刪除訊息",
+		opChannel: "修改頻道設定",
+		opPermissions: "修改頻道權限",
+	};
+}

package/src/core/i18n/conversation.ts

@@ -0,0 +1,49 @@
+import type { CatalogContext } from "./types.ts";
+
+/** Notices, thread lines, and titles a conversation posts on its own. */
+export function conversationEn(ctx: CatalogContext) {
+	return {
+		failureNotice:
+			"Sorry, this reply did not go through. Please try again later.",
+		stoppedNotice: "-# Stopped.",
+		roundLimitNotice:
+			"-# This round already has 8 replies, so it stops here; call us again if you need more.",
+		restartNotice: `-# ${ctx.assistant} restarted before this job finished, so nothing more will be reported here.`,
+		threadStarted: (name: string, thread: string | undefined) =>
+			thread ? `🧵 Started: ${name} → ${thread}` : `🧵 Started: ${name}`,
+		delegationTask: (task: string) => `📋 Task:\n${task}`,
+		delegationDone: (report: string) => `✅ Done\n\n${report}`,
+		delegationFailed: (error: string) => `❌ Failed: ${error}`,
+		agentNoReply: (message: string) => `❌ No reply: ${message}`,
+		messageDelivered: (displayName: string, text: string) =>
+			`📨 To **${displayName}**:\n${text}`,
+		answerReturned: (text: string) => `↩️ Reply:\n${text}`,
+		thinkingAuto: "auto",
+		confirmTitle: (asker: string) => `${asker} wants to run this action`,
+		askTitle: (asker: string) => `${asker} has a question for you`,
+	};
+}
+
+export function conversationZhTW(
+	ctx: CatalogContext,
+): ReturnType<typeof conversationEn> {
+	return {
+		failureNotice: "抱歉，這次沒能完成回覆，請稍後再試一次。",
+		stoppedNotice: "-# 已停止。",
+		roundLimitNotice:
+			"-# 這一輪已經有 8 則回覆，先停在這裡；需要的話請再叫我們。",
+		restartNotice: `-# ${ctx.assistant} 在這項工作結束前重新啟動了，這裡不會再有回報。`,
+		threadStarted: (name: string, thread: string | undefined) =>
+			thread ? `🧵 開始：${name} → ${thread}` : `🧵 開始：${name}`,
+		delegationTask: (task: string) => `📋 任務：\n${task}`,
+		delegationDone: (report: string) => `✅ 完成\n\n${report}`,
+		delegationFailed: (error: string) => `❌ 失敗：${error}`,
+		agentNoReply: (message: string) => `❌ 沒有回覆：${message}`,
+		messageDelivered: (displayName: string, text: string) =>
+			`📨 給 **${displayName}**：\n${text}`,
+		answerReturned: (text: string) => `↩️ 回覆：\n${text}`,
+		thinkingAuto: "自動",
+		confirmTitle: (asker: string) => `${asker} 要執行這個動作`,
+		askTitle: (asker: string) => `${asker} 想問你`,
+	};
+}

package/src/core/i18n/dashboard.ts

@@ -0,0 +1,72 @@
+import type { CatalogContext } from "./types.ts";
+
+/** The dashboard message, its channel topic, group topics, and the assistant's webhook name. */
+export function dashboardEn(ctx: CatalogContext) {
+	return {
+		dashTitle: "## Agent server",
+		dashUpdated: (time: string) =>
+			`-# Updated ${time}; refreshed when a turn starts or ends, at most every 10 seconds`,
+		dashGroupsHeading: "### Groups",
+		dashContextNone: "context —",
+		dashContextCompacted: (limit: string) =>
+			`context just compacted, updates next turn (limit ${limit})`,
+		dashContext: (tokens: string, limit: string, percent: number) =>
+			`context ${tokens} / ${limit} (${percent}%)`,
+		dashWorking: (channelId: string, waiting: number) =>
+			`🟠 Working (<#${channelId}>)${waiting > 0 ? `, ${waiting} queued` : ""}`,
+		dashQueued: (waiting: number) => `🟡 ${waiting} queued`,
+		dashIdle: "🟢 Idle",
+		dashLastActive: (time: string) => `Last active ${time}`,
+		dashNotActive: "No activity since startup",
+		dashAgentFooter: (schedules: number, last: string) =>
+			`-# Schedules ${schedules} · ${last}`,
+		dashGroupBusy: (busy: number) => `🟠 ${busy} in progress`,
+		dashGroupMembers: (members: readonly string[], host: string) =>
+			`Members: ${members.join(", ")} | Host: ${host}`,
+		dashMore: (count: number) => `-# ${count} more not listed.`,
+		dashNone: "-# None.",
+		dashTopic: `Status of ${ctx.assistant}'s agent server; this message updates itself.`,
+		groupTopic: (
+			displayName: string,
+			members: readonly string[],
+			host: string,
+		) => `${displayName} | Members: ${members.join(", ")} | Host: ${host}`,
+		webhookName: `${ctx.assistant} agents`,
+	};
+}
+
+export function dashboardZhTW(
+	ctx: CatalogContext,
+): ReturnType<typeof dashboardEn> {
+	return {
+		dashTitle: "## Agent 伺服器",
+		dashUpdated: (time: string) =>
+			`-# 更新於 ${time}；回合開始、結束時更新，最快每 10 秒一次`,
+		dashGroupsHeading: "### 群組",
+		dashContextNone: "context —",
+		dashContextCompacted: (limit: string) =>
+			`context 剛壓縮，下一回合更新（上限 ${limit}）`,
+		dashContext: (tokens: string, limit: string, percent: number) =>
+			`context ${tokens} / ${limit}（${percent}%）`,
+		dashWorking: (channelId: string, waiting: number) =>
+			`🟠 工作中（<#${channelId}>）${waiting > 0 ? `，排隊 ${waiting}` : ""}`,
+		dashQueued: (waiting: number) => `🟡 排隊 ${waiting}`,
+		dashIdle: "🟢 閒置",
+		dashLastActive: (time: string) => `最後活動 ${time}`,
+		dashNotActive: "啟動後尚未活動",
+		dashAgentFooter: (schedules: number, last: string) =>
+			`-# 排程 ${schedules} · ${last}`,
+		dashGroupBusy: (busy: number) => `🟠 進行中（${busy} 則）`,
+		dashGroupMembers: (members: readonly string[], host: string) =>
+			`成員：${members.join("、")}｜主持：${host}`,
+		dashMore: (count: number) => `-# 還有 ${count} 項沒列出。`,
+		dashNone: "-# 沒有。",
+		dashTopic: `${ctx.assistant} 的 agent 伺服器狀態，這則訊息會自動更新。`,
+		groupTopic: (
+			displayName: string,
+			members: readonly string[],
+			host: string,
+		) => `${displayName}｜成員：${members.join("、")}｜主持：${host}`,
+		webhookName: `${ctx.assistant} agents`,
+	};
+}

package/src/core/i18n/discord.ts

@@ -0,0 +1,23 @@
+import type { CatalogContext } from "./types.ts";
+
+/**
+ * Audit-log reasons and the refusals of the owner's Discord tools. They read as English in both
+ * locales: the audit log and the tools' answers are read by the owner and the model alike.
+ */
+export function discordEn(ctx: CatalogContext) {
+	return {
+		auditArranged: `${ctx.assistant} arranged the agent channels`,
+		auditArchived: `${ctx.assistant} archived this channel's agent or group`,
+		auditWebhook: `${ctx.assistant} agents speak here`,
+		auditRequested: (ownerName: string) =>
+			`${ctx.assistant}, at ${ownerName}'s request`,
+		refuseNotInServer: `${ctx.assistant} is not in that server`,
+		refuseNotVisible: `not a server channel ${ctx.assistant} can see`,
+		refuseAssistantLacks: (names: string) =>
+			`${ctx.assistant} lacks ${names} there`,
+	};
+}
+
+export function discordZhTW(ctx: CatalogContext): ReturnType<typeof discordEn> {
+	return discordEn(ctx);
+}

package/src/core/i18n/en.ts

@@ -0,0 +1,27 @@
+import { agentPanelEn } from "./agent-panel.ts";
+import { cardsEn } from "./cards.ts";
+import { channelsEn } from "./channels.ts";
+import { conversationEn } from "./conversation.ts";
+import { dashboardEn } from "./dashboard.ts";
+import { discordEn } from "./discord.ts";
+import { ownerEn } from "./owner.ts";
+import { schedulesEn } from "./schedules.ts";
+import { timeZonesEn } from "./time-zones.ts";
+import type { CatalogContext } from "./types.ts";
+
+export type Messages = ReturnType<typeof createEn>;
+
+/** The English catalog, the package's default. */
+export function createEn(ctx: CatalogContext) {
+	return {
+		...cardsEn(ctx),
+		...ownerEn(ctx),
+		...schedulesEn(ctx),
+		...timeZonesEn(),
+		...agentPanelEn(ctx),
+		...conversationEn(ctx),
+		...dashboardEn(ctx),
+		...channelsEn(ctx),
+		...discordEn(ctx),
+	};
+}

package/src/core/i18n/i18n.test.ts

@@ -0,0 +1,139 @@
+import { afterEach, describe, expect, test } from "bun:test";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { Glob } from "bun";
+import { useTestLocale } from "../testing/locale.ts";
+import { createEn } from "./en.ts";
+import { LOCALES, type Messages, messages, setLocale } from "./index.ts";
+import { createZhTW } from "./zh-tw.ts";
+
+const CTX = { assistant: "Roundtable", root: "roundtable" };
+const CJK = /[\u3400-\u9fff\u3000-\u303f\uff00-\uffef]/;
+
+type Entry = string | ((...args: never[]) => unknown);
+
+/** Calls a message function with plain arguments of one shape; the first shape it accepts wins. */
+function render(entry: (...values: unknown[]) => unknown): string {
+	for (const arg of ["x", ["x"], 1, { x: "x" }]) {
+		try {
+			return JSON.stringify(
+				entry(...Array.from({ length: entry.length }, () => arg)),
+			);
+		} catch {
+			// Try the next shape.
+		}
+	}
+	throw new Error(`no plain arguments fit ${entry.toString().slice(0, 60)}`);
+}
+
+/** Every entry of a catalog as text: a string as it is, a function called with plain arguments. */
+function rendered(catalog: Messages): [string, string][] {
+	return Object.entries(catalog as Record<string, unknown>).map(
+		([key, entry]) => [
+			key,
+			typeof entry === "string"
+				? entry
+				: typeof entry === "function"
+					? render(entry as (...values: unknown[]) => unknown)
+					: JSON.stringify(entry),
+		],
+	);
+}
+
+const kind = (entry: unknown): string =>
+	typeof entry === "function" ? `function/${entry.length}` : typeof entry;
+
+afterEach(() => {
+	useTestLocale();
+});
+
+describe("catalogs", () => {
+	test("the English and Traditional Chinese catalogs have the same keys, and functions the same arity", () => {
+		const en = createEn(CTX) as Record<string, Entry>;
+		const zh = createZhTW(CTX) as Record<string, Entry>;
+		expect(Object.keys(zh).sort()).toEqual(Object.keys(en).sort());
+		const shapes = (catalog: Record<string, Entry>) =>
+			Object.fromEntries(
+				Object.entries(catalog).map(([key, entry]) => [key, kind(entry)]),
+			);
+		expect(shapes(zh)).toEqual(shapes(en));
+	});
+
+	test("the English catalog has no Chinese text or fullwidth punctuation", () => {
+		const offenders = rendered(createEn(CTX))
+			.filter(([, text]) => CJK.test(text))
+			.map(([key]) => key);
+		expect(offenders).toEqual([]);
+	});
+
+	test("the Traditional Chinese catalog is not the English one", () => {
+		const en = new Map(rendered(createEn(CTX)));
+		const same = rendered(createZhTW(CTX)).filter(
+			([key, text]) => en.get(key) === text,
+		);
+		// A few entries are the same in both languages, such as a bare command name.
+		expect(same.length).toBeLessThan(en.size / 5);
+	});
+});
+
+describe("setLocale", () => {
+	test("names the assistant and the root command in the text", () => {
+		setLocale("en", { assistant: "Robin", root: "robin" });
+		const text = JSON.stringify(rendered(messages()));
+		expect(text).toContain("Robin");
+		expect(text).toContain("/robin");
+		expect(text).not.toContain("Roundtable");
+	});
+
+	test("shows English by default-style settings and Chinese for zh-TW", () => {
+		setLocale("en", CTX);
+		expect(messages().stopLabel).toBe("Stop");
+		setLocale("zh-TW", CTX);
+		expect(messages().stopLabel).toBe("停止");
+	});
+
+	test("an override replaces one message and leaves the others", () => {
+		setLocale("en", { ...CTX, overrides: { stopLabel: "Halt" } });
+		expect(messages().stopLabel).toBe("Halt");
+		expect(messages().ownerFailedTitle).toBe("Could not complete");
+	});
+
+	test("an unknown locale is refused", () => {
+		expect(() => setLocale("fr" as never, CTX)).toThrow("Unknown locale: fr");
+		expect(LOCALES).toEqual(["en", "zh-TW"]);
+	});
+});
+
+describe("what the core shows", () => {
+	const files = (root: string, pattern: string) =>
+		[...new Glob(pattern).scanSync({ cwd: root })].map((f) => join(root, f));
+
+	test("no Chinese text outside the catalogs and the tests", () => {
+		const offenders = files("src/core", "**/*.ts")
+			.filter((f) => !f.includes("/i18n/") && !/\.test\.ts$/.test(f))
+			.flatMap((f) =>
+				readFileSync(f, "utf8")
+					.split("\n")
+					.map((line, index) => ({ f, line, index }))
+					// Regexes may match fullwidth punctuation; only ideographs are text.
+					.filter(({ line }) => /[\u3400-\u9fff]/.test(line))
+					.map(({ f: file, index }) => `${file}:${index + 1}`),
+			);
+		expect(offenders).toEqual([]);
+	});
+
+	test("no source in the core names its first consumer", () => {
+		// Spelled in pieces so this test does not itself name the consumer.
+		const consumer = new RegExp(["mer", "lin"].join(""), "i");
+		const offenders = files("src/core", "**/*.ts")
+			.filter((f) => !/\.test\.ts$/.test(f) && !f.includes("/testing/"))
+			.flatMap((f) =>
+				readFileSync(f, "utf8")
+					.split("\n")
+					.map((line, index) => ({ f, line, index }))
+					.filter(({ line }) => consumer.test(line))
+					.map(({ f: file, index }) => `${file}:${index + 1}`),
+			);
+		expect(offenders).toEqual([]);
+	});
+});

package/src/core/i18n/index.ts

@@ -0,0 +1,58 @@
+import { createEn, type Messages } from "./en.ts";
+import type { CatalogContext } from "./types.ts";
+import { createZhTW } from "./zh-tw.ts";
+
+export type { CatalogContext } from "./types.ts";
+
+export type { Messages };
+
+export type Locale = "en" | "zh-TW";
+
+export const LOCALES: readonly Locale[] = ["en", "zh-TW"];
+
+export function isLocale(value: unknown): value is Locale {
+	return LOCALES.some((locale) => locale === value);
+}
+
+export interface LocaleSettings extends CatalogContext {
+	/** Entries that replace the locale's own, such as one operator's wording of a card. */
+	overrides?: Partial<Messages>;
+}
+
+const DEFAULTS: CatalogContext = {
+	assistant: "Roundtable",
+	root: "roundtable",
+};
+
+function build(locale: Locale, settings: LocaleSettings): Messages {
+	const ctx: CatalogContext = {
+		assistant: settings.assistant,
+		root: settings.root,
+	};
+	const catalog = locale === "zh-TW" ? createZhTW(ctx) : createEn(ctx);
+	return { ...catalog, ...settings.overrides };
+}
+
+let active: Messages = build("en", DEFAULTS);
+let names: CatalogContext = DEFAULTS;
+
+/**
+ * Chooses the catalog of Discord text for the whole process; the host calls it once at startup,
+ * before anything shows text. `assistant` is the assistant's display name and `root` the name of
+ * its root slash command, without the slash.
+ */
+export function setLocale(locale: Locale, settings: LocaleSettings): void {
+	if (!isLocale(locale)) throw new Error(`Unknown locale: ${String(locale)}`);
+	active = build(locale, settings);
+	names = { assistant: settings.assistant, root: settings.root };
+}
+
+/** The active catalog. Read it when the text is shown, never at import time. */
+export function messages(): Messages {
+	return active;
+}
+
+/** The assistant's display name, for text that is not part of a catalog, such as a tool description. */
+export function assistantName(): string {
+	return names.assistant;
+}

package/src/core/i18n/owner.ts

@@ -0,0 +1,35 @@
+import type { CatalogContext } from "./types.ts";
+
+/** The owner's root command, the stop button, and the failure line of an interaction. */
+export function ownerEn(ctx: CatalogContext) {
+	return {
+		ownerRootDescription: `${ctx.assistant} control panel (owner only)`,
+		ownerFailedTitle: "Could not complete",
+		ownerErrorTitle: "Something went wrong",
+		ownerErrorBody:
+			"That did not finish; try again later. The details are in the log.",
+		ownerRefusalTitle: "Owner only",
+		ownerRefusalBody: `\`/${ctx.root}\` is the control panel of ${ctx.assistant}'s owner.`,
+		surfaceActionFailed: "Sorry, that action did not work.",
+		stopNote: "-# Working; press Stop to interrupt.",
+		stopLabel: "Stop",
+		panelPage: (title: string, page: number, pages: number) =>
+			`${title} (${page}/${pages})`,
+	};
+}
+
+export function ownerZhTW(ctx: CatalogContext): ReturnType<typeof ownerEn> {
+	return {
+		ownerRootDescription: `${ctx.assistant} 控制台（只有擁有者能用）`,
+		ownerFailedTitle: "無法完成",
+		ownerErrorTitle: "出了點問題",
+		ownerErrorBody: "這次沒能完成，請稍後再試；細節已經記在 log 裡。",
+		ownerRefusalTitle: "只有擁有者能用",
+		ownerRefusalBody: `\`/${ctx.root}\` 是 ${ctx.assistant} 擁有者的控制台。擲骰請用 \`/roll\` 或 \`/dice\`。`,
+		surfaceActionFailed: "抱歉，這個操作沒有成功。",
+		stopNote: "-# 工作中，想中斷就按停止。",
+		stopLabel: "停止",
+		panelPage: (title: string, page: number, pages: number) =>
+			`${title}（${page}/${pages}）`,
+	};
+}