pi-roundtable 0.23.1 → 0.24.0

package/src/core/config/config.ts

@@ -1,54 +1,36 @@
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { CATALOG, type Hex } from "../../characters/index.ts";
 import type { AgentSeed } from "../agents/agent-rules.ts";
 import { ConfigError } from "../domain/errors.ts";
 import type { InterimTextMode } from "../domain/interim.ts";
 import { DRAIN_LIMIT_MS } from "../drain.ts";
-import { isLocale, type Locale } from "../i18n/index.ts";
+import type { Locale } from "../i18n/index.ts";
 import type { AccessRules } from "../identity/access-policy.ts";
 import type { OwnerIdentity } from "../identity.ts";
 import {
 	type EffortPolicy,
 	type ModelRef,
 	parseModelRef,
-	THINKING_LEVELS,
 	type ThinkingLevel,
 } from "../models.ts";
 import type { PerPrincipalLimits } from "../modules/background/personal-target.ts";
 import type { RoundtablePlugin } from "../plugin.ts";
 import { PRIMARY_CHARS } from "../runtime/interim-text.ts";
 import type { Tier, TierMembers } from "../speakers.ts";
-import { type AccessConfig, accessOf, accessShape } from "./access.ts";
+import { type AccessConfig, accessOf } from "./access.ts";
 import {
 	type DiscordConfig,
-	discordShape,
 	liftAdapters,
 	type ResolvedDiscord,
 	resolvedDiscord,
 } from "./adapters.ts";
-import { checkAgentTeamKeys } from "./agent-team.ts";
-import { type AttachmentsConfig, attachmentsShape } from "./attachments.ts";
-import {
-	type LimitsConfig,
-	limitsOf,
-	limitsShape,
-	type ResolvedLimits,
-} from "./limits.ts";
+import { checkAgentServerOff, checkAgentTeamKeys } from "./agent-team.ts";
+import type { AttachmentsConfig } from "./attachments.ts";
+import { configSchema } from "./config-schema.ts";
+import { type LimitsConfig, limitsOf, type ResolvedLimits } from "./limits.ts";
 import { opsOf, type ResolvedOps } from "./ops.ts";
-import {
-	bool,
-	characterInput,
-	guarded,
-	integer,
-	list,
-	number,
-	oneOf,
-	optional,
-	record,
-	shape,
-	text,
-} from "./schema.ts";
-import { type SkillsConfig, skillsField } from "./skills-config.ts";
+import type { SkillsConfig } from "./skills-config.ts";
 
 export type { DiscordConfig };
 
@@ -100,6 +82,17 @@ export interface RoundtableConfig extends LimitsConfig {
 	 * instead, never both.
 	 */
 	discord?: DiscordConfig;
+	/**
+	 * `false` leaves the agent server out of a host that has `discord`: no agent team, no
+	 * `#dashboard` channel or pinned message, no agent channels or routes, no coordinator, and no
+	 * skills addon. Discord, access, memory, commands and the plugins' claims work as before;
+	 * `discord.entryChannel` is optional and `http.publicUrl` is no longer required (it serves only
+	 * the agents' avatars). Refused together with anything only agents use: `agents`, `skills`,
+	 * `ops.agent`, `discord.agentMemory`, `discord.agentSpeakers`, `discord.attachmentDownload`.
+	 * Plugins that need the agent server (pi-roundtable-web, remote-mcp's default conversation)
+	 * stop startup. Left out, the agent server runs; there is no `true`.
+	 */
+	agentServer?: false;
 	/**
 	 * The chat networks the host talks through, each made by its adapter's factory, such as
 	 * `discord()` from `pi-roundtable/discord`. A Discord adapter is the same as the top-level
@@ -154,6 +147,20 @@ export interface RoundtableConfig extends LimitsConfig {
 	 * first. With `discord` the agent in `discord.entryChannel` is the coordinator, and this key is refused.
 	 */
 	coordinator?: string;
+	/**
+	 * How the agents' characters are drawn, everywhere the host draws them: the web console, its
+	 * round table and the agents' pictures on Discord. `skins` is exactly six `#rrggbb` skin tones
+	 * that a look's `skin` index (0 to 5) picks from, such as `EAST_ASIAN_SKINS` from
+	 * `pi-roundtable/characters`; default the six the package ships. Stored looks keep their index,
+	 * so they take the new tones with no migration. A bad list stops the start.
+	 *
+	 * `refreshAvatars` (default false) renders every agent's Discord picture again each time the
+	 * agent server starts, with the host's skins, and sets it where it differs from the stored one,
+	 * so an agent that was not saved since a redraw or a `skins` change catches up. It overwrites
+	 * an agent that still wears an old hand-drawn (deprecated) picture. It runs after the start
+	 * without holding it back; a restart with nothing changed sets nothing.
+	 */
+	characters?: { skins?: readonly string[]; refreshAvatars?: boolean };
 	/**
 	 * The `public` listener: the public address that reaches it, and the TCP port (default 3000) or
 	 * unix socket the process listens on. `socketMode` is the socket file's permission bits
@@ -212,109 +219,6 @@ export interface RoundtableConfig extends LimitsConfig {
 	plugins?: RoundtablePlugin[];
 }
 
-const tierMembers = shape({
-	users: optional(list(text)),
-	roles: optional(list(text)),
-	everyone: optional(bool),
-});
-
-const isPolicy = (value: unknown): value is EffortPolicy =>
-	typeof value === "function";
-const isPlugin = (value: unknown): value is RoundtablePlugin =>
-	typeof value === "object" &&
-	value !== null &&
-	typeof (value as { name?: unknown }).name === "string" &&
-	typeof (value as { setup?: unknown }).setup === "function";
-
-const schema = shape({
-	name: optional(text),
-	owner: optional(
-		shape({
-			id: text,
-			name: text,
-			pronouns: optional(oneOf<Pronouns>("he", "she", "they")),
-		}),
-	),
-	discord: optional(discordShape),
-	database: shape({ url: text }),
-	dataDir: text,
-	attachments: attachmentsShape,
-	agentDir: optional(text),
-	model: text,
-	thinking: optional(oneOf(...THINKING_LEVELS)),
-	judge: optional(
-		shape({ model: optional(text), threshold: optional(number(0, 1)) }),
-	),
-	effortPolicy: optional(
-		guarded("a function from a turn to its effort rule", isPolicy),
-	),
-	delegation: optional(
-		shape({
-			model: optional(text),
-			thinking: optional(oneOf(...THINKING_LEVELS)),
-		}),
-	),
-	locale: optional(
-		guarded("a locale, en or zh-TW", (value): value is Locale =>
-			isLocale(value),
-		),
-	),
-	timeZone: optional(text),
-	speakers: optional(
-		shape({ admins: optional(tierMembers), members: optional(tierMembers) }),
-	),
-	access: optional(accessShape),
-	background: optional(
-		shape({
-			perPrincipal: optional(
-				shape({
-					schedules: optional(integer(1, 10_000)),
-					delegations: optional(integer(1, 1_000)),
-				}),
-			),
-		}),
-	),
-	toolTiers: optional(record(oneOf<Tier>("owner", "admin", "member"))),
-	prompts: optional(shape({ shared: text, guest: optional(text) })),
-	agents: optional(
-		list(
-			shape({
-				name: text,
-				displayName: text,
-				prompt: text,
-				character: optional(characterInput),
-				avatarPrompt: optional(text),
-				channelId: optional(text),
-			}),
-		),
-	),
-	coordinator: optional(text),
-	http: optional(
-		shape({
-			publicUrl: optional(text),
-			port: optional(integer(1, 65535)),
-			hostname: optional(text),
-			socketPath: optional(text),
-			socketMode: optional(integer(0, 0o777)),
-		}),
-	),
-	avatar: optional(text),
-	workDir: optional(text),
-	scratchDir: optional(text),
-	skills: optional(skillsField),
-	memory: optional(bool),
-	ops: optional(shape({ agent: optional(text), conversation: optional(text) })),
-	drainSeconds: optional(integer(1, 3_600)),
-	...limitsShape,
-	interimText: optional(oneOf<InterimTextMode>("on", "off")),
-	interimPrimaryChars: optional(integer(1, 100_000)),
-	plugins: optional(
-		list(
-			guarded("a plugin, an object with a name and a setup function", isPlugin),
-		),
-	),
-});
-
 /** Logged once when `avatar` is set: agents are composed characters and no picture is drawn from it. */
 export const AVATAR_DEPRECATION =
 	"agents are composed characters since 0.23; `avatar` is ignored";
@@ -340,6 +244,8 @@ export interface ResolvedConfig extends ResolvedLimits {
 	deprecations: string[];
 	/** Undefined on a host without Discord. */
 	discord?: ResolvedDiscord;
+	/** Whether the agent server runs: false when `agentServer: false`, and otherwise on a host with `discord` or `agents`. */
+	agentServer: boolean;
 	databaseUrl: string;
 	dataDir: string;
 	/** Absent `retention`: used files live as long as their conversation. */
@@ -361,9 +267,11 @@ export interface ResolvedConfig extends ResolvedLimits {
 	agents: AgentSeed[];
 	/** The coordinator's name; set only without `discord` and with `agents`: the configured one, else the first seed. */
 	coordinator?: string;
+	/** How the agents' characters are drawn: the six skin tones, the package's own unless `characters.skins` is set. */
+	characters: { skins: readonly Hex[]; refreshAvatars: boolean };
 	/** Undefined when no `http` is configured, and the host opens no `public` listener. */
 	http?: {
-		/** Always set with Discord. */
+		/** Always set with Discord, unless `agentServer` is false. */
 		publicUrl?: string;
 		port: number;
 		hostname?: string;
@@ -392,14 +300,28 @@ function modelOf(value: string, path: string): ModelRef {
 	return parsed;
 }
 
+/** The skin tones the configuration chose, or the package's own. */
+function skinsOf(skins: readonly string[] | undefined): readonly Hex[] {
+	return (skins as readonly Hex[] | undefined) ?? CATALOG.skins;
+}
+
 /** The configuration checked against its schema, defaults filled; throws a ConfigError naming the key and the fix. */
 export function resolveConfig(input: unknown): ResolvedConfig {
-	const config = schema.check(liftAdapters(input), "") as RoundtableConfig;
+	const config = configSchema.check(
+		liftAdapters(input),
+		"",
+	) as RoundtableConfig;
 	const name = config.name ?? "Roundtable";
 	const model = modelOf(config.model, "model");
 	const thinking = config.thinking ?? "medium";
 	const { discord, http } = config;
-	if (discord && !http?.publicUrl)
+	const agentServer = config.agentServer !== false;
+	if (!agentServer) checkAgentServerOff(config);
+	if (discord && agentServer && !discord.entryChannel)
+		throw new ConfigError(
+			"config discord.entryChannel: required, expected the id of the channel the coordinator lives in. Add it to roundtable.config.ts, or set agentServer: false for a host without agents.",
+		);
+	if (discord && agentServer && !http?.publicUrl)
 		throw new ConfigError(
 			"config http.publicUrl: required with discord, expected the public address that reaches the bot; Discord fetches the agents' avatars from it. Add it to roundtable.config.ts.",
 		);
@@ -454,9 +376,16 @@ export function resolveConfig(input: unknown): ResolvedConfig {
 		toolTiers: config.toolTiers ?? {},
 		prompts: config.prompts ?? {},
 		agents: config.agents ?? [],
+		agentServer:
+			agentServer &&
+			(discord !== undefined || (config.agents?.length ?? 0) > 0),
 		...(!discord && config.agents?.[0]
 			? { coordinator: config.coordinator ?? config.agents[0].name }
 			: {}),
+		characters: {
+			skins: skinsOf(config.characters?.skins),
+			refreshAvatars: config.characters?.refreshAvatars ?? false,
+		},
 		...(http
 			? {
 					http: {
@@ -474,7 +403,9 @@ export function resolveConfig(input: unknown): ResolvedConfig {
 		workDir: config.workDir ?? `${config.dataDir}/work`,
 		scratchDir: config.scratchDir ?? join(tmpdir(), `${slug}-scratch`),
 		// Without Discord and without agents there is no one to carry skills, so the addon is off.
-		skills: config.skills ?? (discord || config.agents?.length ? {} : false),
+		skills: agentServer
+			? (config.skills ?? (discord || config.agents?.length ? {} : false))
+			: false,
 		memory: config.memory ?? true,
 		...(ops ? { ops } : {}),
 		drainMs: (config.drainSeconds ?? DRAIN_LIMIT_MS / 1_000) * 1_000,

package/src/core/config/schema.ts

@@ -1,6 +1,8 @@
 import {
 	CharacterError,
 	type CharacterInput,
+	checkSkins,
+	type Hex,
 	resolveCharacter,
 } from "../../characters/index.ts";
 import { ConfigError } from "../domain/errors.ts";
@@ -155,6 +157,22 @@ export const characterInput: Field<CharacterInput> = {
 	},
 };
 
+/** The six skin tones of a host's agents, exactly six `#rrggbb` colors; a bad one is named by its place in the list. */
+export const skinTones: Field<readonly Hex[]> = {
+	describe: "a list of exactly 6 #rrggbb colors, such as EAST_ASIAN_SKINS",
+	check: (value, path) => {
+		try {
+			return checkSkins(value, path);
+		} catch (error) {
+			if (error instanceof CharacterError)
+				throw new ConfigError(
+					`config ${error.message}. Fix the skins in roundtable.config.ts.`,
+				);
+			throw error;
+		}
+	},
+};
+
 /** `false`, or whatever `item` accepts: a feature that is switched off, or configured. */
 export const orOff = <T>(item: Field<T>): Field<T | false> => ({
 	describe: `false, or ${item.describe}`,

package/src/core/define-roundtable.ts

@@ -212,7 +212,12 @@ function agentAssembly(
 			: [],
 		agentServer: agentServerPlugin({
 			...(discord
-				? { guildId: discord.guild, entryChannelId: discord.entryChannel }
+				? {
+						guildId: discord.guild,
+						...(discord.entryChannel
+							? { entryChannelId: discord.entryChannel }
+							: {}),
+					}
 				: config.coordinator
 					? { coordinator: config.coordinator }
 					: {}),
@@ -235,6 +240,7 @@ function agentAssembly(
 			// The pictures are public on the listener only where a public address reaches it.
 			...(config.http ? { avatarListener: "public" } : {}),
 			...(config.http?.publicUrl ? { avatarUrl: config.http.publicUrl } : {}),
+			...(config.characters.refreshAvatars ? { refreshAvatars: true } : {}),
 			avatarReference: join(ASSETS, "neutral.png"),
 			avatarNeutral: join(ASSETS, "neutral.png"),
 			// An ops agent's reports are the agent server's to deliver.
@@ -250,7 +256,8 @@ function agentAssembly(
  * The host's options and the plugin list of a configured bot: the built-in plugins in their
  * fixed order (each service one provides is read by the ones after it), then the operator's, then the scheduler, so a due schedule fires only once
  * everything it reaches runs. The memory, Discord administration, and skills addons are left out
- * when the configuration switches them off. Without `discord` the Discord plugins are left out,
+ * when the configuration switches them off. With `agentServer: false` the agent server, its
+ * seeds and the skills addon are left out of a Discord host. Without `discord` the Discord plugins are left out,
  * and the skills, the agent server and its seeds stay only when `agents` are configured: their
  * team then lives in the rooms of the surfaces that host them, and the runtime still runs every
  * turn of `context.turns`. Configuration mistakes stop here, naming the key and the fix.
@@ -294,11 +301,11 @@ export async function defineRoundtable(
 	// The agent server hands the runtime its per-agent settings once it sets up.
 	const agentSessions = agentSessionsSlot();
 	const assembly = discord ? discordAssembly(config, discord) : undefined;
-	// The agent server runs with Discord, and without it whenever agents are configured.
-	const agentTeam =
-		discord || config.agents.length > 0
-			? agentAssembly(config, { modelRuntime, agentSessions, errorReporter })
-			: undefined;
+	// The agent server runs with Discord, and without it whenever agents are configured;
+	// `agentServer: false` leaves it out, with the skills addon and the seeds.
+	const agentTeam = config.agentServer
+		? agentAssembly(config, { modelRuntime, agentSessions, errorReporter })
+		: undefined;
 	return {
 		options: {
 			logger,
@@ -309,6 +316,7 @@ export async function defineRoundtable(
 				rootCommand: config.slug,
 				agentDir: config.agentDir,
 				scratchDir: config.scratchDir,
+				characterSkins: config.characters.skins,
 			},
 			database: { url: config.databaseUrl },
 			dataDir: config.dataDir,

package/src/core/host-registration.ts

@@ -1,10 +1,17 @@
 import type { SQL } from "bun";
+import {
+	CATALOG,
+	CharacterError,
+	checkSkins,
+	type Hex,
+} from "../characters/index.ts";
 import { attachmentPort } from "./attachments/attachment-port.ts";
 import { retentionServices } from "./attachments/attachment-retention.ts";
 import type { AttachmentPort } from "./contract/attachments.ts";
 import type { ConversationPort } from "./contract/channels.ts";
 import type { ResolvedProviders } from "./contract/providers.ts";
 import type { SurfacePort } from "./contract/surface.ts";
+import { ConfigError } from "./domain/errors.ts";
 import { NotLinkedError } from "./errors.ts";
 import { EventBus } from "./events.ts";
 import type { RoundtableOptions } from "./host.ts";
@@ -37,6 +44,20 @@ import { CONVERSATIONS, IDENTITY, RUNTIME } from "./services.ts";
 import { setTimeZone } from "./time.ts";
 import { type ToolTierTable, toolTiers } from "./tool-tiers.ts";
 
+/** The skin tones the host's environment names, checked, or the package's own; a bad set refuses the start. */
+function characterSkinsOf(skins: readonly Hex[] | undefined): readonly Hex[] {
+	if (skins === undefined) return CATALOG.skins;
+	try {
+		return checkSkins(skins, "environment.characterSkins");
+	} catch (error) {
+		if (error instanceof CharacterError)
+			throw new ConfigError(
+				`${error.message}. Pass exactly six #rrggbb colors, such as EAST_ASIAN_SKINS from pi-roundtable/characters.`,
+			);
+		throw error;
+	}
+}
+
 /**
  * What `Roundtable.check()` found: the plugins that would run, the services and HTTP routes they
  * add, as the host would start them.
@@ -102,7 +123,10 @@ export class Linkage {
 			rootCommand = "roundtable",
 			agentDir,
 			scratchDir,
+			characterSkins,
 		} = this.#options.environment ?? {};
+		// Checked before anything is applied, so a bad set stops the start with the process untouched.
+		const skins = characterSkinsOf(characterSkins);
 		setLocale(locale, { assistant, root: rootCommand });
 		setTimeZone(timeZone);
 		// Pi packages such as pi-web-access read their config from the Pi agent directory.
@@ -112,6 +136,7 @@ export class Linkage {
 			timeZone,
 			now: () => new Date(),
 			...(scratchDir !== undefined ? { scratchDir } : {}),
+			characterSkins: skins,
 		};
 	}
 

package/src/core/host.ts

@@ -1,4 +1,5 @@
 import type { SQL } from "bun";
+import type { Hex } from "../characters/index.ts";
 import type { AttachmentRetention } from "./attachments/attachment-retention.ts";
 import { checkDatabase } from "./db/check-database.ts";
 import { openPool, runMigrations } from "./db/migrations.ts";
@@ -33,6 +34,8 @@ export interface HostEnvironment {
 	agentDir?: string;
 	/** The host's scratch dir, which plugins read as `env.scratchDir`; unset gives them none. */
 	scratchDir?: string;
+	/** Six `#rrggbb` skin tones for the agents' characters, which plugins read as `env.characterSkins`; default the package's own. Anything but six valid colors stops the start. */
+	characterSkins?: readonly Hex[];
 }
 
 export interface RoundtableOptions {

package/src/core/plugin-removed.ts

@@ -0,0 +1,85 @@
+import type { ChatSurface } from "./contract/surface.ts";
+import { PluginError } from "./errors.ts";
+import type {
+	Contribution,
+	EventHandlers,
+	RoundtablePlugin,
+} from "./plugin.ts";
+
+/**
+ * The plugin fields of 0.1.0 that are gone, each with what replaces it. The host refuses a
+ * plugin that still has one, so a plugin written for 0.1.0 fails at once instead of being ignored.
+ */
+const REMOVED_PLUGIN_FIELDS = {
+	useCommands:
+		"the composed slash commands go to the Discord plugin's surface, not to a plugin; add the commands from setup with context.services.get(DISCORD).commands.add(...), with DISCORD from pi-roundtable/discord",
+	agentServer:
+		"give the plugin a service with startInBackground, and hear how it ended in a serviceStarted event handler",
+	stopTurn:
+		"put stop(channel) on the channel claim that owns the channel; the router asks only the owning claim",
+} as const;
+
+/** The contribution parts of 0.1.0 that are gone, each with what replaces it. */
+const REMOVED_PARTS = {
+	interactions:
+		"slash commands belong to the Discord plugin now; add them from setup with context.services.get(DISCORD).commands.add({ module, rootOptions }), with DISCORD from pi-roundtable/discord",
+} as const;
+
+/** The chat surface methods of 0.1.0 that are gone, each with what replaces it. */
+const REMOVED_SURFACE_METHODS = {
+	useCommands:
+		"the host no longer composes slash commands or hands them to a surface; the Discord plugin composes them, and a plugin adds its own with context.services.get(DISCORD).commands.add(...) from pi-roundtable/discord",
+} as const;
+
+const REMOVED_EVENT = {
+	agentServer:
+		"hear serviceStarted instead, which names the plugin and service whose background start ended",
+} as const;
+
+/**
+ * Refuses a plugin that still has a field of 0.1.0 that is gone, naming what replaces it, so it
+ * fails where it is written or when the host links it instead of being ignored.
+ */
+export function refuseRemovedFields(plugin: RoundtablePlugin): void {
+	for (const [field, replacement] of Object.entries(REMOVED_PLUGIN_FIELDS))
+		if (field in plugin)
+			throw new PluginError(
+				`plugin ${plugin.name}: "${field}" was removed in 0.2.0; ${replacement}.`,
+			);
+}
+
+/** Refuses a contribution part of 0.1.0 that is gone, naming what replaces it. */
+export function refuseRemovedParts(
+	plugin: string,
+	contribution: Contribution,
+): void {
+	for (const [part, replacement] of Object.entries(REMOVED_PARTS))
+		if (part in contribution)
+			throw new PluginError(
+				`plugin ${plugin}: the "${part}" part was removed in 0.2.0; ${replacement}.`,
+			);
+}
+
+/** Refuses a chat surface that still has a method of 0.1.0 that is gone, naming what replaces it. */
+export function refuseRemovedSurfaceMethods(
+	plugin: string,
+	surface: ChatSurface,
+): void {
+	for (const [method, replacement] of Object.entries(REMOVED_SURFACE_METHODS))
+		if (method in surface)
+			throw new PluginError(
+				`plugin ${plugin}: surface ${surface.surface} has ${method}, which was removed in 0.2.0; ${replacement}.`,
+			);
+}
+
+/** Refuses an event handler of 0.1.0 that is gone, naming what replaces it. */
+export function refuseRemovedEvents(
+	plugin: string,
+	events: EventHandlers,
+): void {
+	for (const [event, replacement] of Object.entries(REMOVED_EVENT))
+		if (event in events)
+			throw new PluginError(
+				`plugin ${plugin}: the "${event}" event was removed in 0.2.0; ${replacement}.`,
+			);
+}

package/src/core/plugin.ts

@@ -1,4 +1,5 @@
 import type { SQL } from "bun";
+import type { Hex } from "../characters/index.ts";
 import type { AgentSeed } from "./agents/agent-store.ts";
 import type { AttachmentPort } from "./contract/attachments.ts";
 import type {
@@ -276,6 +277,13 @@ export interface HostEnv {
 	 * without a hold. Plugins that run shells of their own (coding workers) give it to them too.
 	 */
 	readonly scratchDir?: string;
+	/**
+	 * The six skin tones the host draws its agents' characters with, which `CharacterSpec.skin`
+	 * indexes: the package's own unless the host configured `characters.skins`. A plugin that
+	 * draws a character passes them as `composeSvg`'s `skins` option, so every picture of an
+	 * agent wears the same ones.
+	 */
+	readonly characterSkins: readonly Hex[];
 }
 
 /** What the host gives every plugin. */
@@ -392,36 +400,6 @@ export interface RoundtablePlugin {
 	preflight?(): Promise<void> | void;
 }
 
-/**
- * The plugin fields of 0.1.0 that are gone, each with what replaces it. The host refuses a
- * plugin that still has one, so a plugin written for 0.1.0 fails at once instead of being ignored.
- */
-const REMOVED_PLUGIN_FIELDS = {
-	useCommands:
-		"the composed slash commands go to the Discord plugin's surface, not to a plugin; add the commands from setup with context.services.get(DISCORD).commands.add(...), with DISCORD from pi-roundtable/discord",
-	agentServer:
-		"give the plugin a service with startInBackground, and hear how it ended in a serviceStarted event handler",
-	stopTurn:
-		"put stop(channel) on the channel claim that owns the channel; the router asks only the owning claim",
-} as const;
-
-/** The contribution parts of 0.1.0 that are gone, each with what replaces it. */
-const REMOVED_PARTS = {
-	interactions:
-		"slash commands belong to the Discord plugin now; add them from setup with context.services.get(DISCORD).commands.add({ module, rootOptions }), with DISCORD from pi-roundtable/discord",
-} as const;
-
-/** The chat surface methods of 0.1.0 that are gone, each with what replaces it. */
-const REMOVED_SURFACE_METHODS = {
-	useCommands:
-		"the host no longer composes slash commands or hands them to a surface; the Discord plugin composes them, and a plugin adds its own with context.services.get(DISCORD).commands.add(...) from pi-roundtable/discord",
-} as const;
-
-const REMOVED_EVENT = {
-	agentServer:
-		"hear serviceStarted instead, which names the plugin and service whose background start ended",
-} as const;
-
 /**
  * The context one plugin's setup gets: the host's parts and that plugin's view of the services.
  * `context.core` of 0.1.0 is gone; reading it throws a PluginError naming `context.services`, where
@@ -449,50 +427,9 @@ export function pluginContext(
 	return context;
 }
 
-/**
- * Refuses a plugin that still has a field of 0.1.0 that is gone, naming what replaces it, so it
- * fails where it is written or when the host links it instead of being ignored.
- */
-export function refuseRemovedFields(plugin: RoundtablePlugin): void {
-	for (const [field, replacement] of Object.entries(REMOVED_PLUGIN_FIELDS))
-		if (field in plugin)
-			throw new PluginError(
-				`plugin ${plugin.name}: "${field}" was removed in 0.2.0; ${replacement}.`,
-			);
-}
-
-/** Refuses a contribution part of 0.1.0 that is gone, naming what replaces it. */
-export function refuseRemovedParts(
-	plugin: string,
-	contribution: Contribution,
-): void {
-	for (const [part, replacement] of Object.entries(REMOVED_PARTS))
-		if (part in contribution)
-			throw new PluginError(
-				`plugin ${plugin}: the "${part}" part was removed in 0.2.0; ${replacement}.`,
-			);
-}
-
-/** Refuses a chat surface that still has a method of 0.1.0 that is gone, naming what replaces it. */
-export function refuseRemovedSurfaceMethods(
-	plugin: string,
-	surface: ChatSurface,
-): void {
-	for (const [method, replacement] of Object.entries(REMOVED_SURFACE_METHODS))
-		if (method in surface)
-			throw new PluginError(
-				`plugin ${plugin}: surface ${surface.surface} has ${method}, which was removed in 0.2.0; ${replacement}.`,
-			);
-}
-
-/** Refuses an event handler of 0.1.0 that is gone, naming what replaces it. */
-export function refuseRemovedEvents(
-	plugin: string,
-	events: EventHandlers,
-): void {
-	for (const [event, replacement] of Object.entries(REMOVED_EVENT))
-		if (event in events)
-			throw new PluginError(
-				`plugin ${plugin}: the "${event}" event was removed in 0.2.0; ${replacement}.`,
-			);
-}
+export {
+	refuseRemovedEvents,
+	refuseRemovedFields,
+	refuseRemovedParts,
+	refuseRemovedSurfaceMethods,
+} from "./plugin-removed.ts";