pi-roundtable 0.34.0 → 0.35.0

package/src/core/modules/skills/skill-tools.ts

@@ -1,13 +1,13 @@
 import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { AgentError } from "../../domain/errors.ts";
+import type { SkillRegistry } from "../../plugin-api/services.ts";
 import {
 	optionalString,
 	requiredString,
 	stringList,
 	textToolsExtension,
 } from "../../runtime/text-tools.ts";
-import type { SkillRegistry } from "../../services.ts";
 import {
 	MAX_SKILL_BODY_CHARS,
 	type StoredSkillRegistry,

package/src/core/ops/error-reporter.ts

@@ -1,7 +1,7 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import type { ScheduledOutcome } from "../contract/channels.ts";
-import type { LogEntry, Logger } from "../log.ts";
-import type { ChannelKey } from "../sessions.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
+import type { LogEntry, Logger } from "../kernel/log.ts";
 import { AlertThrottle } from "./alert-throttle.ts";
 
 /** Errors that are expected and never reported, matched against the message and the error's. */

package/src/core/ops/ops-alerts.ts

@@ -1,4 +1,4 @@
-import type { Logger } from "../log.ts";
+import type { Logger } from "../kernel/log.ts";
 import { AlertThrottle } from "./alert-throttle.ts";
 
 const DEFAULT_WINDOW_MS = 60 * 60_000;

package/src/core/{define.ts → plugin-api/define.ts}

@@ -2,22 +2,28 @@ import type { Static, TObject } from "typebox";
 import type {
 	ToolAttachment,
 	ToolAttachmentInfo,
-} from "./attachments/tool-attachment.ts";
-import type { ClientPort } from "./domain/client.ts";
-import type { ReplyFile } from "./domain/conversation.ts";
-import { PluginError } from "./errors.ts";
-import { type HoldDescription, type HoldRule, isPromise } from "./holds.ts";
-import { messages } from "./i18n/index.ts";
-import type { ApprovedBy } from "./interactions/prompts.ts";
-import { type RoundtablePlugin, refuseRemovedFields } from "./plugin.ts";
-import type { AgentTurnScope, ChannelKey, SessionTool } from "./sessions.ts";
+} from "../attachments/tool-attachment.ts";
+import type { ClientPort } from "../domain/client.ts";
+import type { ReplyFile } from "../domain/conversation.ts";
+import type {
+	AgentTurnScope,
+	ChannelKey,
+	SessionTool,
+} from "../domain/sessions.ts";
+import { messages } from "../i18n/index.ts";
+import { type Speaker, TIERS, type Tier } from "../identity/speakers.ts";
+import type { ApprovedBy } from "../interactions/prompts.ts";
+import { PluginError } from "../kernel/errors.ts";
 import {
 	type ToolOutput,
 	toolError,
 	toolOutput,
-} from "./shared/tool-result.ts";
-import { type Speaker, TIERS, type Tier } from "./speakers.ts";
-import { toolTurn } from "./tool-turn.ts";
+} from "../shared/tool-result.ts";
+import { type HoldDescription, type HoldRule, isPromise } from "./holds.ts";
+import { type RoundtablePlugin, refuseRemovedFields } from "./plugin.ts";
+import { ToolRefusal, toolTurn } from "./tool-turn.ts";
+
+export { ToolRefusal };
 
 /** Tool names are lowercase words joined by underscores, like every tool the core ships. */
 const TOOL_NAME = /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/;
@@ -91,14 +97,6 @@ export interface ToolTurn {
 	attachments?(): Promise<readonly ToolAttachmentInfo[]>;
 }
 
-/**
- * Thrown by a tool's `run` for a call the model should correct: the message becomes the tool's
- * error result, which the model reads. Any other error fails the call.
- */
-export class ToolRefusal extends Error {
-	override name = "ToolRefusal";
-}
-
 export interface ToolSpec<Schema extends TObject> {
 	/** Lowercase words joined by underscores; unique across every plugin. */
 	name: string;

package/src/core/{event-types.ts → plugin-api/event-types.ts}

@@ -1,4 +1,4 @@
-import type { ChannelKey } from "./sessions.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
 
 /** One thing a person did through a plugin's surface, as a handler hears of it. */
 export interface ActionEvent {

package/src/core/{holds.ts → plugin-api/holds.ts}

@@ -1,7 +1,7 @@
+import { type Tier, tierAtLeast } from "../identity/speakers.ts";
+import type { ApprovalDetails } from "../interactions/prompts.ts";
+import { PluginError } from "../kernel/errors.ts";
 import type { ToolTurn } from "./define.ts";
-import { PluginError } from "./errors.ts";
-import type { ApprovalDetails } from "./interactions/prompts.ts";
-import { type Tier, tierAtLeast } from "./speakers.ts";
 
 /**
  * How long the confirmation gate waits for a hold that looks things up before it describes the

package/src/core/{plugin-removed.ts → plugin-api/plugin-removed.ts}

@@ -1,5 +1,5 @@
-import type { ChatSurface } from "./contract/surface.ts";
-import { PluginError } from "./errors.ts";
+import type { ChatSurface } from "../contract/surface.ts";
+import { PluginError } from "../kernel/errors.ts";
 import type {
 	Contribution,
 	EventHandlers,

package/src/core/{plugin.ts → plugin-api/plugin.ts}

@@ -1,7 +1,7 @@
 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 { Hex } from "../../characters/index.ts";
+import type { AgentSeed } from "../agents/agent-store.ts";
+import type { AttachmentPort } from "../contract/attachments.ts";
 import type {
 	BackgroundTarget,
 	ChannelClaim,
@@ -9,35 +9,35 @@ import type {
 	MessageObserver,
 	ObserveFilter,
 	QueuePort,
-} from "./contract/channels.ts";
-import type { ChatCommand } from "./contract/chat-command.ts";
-import type { Providers, ResolvedProviders } from "./contract/providers.ts";
-import type { ServiceKey, Services } from "./contract/services.ts";
-import type { ChatSurface, SurfacePort } from "./contract/surface.ts";
-import type { Migration } from "./db/migrations.ts";
-import type { ToolContribution } from "./define.ts";
-import type { TurnProgress } from "./domain/progress.ts";
-import { PluginError } from "./errors.ts";
-import type { ActionEvent, MemberJoinedEvent } from "./event-types.ts";
-import type { HoldCheck, HoldRule } from "./holds.ts";
-import type { HttpRoute, ListenerAddress } from "./http/listeners.ts";
-import type { Locale } from "./i18n/index.ts";
-import type { Logger } from "./log.ts";
-import type {
-	DirectChannelProvider,
-	DirectChannels,
-} from "./presence/direct-channels.ts";
-import type { ConversationTurns } from "./routing/conversation-turns.ts";
+} from "../contract/channels.ts";
+import type { ChatCommand } from "../contract/chat-command.ts";
+import type { Providers, ResolvedProviders } from "../contract/providers.ts";
+import type { ServiceKey, Services } from "../contract/services.ts";
+import type { ChatSurface, SurfacePort } from "../contract/surface.ts";
+import type { Migration } from "../db/migrations.ts";
+import type { TurnProgress } from "../domain/progress.ts";
 import type {
 	AgentTurnScope,
 	ChannelKey,
 	SessionPlan,
 	SessionTool,
 	ToolSelection,
-} from "./sessions.ts";
-import type { ShellEnv } from "./shared/child-env.ts";
-import type { Speaker, Tier } from "./speakers.ts";
-import type { ToolTiers } from "./tool-tiers.ts";
+} from "../domain/sessions.ts";
+import type { HttpRoute, ListenerAddress } from "../http/listeners.ts";
+import type { Locale } from "../i18n/index.ts";
+import type { Speaker, Tier } from "../identity/speakers.ts";
+import { PluginError } from "../kernel/errors.ts";
+import type { Logger } from "../kernel/log.ts";
+import type {
+	DirectChannelProvider,
+	DirectChannels,
+} from "../presence/direct-channels.ts";
+import type { ConversationTurns } from "../routing/conversation-turns.ts";
+import type { ToolTiers } from "../runtime/tool-tiers.ts";
+import type { ShellEnv } from "../shared/child-env.ts";
+import type { ToolContribution } from "./define.ts";
+import type { ActionEvent, MemberJoinedEvent } from "./event-types.ts";
+import type { HoldCheck, HoldRule } from "./holds.ts";
 
 export type { ActionEvent, MemberJoinedEvent };
 

package/src/core/{services.ts → plugin-api/services.ts}

@@ -1,51 +1,51 @@
 import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
-import type { CharacterInput, CharacterSpec } from "../characters/index.ts";
-import type { Agent, AgentGroup } from "./agents/agent-rules.ts";
-import type { AvatarMode } from "./agents/agent-tools.ts";
-import type { HelperTeam } from "./agents/helper-ops.ts";
-import type { RoutingTable } from "./agents/routes.ts";
-import type { TeamStatus } from "./agents/team-status.ts";
-import type { ChannelContexts } from "./contract/channel-context.ts";
+import type { CharacterInput, CharacterSpec } from "../../characters/index.ts";
+import type { Agent, AgentGroup } from "../agents/agent-rules.ts";
+import type { AvatarMode } from "../agents/agent-tools.ts";
+import type { HelperTeam } from "../agents/helper-ops.ts";
+import type { RoutingTable } from "../agents/routes.ts";
+import type { TeamStatus } from "../agents/team-status.ts";
+import type { ChannelContexts } from "../contract/channel-context.ts";
 import type {
 	BackgroundRunsAs,
 	ScheduledOutcome,
-} from "./contract/channels.ts";
-import type { AgentRuntime } from "./contract/runtime.ts";
-import { type ServiceKey, serviceKey } from "./contract/services.ts";
-import type { ConversationRegistry } from "./conversations/conversation-registry.ts";
-import type { PendingConfirmation } from "./domain/conversation.ts";
-import type { HttpRoute } from "./http/listeners.ts";
-import type { IdentityLinks } from "./identity/identity-links.ts";
-import type { IdentityService } from "./identity/identity-service.ts";
-import type { PersonProfiles } from "./identity/profiles.ts";
-import type { ThinkingLevel, ThinkingSetting } from "./models.ts";
-import type { ConversationModes } from "./modes/conversation-modes.ts";
+} from "../contract/channels.ts";
+import type { AgentRuntime } from "../contract/runtime.ts";
+import { type ServiceKey, serviceKey } from "../contract/services.ts";
+import type { ConversationRegistry } from "../conversations/conversation-registry.ts";
+import type { PendingConfirmation } from "../domain/conversation.ts";
+import type { ThinkingLevel, ThinkingSetting } from "../domain/models.ts";
+import type { AgentTurnScope, ChannelKey } from "../domain/sessions.ts";
+import type { HttpRoute } from "../http/listeners.ts";
+import type { IdentityLinks } from "../identity/identity-links.ts";
+import type { IdentityService } from "../identity/identity-service.ts";
+import type { PersonProfiles } from "../identity/profiles.ts";
+import type { Speaker } from "../identity/speakers.ts";
+import type { ConversationModes } from "../modes/conversation-modes.ts";
 import type {
 	DelegationJob,
 	DelegationOutcome,
-} from "./modules/delegation/delegator.ts";
+} from "../modules/delegation/delegator.ts";
 import type {
 	Memory,
 	MemoryKind,
 	PromptMemory,
-} from "./modules/memory/owner-memory-store.ts";
+} from "../modules/memory/owner-memory-store.ts";
 import type {
 	PromptDocuments,
 	PromptVersion,
-} from "./modules/prompts/prompt-documents.ts";
+} from "../modules/prompts/prompt-documents.ts";
 import type {
 	PrecheckFinding,
 	PrecheckRegistry,
-} from "./modules/schedules/prechecks.ts";
+} from "../modules/schedules/prechecks.ts";
 import type {
 	NewSchedule,
 	Schedule,
 	ScheduleChange,
-} from "./modules/schedules/schedule-store.ts";
-import type { SkillRegistry } from "./modules/skills/skill-contract.ts";
-import type { AgentTurnScope, ChannelKey } from "./sessions.ts";
-import type { Speaker } from "./speakers.ts";
-import type { DispatchThreads } from "./threads/dispatch-threads.ts";
+} from "../modules/schedules/schedule-store.ts";
+import type { SkillRegistry } from "../modules/skills/skill-contract.ts";
+import type { DispatchThreads } from "../threads/dispatch-threads.ts";
 
 // The services the built-in plugins provide, and the ports they keep to. Each port is an
 // interface, so an object with the same methods satisfies it without being one of the built-in
@@ -497,4 +497,4 @@ export interface SpeakerMemory {
 	remove(text: string): Promise<string[]>;
 }
 
-export type { SkillRegistry } from "./modules/skills/skill-contract.ts";
+export type { SkillRegistry } from "../modules/skills/skill-contract.ts";

package/src/core/{tool-turn.ts → plugin-api/tool-turn.ts}

@@ -2,12 +2,19 @@ import {
 	AttachmentLookupError,
 	listAttachments,
 	openAttachment,
-} from "./attachments/tool-attachment.ts";
+} from "../attachments/tool-attachment.ts";
+import type { ClientPort } from "../domain/client.ts";
+import type { SessionContext } from "../domain/sessions.ts";
+import { attachReplyFile } from "../shared/reply-files.ts";
 import type { ToolTurn } from "./define.ts";
-import { ToolRefusal } from "./define.ts";
-import type { ClientPort } from "./domain/client.ts";
-import { attachReplyFile } from "./reply-files.ts";
-import type { SessionContext } from "./sessions.ts";
+
+/**
+ * Thrown by a tool's `run` for a call the model should correct: the message becomes the tool's
+ * error result, which the model reads. Any other error fails the call.
+ */
+export class ToolRefusal extends Error {
+	override name = "ToolRefusal";
+}
 
 /**
  * `port` as a tool sees it in a turn: every call carries the turn's `signal` beside the caller's,

package/src/core/presence/delivery-router.ts

@@ -1,7 +1,7 @@
 import type { SurfacePort } from "../contract/surface.ts";
 import { parseChannelKey } from "../contract/surface.ts";
 import type { ChannelKey } from "../domain/conversation.ts";
-import type { Logger } from "../log.ts";
+import type { Logger } from "../kernel/log.ts";
 import { splitReply } from "../presentation/reply-splitter.ts";
 import type {
 	DirectChannelProvider,

package/src/core/presence/direct-channels.ts

@@ -1,6 +1,6 @@
 import type { SurfacePort } from "../contract/surface.ts";
 import type { ChannelKey } from "../domain/conversation.ts";
-import type { Logger } from "../log.ts";
+import type { Logger } from "../kernel/log.ts";
 import { deliveryRouter } from "./delivery-router.ts";
 
 /**

package/src/core/registry/chat-commands.ts

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import type { ChatCommand } from "../contract/chat-command.ts";
-import { PluginError } from "../errors.ts";
+import { PluginError } from "../kernel/errors.ts";
 import { packageDir } from "../shared/package-dir.ts";
 
 const CHAT_COMMAND_NAME = /^[a-z][a-z0-9_-]*$/;

package/src/core/registry/contributions.ts

@@ -3,10 +3,16 @@ import type { AgentSeed } from "../agents/agent-store.ts";
 import type { BackgroundTarget, ChannelClaim } from "../contract/channels.ts";
 import type { ChatCommand } from "../contract/chat-command.ts";
 import type { ChatSurface } from "../contract/surface.ts";
-import type { ToolContribution } from "../define.ts";
-import { NotLinkedError, PluginError } from "../errors.ts";
-import { type HoldRule, holdChain } from "../holds.ts";
+import {
+	compileSessionPlan,
+	type SessionTool,
+	type ToolSelection,
+} from "../domain/sessions.ts";
 import type { HttpRoute } from "../http/listeners.ts";
+import { TIERS } from "../identity/speakers.ts";
+import { NotLinkedError, PluginError } from "../kernel/errors.ts";
+import type { ToolContribution } from "../plugin-api/define.ts";
+import { type HoldRule, holdChain } from "../plugin-api/holds.ts";
 import {
 	CONTRIBUTION_KEYS,
 	type Contribution,
@@ -21,19 +27,13 @@ import {
 	refuseRemovedParts,
 	refuseRemovedSurfaceMethods,
 	type Service,
-} from "../plugin.ts";
+} from "../plugin-api/plugin.ts";
 import {
 	type DirectChannelProvider,
 	directChannelsPort,
 } from "../presence/direct-channels.ts";
 import { refuseShellTools } from "../runtime/chat-only.ts";
-import {
-	compileSessionPlan,
-	type SessionTool,
-	type ToolSelection,
-} from "../sessions.ts";
-import { TIERS } from "../speakers.ts";
-import type { ToolTierTable } from "../tool-tiers.ts";
+import type { ToolTierTable } from "../runtime/tool-tiers.ts";
 import { ChatCommandSources, claimChatCommand } from "./chat-commands.ts";
 import { ServiceRegistry } from "./services.ts";
 import { surfaceService } from "./surface-service.ts";

package/src/core/registry/providers.ts

@@ -3,9 +3,9 @@ import type {
 	Providers,
 	ResolvedProviders,
 } from "../contract/providers.ts";
-import { PluginError, ProviderError } from "../errors.ts";
 import { type JudgeModel, ModelJudge } from "../judging/model-judge.ts";
-import type { RoundtablePlugin } from "../plugin.ts";
+import { PluginError, ProviderError } from "../kernel/errors.ts";
+import type { RoundtablePlugin } from "../plugin-api/plugin.ts";
 import { nearest } from "./contributions.ts";
 
 const SLOTS = [

package/src/core/registry/services.ts

@@ -1,6 +1,6 @@
 import type { ServiceKey, Services } from "../contract/services.ts";
-import { NotLinkedError, PluginError } from "../errors.ts";
-import type { RoundtablePlugin } from "../plugin.ts";
+import { NotLinkedError, PluginError } from "../kernel/errors.ts";
+import type { RoundtablePlugin } from "../plugin-api/plugin.ts";
 
 /** The host's words for reading a service no plugin declares; `testPlugin` says how to give one instead. */
 const HOST_ADVICE =

package/src/core/registry/surface-service.ts

@@ -1,5 +1,5 @@
 import type { ChatSurface } from "../contract/surface.ts";
-import type { PluginContext, Service } from "../plugin.ts";
+import type { PluginContext, Service } from "../plugin-api/plugin.ts";
 
 /**
  * The surface as a service: it starts with the router's `handle` as its delivery, which drops

package/src/core/routing/actor-of.ts

@@ -1,7 +1,7 @@
 import type { InboundMessage } from "../contract/channels.ts";
 import { parseChannelKey } from "../contract/surface.ts";
 import type { ActorFacts } from "../identity/actor-facts.ts";
-import type { Logger } from "../log.ts";
+import type { Logger } from "../kernel/log.ts";
 
 /**
  * Who wrote the message, as its surface reports them; a surface that reports no `actor` has it

package/src/core/routing/channel-queue.ts

@@ -1,5 +1,5 @@
-import { HostStoppingError } from "../errors.ts";
-import type { ChannelKey } from "../sessions.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
+import { HostStoppingError } from "../kernel/errors.ts";
 
 /** Runs tasks one at a time per channel, in arrival order; different channels run independently. */
 export class ChannelQueue {

package/src/core/routing/channel-router.ts

@@ -14,12 +14,12 @@ import {
 	STEERED_MARK,
 } from "../contract/channels.ts";
 import type { SurfacePort } from "../contract/surface.ts";
-import { HostStoppingError, PluginError } from "../errors.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
 import { messages } from "../i18n/index.ts";
 import type { Contact, ContactAssessor } from "../identity/contact.ts";
 import type { IdentityService } from "../identity/identity-service.ts";
-import type { Logger } from "../log.ts";
-import type { ChannelKey } from "../sessions.ts";
+import { HostStoppingError, PluginError } from "../kernel/errors.ts";
+import type { Logger } from "../kernel/log.ts";
 import { actorOf } from "./actor-of.ts";
 import { speakerOf } from "./background-speaker.ts";
 import type { ChannelQueue } from "./channel-queue.ts";

package/src/core/routing/claim-events.ts

@@ -1,6 +1,6 @@
 import type { ChannelClaim, InboundMessage } from "../contract/channels.ts";
-import type { Logger } from "../log.ts";
-import type { ChannelKey } from "../sessions.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
+import type { Logger } from "../kernel/log.ts";
 
 /** Tells the claim a message in its channel was deleted; a claim without the hook, or none, is skipped. Never rejects. */
 export async function tellDeleted(

package/src/core/routing/conversation-turns.ts

@@ -9,14 +9,18 @@ import type { ClientPort } from "../domain/client.ts";
 import type { TurnResult } from "../domain/conversation.ts";
 import type { TurnConversation } from "../domain/ports.ts";
 import type { TurnProgress } from "../domain/progress.ts";
-import { HostStoppingError, PluginError } from "../errors.ts";
+import type {
+	ChannelKey,
+	ToolSelection,
+	TurnSelection,
+} from "../domain/sessions.ts";
 import { SYSTEM_PRINCIPAL } from "../identity/principal-store.ts";
-import type { Logger } from "../log.ts";
-import type { EventSink } from "../plugin.ts";
+import type { Speaker } from "../identity/speakers.ts";
+import { HostStoppingError, PluginError } from "../kernel/errors.ts";
+import type { Logger } from "../kernel/log.ts";
+import type { EventSink } from "../plugin-api/plugin.ts";
 import { isQuiet, replyBody } from "../presentation/reply-body.ts";
-import { withReplyFiles } from "../reply-files.ts";
-import type { ChannelKey, ToolSelection, TurnSelection } from "../sessions.ts";
-import type { Speaker } from "../speakers.ts";
+import { withReplyFiles } from "../shared/reply-files.ts";
 import { endOf, settleTurn } from "./settle-turn.ts";
 
 /** One turn of a conversation, as a claim asks for it. */

package/src/core/routing/forward-join.ts

@@ -1,5 +1,5 @@
 import type { InboundMessage } from "../contract/channels.ts";
-import type { ChannelKey } from "../sessions.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
 
 /** Discord sends a forward's added text as a second message right after the forward. */
 export const FORWARD_JOIN_MS = 2_000;

package/src/core/routing/message-observers.ts

@@ -4,7 +4,7 @@ import type {
 	ObserveFilter,
 } from "../contract/channels.ts";
 import { parseChannelKey } from "../contract/surface.ts";
-import type { Logger } from "../log.ts";
+import type { Logger } from "../kernel/log.ts";
 
 interface Registered {
 	filter: Readonly<ObserveFilter>;

package/src/core/routing/message-text.ts

@@ -1,6 +1,6 @@
 import { parseChannelKey } from "../contract/surface.ts";
 import type { ChannelKey, InboundMessage } from "../domain/conversation.ts";
-import type { OwnerIdentity } from "../identity.ts";
+import type { OwnerIdentity } from "../identity/owner-identity.ts";
 
 /** How the model is told where a forward came from: a Discord channel as its mention, another surface's as its key. */
 function sourceLabel(source: ChannelKey): string {

package/src/core/routing/peer-bots.ts

@@ -1,80 +1,12 @@
 import {
-	bool,
-	either,
-	type Field,
-	integer,
-	list,
-	optional,
-	shape,
-	text,
-} from "../config/schema.ts";
+	DEFAULT_PEER_ROUNDS,
+	type PeerBotEntry,
+	type PeerBotsConfig,
+	peerBotsShape,
+} from "../config/peer-bots.ts";
 import type { InboundMessage } from "../contract/channels.ts";
 import { parseChannelKey } from "../contract/surface.ts";
-import { ConfigError } from "../domain/errors.ts";
-import type { ChannelKey } from "../sessions.ts";
-
-/** One peer bot the host answers, and where. */
-export interface PeerBotEntry {
-	/** The bot's user id on the surface, a Discord snowflake. */
-	id: string;
-	/** Answer it only in these servers; left out, in every server of the host. */
-	guilds?: readonly string[];
-	/** Answer it only in these channels; left out, in every channel. */
-	channels?: readonly string[];
-	/**
-	 * Leave to this bot a person's message that addresses both: when a person mentions or replies to
-	 * the host and in the same message mentions this bot or replies to it, the host starts no turn
-	 * (observers still hear the message), so only this bot answers and it can hand over by mentioning
-	 * the host. Where `guilds` and `channels` do not list the bot, the host does not yield to it.
-	 * Set it on one side only: two hosts that yield to each other both stay silent.
-	 */
-	yields?: boolean;
-}
-
-/**
- * The other bots whose messages the host answers like a guest's. Explicit ids only: there is no
- * wildcard and no "all bots", and a host that leaves this out answers no bot.
- */
-export interface PeerBotsConfig {
-	/** The peer bots, each by its user id or as an entry that limits it to servers or channels. */
-	allow: readonly (string | PeerBotEntry)[];
-	/**
-	 * The most messages from peer bots in a row, in one channel, that start a turn before the next
-	 * one is ignored; a person's message in the channel starts the count over. Default 3.
-	 */
-	maxRounds?: number;
-}
-
-/** The rounds in a row a channel answers peer bots when the host does not say. */
-export const DEFAULT_PEER_ROUNDS = 3;
-
-const SNOWFLAKE = /^[0-9]{17,20}$/;
-
-/** A Discord id: 17 to 20 digits. */
-const snowflake: Field<string> = {
-	describe: "a Discord id (17 to 20 digits)",
-	check: (value, path) => {
-		const id = text.check(value, path);
-		if (!SNOWFLAKE.test(id))
-			throw new ConfigError(
-				`config ${path}: expected a Discord id (17 to 20 digits), got ${JSON.stringify(id)}. Copy the id with Developer Mode on; a name or a wildcard is not accepted. Fix the value in roundtable.config.ts.`,
-			);
-		return id;
-	},
-};
-
-const entryShape = shape({
-	id: snowflake,
-	guilds: optional(list(snowflake)),
-	channels: optional(list(snowflake)),
-	yields: optional(bool),
-});
-
-/** `discord.peerBots`, or the `peerBots` of the host's options. */
-export const peerBotsShape = shape({
-	allow: list(either(snowflake, entryShape)),
-	maxRounds: optional(integer(1, 100)),
-});
+import type { ChannelKey } from "../domain/sessions.ts";
 
 /**
  * The peer bots a host answers, and how many of their messages in a row a channel answers.

package/src/core/routing/queued-messages.ts

@@ -7,8 +7,8 @@ import {
 	type QueuedChange,
 	type QueuedMessage,
 } from "../contract/channels.ts";
-import type { Logger } from "../log.ts";
-import type { ChannelKey } from "../sessions.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
+import type { Logger } from "../kernel/log.ts";
 
 type TurnAdmission = Extract<Admission, { kind: "turn" }>;
 

package/src/core/routing/settle-turn.ts

@@ -1,7 +1,7 @@
 import type { ScheduledOutcome } from "../contract/channels.ts";
 import type { TurnResult } from "../domain/conversation.ts";
 import { AgentRunError } from "../domain/errors.ts";
-import type { TurnEndEvent } from "../plugin.ts";
+import type { TurnEndEvent } from "../plugin-api/plugin.ts";
 
 /** Runs a turn; a thrown error becomes its failed result, labelled `<what> crashed`. */
 export async function settleTurn<R>(

package/src/core/routing/surface-port.ts

@@ -1,13 +1,13 @@
 import type { ChatSurface, SurfacePort } from "../contract/surface.ts";
 import { parseChannelKey } from "../contract/surface.ts";
-import { PluginError } from "../errors.ts";
+import type { ChannelKey } from "../domain/sessions.ts";
+import type { Speaker } from "../identity/speakers.ts";
 import {
 	isPromptScope,
 	type PromptScope,
 	promptScope,
 } from "../interactions/prompts.ts";
-import type { ChannelKey } from "../sessions.ts";
-import type { Speaker } from "../speakers.ts";
+import { PluginError } from "../kernel/errors.ts";
 
 export interface SurfacePortOptions {
 	/** Told when a caller uses a form that goes away, such as `prompts(channel, speaker)`. */