pi-roundtable-mcp 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-10-01
+
+### Added
+
+- `remoteMcp({ toolNames })`: the names of the two tools at `/mcp/personal`, for agents that are already set up with other names. The default descriptions name each other with the chosen names. A name that is not letters, digits, `_` or `-` (up to 64), or two equal names, is refused when the plugin is created.
+
+### Changed
+
+- `RemoteMcpMessages.dispatchDescription` and `resultDescription` are now functions that receive the tool names, so a description can refer to the other tool by its real name. A host that set either as a string gives `() => "..."` instead.
+
 ## [0.1.0] - 2026-10-01
 
 First release: two plugins for pi-roundtable 0.4, extracted from a private host.

package/README.md

@@ -153,7 +153,8 @@ The owner manages connectors on Discord with `/<root> connector`, where `<root>`
 | `publicUrl` | `string` | required | The HTTPS address that reaches the host's `public` listener. Granted-channel URLs are built on its origin |
 | `persona` | `string` | a short neutral prompt | The system prompt of the default `remote` conversations |
 | `answer`, `claim` | see [below](#when-the-host-runs-the-conversations-itself) | the core's runtime | Give both, or neither |
-| `messages` | `Partial<RemoteMcpMessages>` | English | The relay note, the tool descriptions, and the Discord text, in your wording |
+| `messages` | `Partial<RemoteMcpMessages>` | English | The relay note, the tool descriptions, and the Discord text, in your wording. `dispatchDescription` and `resultDescription` are functions that receive the tool names |
+| `toolNames` | `{ dispatch?: string; result?: string }` | `agent_dispatch`, `agent_result` | The names of the two tools at `/mcp/personal`, for agents that are already set up with other names. The default descriptions follow them |
 
 The plugin serves two endpoints on the host's `public` listener:
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-mcp",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "MCP connectors through ContextForge and a remote MCP endpoint for pi-roundtable",
 	"type": "module",
 	"license": "MIT",

package/src/index.ts

@@ -13,7 +13,10 @@ export type {
 export { CONNECTORS, mcpConnectors } from "./connectors/connectors-plugin.ts";
 export type { UpstreamAuth } from "./connectors/contextforge.ts";
 export type { ConnectorMessages } from "./connectors/messages.ts";
-export type { RemoteMcpMessages } from "./remote-mcp/messages.ts";
+export type {
+	RemoteMcpMessages,
+	RemoteToolNames,
+} from "./remote-mcp/messages.ts";
 export type { RemoteClaimHooks } from "./remote-mcp/remote-claim.ts";
 export type {
 	DefaultConversationOptions,

package/src/remote-mcp/mcp-gateway.ts

@@ -23,14 +23,17 @@ import {
 	hashChannelToken,
 } from "./channel-grants.ts";
 import { runGrantedTool } from "./channel-tools.ts";
-import { REMOTE_MCP_MESSAGES, type RemoteMcpMessages } from "./messages.ts";
+import {
+	DEFAULT_TOOL_NAMES,
+	REMOTE_MCP_MESSAGES,
+	type RemoteMcpMessages,
+	type RemoteToolNames,
+} from "./messages.ts";
 import { type RemoteAgent, RemoteAgentError } from "./remote-agent.ts";
 
 /** Requests may carry uploads; anything larger is refused before it is parsed. */
 const MAX_BODY_BYTES = 12 * 1024 * 1024;
 
-export const DISPATCH_TOOL = "agent_dispatch";
-export const RESULT_TOOL = "agent_result";
 const LIST_CHANNELS_TOOL = "discord_list_authorized_channels";
 
 export interface McpGatewayOptions {
@@ -42,6 +45,8 @@ export interface McpGatewayOptions {
 	executor(): ChannelExecutor | undefined;
 	logger: Logger;
 	messages?: RemoteMcpMessages;
+	/** The names of the dispatch and result tools; `agent_dispatch` and `agent_result` by default. */
+	toolNames?: RemoteToolNames;
 }
 
 interface ToolSpec {
@@ -73,11 +78,13 @@ const ResultInput = Type.Object(
 export class McpGateway {
 	readonly #options: McpGatewayOptions;
 	readonly #text: RemoteMcpMessages;
+	readonly #tools: RemoteToolNames;
 	readonly #dispatchInput: TSchema;
 
 	constructor(options: McpGatewayOptions) {
 		this.#options = options;
 		this.#text = options.messages ?? REMOTE_MCP_MESSAGES;
+		this.#tools = options.toolNames ?? DEFAULT_TOOL_NAMES;
 		this.#dispatchInput = Type.Object(
 			{
 				message: Type.String({ minLength: 1 }),
@@ -172,8 +179,8 @@ export class McpGateway {
 		return [
 			{
 				tool: {
-					name: DISPATCH_TOOL,
-					description: this.#text.dispatchDescription,
+					name: this.#tools.dispatch,
+					description: this.#text.dispatchDescription(this.#tools),
 					inputSchema: jsonSchema(this.#dispatchInput),
 				},
 				call: async (args) => {
@@ -187,8 +194,8 @@ export class McpGateway {
 			},
 			{
 				tool: {
-					name: RESULT_TOOL,
-					description: this.#text.resultDescription,
+					name: this.#tools.result,
+					description: this.#text.resultDescription(this.#tools),
 					inputSchema: jsonSchema(ResultInput),
 					annotations: { readOnlyHint: true, idempotentHint: true },
 				},

package/src/remote-mcp/messages.ts

@@ -1,3 +1,14 @@
+/** The names of the two tools `/mcp/personal` offers. */
+export interface RemoteToolNames {
+	dispatch: string;
+	result: string;
+}
+
+export const DEFAULT_TOOL_NAMES: RemoteToolNames = {
+	dispatch: "agent_dispatch",
+	result: "agent_result",
+};
+
 /**
  * The text of the remote MCP plugin: what outside agents read in tool descriptions and errors,
  * and what the owner reads in the Discord commands.
@@ -10,8 +21,10 @@ export interface RemoteMcpMessages {
 	/** Sent for a granted tool call that failed in a way the agent must not retry. */
 	operationUnfinished: string;
 
-	dispatchDescription: string;
-	resultDescription: string;
+	/** The description of the dispatch tool; `tools` holds the names the host chose. */
+	dispatchDescription(tools: RemoteToolNames): string;
+	/** The description of the result tool. */
+	resultDescription(tools: RemoteToolNames): string;
 	sessionIdDescription: string;
 	listChannelsDescription: string;
 	/** Appended to every granted channel tool's description. */
@@ -87,12 +100,12 @@ export const REMOTE_MCP_MESSAGES: RemoteMcpMessages = {
 	operationUnfinished:
 		"The operation did not complete. Check the audit log of the grants on Discord; do not retry automatically.",
 
-	dispatchDescription:
+	dispatchDescription: (tools) =>
 		"Start or continue a conversation turn with the owner's personal agent, on the owner's behalf. " +
-		"Returns { runId, sessionId } at once without waiting for the agent to finish; poll agent_result with the runId. " +
+		`Returns { runId, sessionId } at once without waiting for the agent to finish; poll ${tools.result} with the runId. ` +
 		"Omit sessionId to start a new conversation; pass a returned sessionId to continue it.",
-	resultDescription:
-		"Poll a run started by agent_dispatch. Returns { status: 'working' | 'completed' | 'failed', text?, error? }.",
+	resultDescription: (tools) =>
+		`Poll a run started by ${tools.dispatch}. Returns { status: 'working' | 'completed' | 'failed', text?, error? }.`,
 	sessionIdDescription:
 		"A sessionId returned earlier; omit it to start a new conversation",
 	listChannelsDescription:

package/src/remote-mcp/remote-mcp-plugin.ts

@@ -18,7 +18,12 @@ import {
 } from "./default-conversation.ts";
 import { McpGateway } from "./mcp-gateway.ts";
 import { mcpGrantCommands } from "./mcp-grant-commands.ts";
-import { type RemoteMcpMessages, remoteMcpMessages } from "./messages.ts";
+import {
+	DEFAULT_TOOL_NAMES,
+	type RemoteMcpMessages,
+	type RemoteToolNames,
+	remoteMcpMessages,
+} from "./messages.ts";
 import { RemoteAgent } from "./remote-agent.ts";
 import { type RemoteClaimHooks, remoteClaim } from "./remote-claim.ts";
 import { RemoteSessionStore } from "./remote-session-store.ts";
@@ -37,6 +42,11 @@ interface RemoteMcpBaseOptions {
 	publicUrl: string;
 	/** The Discord text, the relay note, and the tool descriptions in your wording; English by default. */
 	messages?: Partial<RemoteMcpMessages>;
+	/**
+	 * The names of the two tools at `/mcp/personal`, for agents already set up with other names;
+	 * `agent_dispatch` and `agent_result` by default. The default descriptions follow the names.
+	 */
+	toolNames?: Partial<RemoteToolNames>;
 }
 
 /** Remote turns run on the core's runtime: nothing more to give. */
@@ -63,6 +73,21 @@ export interface HostConversationOptions {
 export type RemoteMcpOptions = RemoteMcpBaseOptions &
 	(DefaultConversationOptions | HostConversationOptions);
 
+const TOOL_NAME = /^[A-Za-z0-9_-]{1,64}$/;
+
+/** The tool names with the host's overrides laid over the defaults; refuses names a client cannot use. */
+function toolNamesOf(options: RemoteMcpOptions): RemoteToolNames {
+	const names = { ...DEFAULT_TOOL_NAMES, ...options.toolNames };
+	for (const name of Object.values(names))
+		if (!TOOL_NAME.test(name))
+			throw new ConfigError(
+				`remote-mcp: toolNames: "${name}" is not a tool name (letters, digits, _ and -, up to 64)`,
+			);
+	if (names.dispatch === names.result)
+		throw new ConfigError("remote-mcp: toolNames: the two names must differ");
+	return names;
+}
+
 function checkOptions(options: RemoteMcpOptions): void {
 	if (!options.dispatchToken)
 		throw new ConfigError("remote-mcp: dispatchToken is empty");
@@ -83,6 +108,7 @@ function checkOptions(options: RemoteMcpOptions): void {
 export function remoteMcp(options: RemoteMcpOptions): RoundtablePlugin {
 	checkOptions(options);
 	const text = remoteMcpMessages(options.messages);
+	const toolNames = toolNamesOf(options);
 	return definePlugin({
 		name: "remote-mcp",
 		requires: [DISCORD],
@@ -105,6 +131,7 @@ export function remoteMcp(options: RemoteMcpOptions): RoundtablePlugin {
 				executor: () => discord.connection.channelExecutor(),
 				logger,
 				messages: text,
+				toolNames,
 			});
 			const sweeper = new RemoteSessionSweeper({
 				sessions,