gsd-pi 2.33.1 → 2.34.0-dev.6769913

package/dist/resources/extensions/mcp-client/index.ts

@@ -1,459 +0,0 @@
-/**
- * MCP Client Extension — Native MCP server integration for pi
- *
- * Provides on-demand access to MCP servers configured in project files
- * (.mcp.json, .gsd/mcp.json) using the @modelcontextprotocol/sdk Client
- * directly — no external CLI dependency required.
- *
- * Three tools:
- *   mcp_servers   — List available MCP servers from config files
- *   mcp_discover  — Get tool signatures for a specific server (lazy connect)
- *   mcp_call      — Call a tool on an MCP server (lazy connect)
- */
-
-import type { ExtensionAPI } from "@gsd/pi-coding-agent";
-import {
-	truncateHead,
-	DEFAULT_MAX_BYTES,
-	DEFAULT_MAX_LINES,
-	formatSize,
-} from "@gsd/pi-coding-agent";
-import { Text } from "@gsd/pi-tui";
-import { Type } from "@sinclair/typebox";
-import { Client } from "@modelcontextprotocol/sdk/client";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { readFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface McpServerConfig {
-	name: string;
-	transport: "stdio" | "http" | "unknown";
-	command?: string;
-	args?: string[];
-	env?: Record<string, string>;
-	url?: string;
-	cwd?: string;
-}
-
-interface McpToolSchema {
-	name: string;
-	description: string;
-	inputSchema?: Record<string, unknown>;
-}
-
-interface ManagedConnection {
-	client: Client;
-	transport: StdioClientTransport | StreamableHTTPClientTransport;
-}
-
-// ─── Connection Manager ───────────────────────────────────────────────────────
-
-const connections = new Map<string, ManagedConnection>();
-let configCache: McpServerConfig[] | null = null;
-const toolCache = new Map<string, McpToolSchema[]>();
-
-function readConfigs(): McpServerConfig[] {
-	if (configCache) return configCache;
-
-	const servers: McpServerConfig[] = [];
-	const seen = new Set<string>();
-	const configPaths = [
-		join(process.cwd(), ".mcp.json"),
-		join(process.cwd(), ".gsd", "mcp.json"),
-	];
-
-	for (const configPath of configPaths) {
-		try {
-			if (!existsSync(configPath)) continue;
-			const raw = readFileSync(configPath, "utf-8");
-			const data = JSON.parse(raw) as Record<string, unknown>;
-			const mcpServers = (data.mcpServers ?? data.servers) as
-				| Record<string, Record<string, unknown>>
-				| undefined;
-			if (!mcpServers || typeof mcpServers !== "object") continue;
-
-			for (const [name, config] of Object.entries(mcpServers)) {
-				if (seen.has(name)) continue;
-				seen.add(name);
-
-				const hasCommand = typeof config.command === "string";
-				const hasUrl = typeof config.url === "string";
-				const transport: McpServerConfig["transport"] = hasCommand
-					? "stdio"
-					: hasUrl
-						? "http"
-						: "unknown";
-
-				servers.push({
-					name,
-					transport,
-					...(hasCommand && {
-						command: config.command as string,
-						args: Array.isArray(config.args) ? (config.args as string[]) : undefined,
-						env: config.env && typeof config.env === "object"
-							? (config.env as Record<string, string>)
-							: undefined,
-						cwd: typeof config.cwd === "string" ? config.cwd : undefined,
-					}),
-					...(hasUrl && { url: config.url as string }),
-				});
-			}
-		} catch {
-			// Non-fatal — config file may not exist or be malformed
-		}
-	}
-
-	configCache = servers;
-	return servers;
-}
-
-function getServerConfig(name: string): McpServerConfig | undefined {
-	return readConfigs().find((s) => s.name === name);
-}
-
-async function getOrConnect(name: string, signal?: AbortSignal): Promise<Client> {
-	const existing = connections.get(name);
-	if (existing) return existing.client;
-
-	const config = getServerConfig(name);
-	if (!config) throw new Error(`Unknown MCP server: "${name}". Use mcp_servers to list available servers.`);
-
-	const client = new Client({ name: "gsd", version: "1.0.0" });
-	let transport: StdioClientTransport | StreamableHTTPClientTransport;
-
-	if (config.transport === "stdio" && config.command) {
-		transport = new StdioClientTransport({
-			command: config.command,
-			args: config.args,
-			env: config.env ? { ...process.env, ...config.env } as Record<string, string> : undefined,
-			cwd: config.cwd,
-			stderr: "pipe",
-		});
-	} else if (config.transport === "http" && config.url) {
-		transport = new StreamableHTTPClientTransport(new URL(config.url));
-	} else {
-		throw new Error(`Server "${name}" has unsupported transport: ${config.transport}`);
-	}
-
-	await client.connect(transport, { signal, timeout: 30000 });
-	connections.set(name, { client, transport });
-	return client;
-}
-
-async function closeAll(): Promise<void> {
-	const closing = Array.from(connections.entries()).map(async ([name, conn]) => {
-		try {
-			await conn.client.close();
-		} catch {
-			// Best-effort cleanup
-		}
-		connections.delete(name);
-	});
-	await Promise.allSettled(closing);
-	toolCache.clear();
-}
-
-// ─── Formatters ───────────────────────────────────────────────────────────────
-
-function formatServerList(servers: McpServerConfig[]): string {
-	if (servers.length === 0) return "No MCP servers configured. Add servers to .mcp.json or .gsd/mcp.json.";
-
-	const lines: string[] = [`${servers.length} MCP servers configured:\n`];
-
-	for (const s of servers) {
-		const connected = connections.has(s.name) ? "✓" : "○";
-		const cached = toolCache.get(s.name);
-		const toolCount = cached ? ` — ${cached.length} tools` : "";
-		lines.push(`${connected} ${s.name} (${s.transport})${toolCount}`);
-	}
-
-	lines.push("\nUse mcp_discover to see full tool schemas for a specific server.");
-	lines.push("Use mcp_call to invoke a tool: mcp_call(server, tool, args).");
-	return lines.join("\n");
-}
-
-function formatToolList(serverName: string, tools: McpToolSchema[]): string {
-	const lines: string[] = [`${serverName} — ${tools.length} tools:\n`];
-
-	for (const tool of tools) {
-		lines.push(`## ${tool.name}`);
-		if (tool.description) lines.push(tool.description);
-		if (tool.inputSchema) {
-			lines.push("```json");
-			lines.push(JSON.stringify(tool.inputSchema, null, 2));
-			lines.push("```");
-		}
-		lines.push("");
-	}
-
-	lines.push(`Call with: mcp_call(server="${serverName}", tool="<tool_name>", args={...})`);
-	return lines.join("\n");
-}
-
-// ─── Extension ────────────────────────────────────────────────────────────────
-
-export default function (pi: ExtensionAPI) {
-	// ── mcp_servers ──────────────────────────────────────────────────────────
-
-	pi.registerTool({
-		name: "mcp_servers",
-		label: "MCP Servers",
-		description:
-			"List all available MCP servers configured in project files (.mcp.json, .gsd/mcp.json). " +
-			"Shows server names, transport type, and connection status. Use mcp_discover to get full tool schemas for a server.",
-		promptSnippet:
-			"List available MCP servers from project configuration",
-		promptGuidelines: [
-			"Call mcp_servers to see what MCP servers are available before trying to use one.",
-			"MCP servers provide external integrations (Twitter, Linear, Railway, etc.) via the Model Context Protocol.",
-			"After listing, use mcp_discover(server) to get tool schemas, then mcp_call(server, tool, args) to invoke.",
-		],
-		parameters: Type.Object({
-			refresh: Type.Optional(
-				Type.Boolean({ description: "Force refresh the server list (default: use cache)" }),
-			),
-		}),
-
-		async execute(_id, params) {
-			if (params.refresh) configCache = null;
-
-			const servers = readConfigs();
-			return {
-				content: [{ type: "text", text: formatServerList(servers) }],
-				details: {
-					serverCount: servers.length,
-					cached: !params.refresh && configCache !== null,
-				},
-			};
-		},
-
-		renderCall(args, theme) {
-			let text = theme.fg("toolTitle", theme.bold("mcp_servers"));
-			if (args.refresh) text += theme.fg("warning", " (refresh)");
-			return new Text(text, 0, 0);
-		},
-
-		renderResult(result, { isPartial }, theme) {
-			if (isPartial) return new Text(theme.fg("warning", "Reading MCP config..."), 0, 0);
-			const d = result.details as { serverCount: number } | undefined;
-			return new Text(
-				theme.fg("success", `${d?.serverCount ?? 0} servers configured`),
-				0,
-				0,
-			);
-		},
-	});
-
-	// ── mcp_discover ─────────────────────────────────────────────────────────
-
-	pi.registerTool({
-		name: "mcp_discover",
-		label: "MCP Discover",
-		description:
-			"Get detailed tool signatures and JSON schemas for a specific MCP server. " +
-			"Connects to the server on first call (lazy connection). " +
-			"Use this to understand what tools a server provides and what arguments they accept " +
-			"before calling them with mcp_call.",
-		promptSnippet:
-			"Get tool schemas for a specific MCP server before calling its tools",
-		promptGuidelines: [
-			"Call mcp_discover with a server name to see the full tool signatures before calling mcp_call.",
-			"The schemas show required and optional parameters with types and descriptions.",
-		],
-		parameters: Type.Object({
-			server: Type.String({
-				description:
-					"MCP server name (from mcp_servers output), e.g. 'railway', 'twitter-mcp', 'linear'",
-			}),
-		}),
-
-		async execute(_id, params, signal) {
-			try {
-				// Return cached tools if available
-				const cached = toolCache.get(params.server);
-				if (cached) {
-					const text = formatToolList(params.server, cached);
-					const truncation = truncateHead(text, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
-					let finalText = truncation.content;
-					if (truncation.truncated) {
-						finalText += `\n\n[Truncated: ${truncation.outputLines}/${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)})]`;
-					}
-					return {
-						content: [{ type: "text", text: finalText }],
-						details: { server: params.server, toolCount: cached.length, cached: true },
-					};
-				}
-
-				const client = await getOrConnect(params.server, signal);
-				const result = await client.listTools(undefined, { signal, timeout: 30000 });
-				const tools: McpToolSchema[] = (result.tools ?? []).map((t) => ({
-					name: t.name,
-					description: t.description ?? "",
-					inputSchema: t.inputSchema as Record<string, unknown> | undefined,
-				}));
-				toolCache.set(params.server, tools);
-
-				const text = formatToolList(params.server, tools);
-				const truncation = truncateHead(text, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
-				let finalText = truncation.content;
-				if (truncation.truncated) {
-					finalText += `\n\n[Truncated: ${truncation.outputLines}/${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)})]`;
-				}
-
-				return {
-					content: [{ type: "text", text: finalText }],
-					details: { server: params.server, toolCount: tools.length, cached: false },
-				};
-			} catch (err: unknown) {
-				const msg = err instanceof Error ? err.message : String(err);
-				throw new Error(`Failed to discover tools for "${params.server}": ${msg}`);
-			}
-		},
-
-		renderCall(args, theme) {
-			let text = theme.fg("toolTitle", theme.bold("mcp_discover "));
-			text += theme.fg("accent", args.server);
-			return new Text(text, 0, 0);
-		},
-
-		renderResult(result, { isPartial }, theme) {
-			if (isPartial)
-				return new Text(theme.fg("warning", "Discovering tools..."), 0, 0);
-			const d = result.details as { server: string; toolCount: number } | undefined;
-			return new Text(
-				theme.fg("success", `${d?.toolCount ?? 0} tools`) +
-					theme.fg("dim", ` · ${d?.server}`),
-				0,
-				0,
-			);
-		},
-	});
-
-	// ── mcp_call ─────────────────────────────────────────────────────────────
-
-	pi.registerTool({
-		name: "mcp_call",
-		label: "MCP Call",
-		description:
-			"Call a tool on an MCP server. Provide the server name, tool name, and arguments. " +
-			"Connects to the server on first call (lazy connection). " +
-			"Use mcp_discover first to see available tools and their required arguments.",
-		promptSnippet: "Call a tool on an MCP server",
-		promptGuidelines: [
-			"Always use mcp_discover first to understand the tool's parameters before calling mcp_call.",
-			"Arguments are passed as a JSON object matching the tool's input schema.",
-		],
-		parameters: Type.Object({
-			server: Type.String({
-				description: "MCP server name, e.g. 'railway', 'twitter-mcp'",
-			}),
-			tool: Type.String({
-				description: "Tool name on that server, e.g. 'railway_list_projects'",
-			}),
-			args: Type.Optional(
-				Type.Record(Type.String(), Type.Unknown(), {
-					description:
-						"Tool arguments as key-value pairs matching the tool's input schema",
-				}),
-			),
-		}),
-
-		async execute(_id, params, signal) {
-			try {
-				const client = await getOrConnect(params.server, signal);
-				const result = await client.callTool(
-					{ name: params.tool, arguments: params.args ?? {} },
-					undefined,
-					{ signal, timeout: 60000 },
-				);
-
-				// Serialize result content to text
-				const contentItems = result.content as Array<{ type: string; text?: string }>;
-				const raw = contentItems
-					.map((c) => (c.type === "text" ? c.text ?? "" : JSON.stringify(c)))
-					.join("\n");
-
-				const truncation = truncateHead(raw, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
-				let finalText = truncation.content;
-				if (truncation.truncated) {
-					finalText += `\n\n[Output truncated: ${truncation.outputLines}/${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)})]`;
-				}
-
-				return {
-					content: [{ type: "text", text: finalText }],
-					details: {
-						server: params.server,
-						tool: params.tool,
-						charCount: finalText.length,
-						truncated: truncation.truncated,
-					},
-				};
-			} catch (err: unknown) {
-				const msg = err instanceof Error ? err.message : String(err);
-				throw new Error(`MCP call failed: ${params.server}.${params.tool}\n${msg}`);
-			}
-		},
-
-		renderCall(args, theme) {
-			let text = theme.fg("toolTitle", theme.bold("mcp_call "));
-			text += theme.fg("accent", `${args.server}.${args.tool}`);
-			if (args.args && Object.keys(args.args).length > 0) {
-				const preview = Object.entries(args.args)
-					.slice(0, 3)
-					.map(([k, v]) => {
-						const val = typeof v === "string" ? v : JSON.stringify(v);
-						return `${k}:${val.length > 30 ? val.slice(0, 30) + "…" : val}`;
-					})
-					.join(" ");
-				text += " " + theme.fg("muted", preview);
-			}
-			return new Text(text, 0, 0);
-		},
-
-		renderResult(result, { isPartial, expanded }, theme) {
-			if (isPartial) return new Text(theme.fg("warning", "Calling MCP tool..."), 0, 0);
-
-			const d = result.details as {
-				server: string;
-				tool: string;
-				charCount: number;
-				truncated: boolean;
-			} | undefined;
-
-			let text = theme.fg("success", `✓ ${d?.server}.${d?.tool}`);
-			text += theme.fg("dim", ` · ${(d?.charCount ?? 0).toLocaleString()} chars`);
-			if (d?.truncated) text += theme.fg("warning", " · truncated");
-
-			if (expanded) {
-				const content = result.content[0];
-				if (content?.type === "text") {
-					const preview = content.text.split("\n").slice(0, 15).join("\n");
-					text += "\n\n" + theme.fg("dim", preview);
-				}
-			}
-
-			return new Text(text, 0, 0);
-		},
-	});
-
-	// ── Lifecycle ─────────────────────────────────────────────────────────────
-
-	pi.on("session_start", async (_event, ctx) => {
-		const servers = readConfigs();
-		if (servers.length > 0) {
-			ctx.ui.notify(`MCP client ready — ${servers.length} server(s) configured`, "info");
-		}
-	});
-
-	pi.on("session_shutdown", async () => {
-		await closeAll();
-	});
-
-	pi.on("session_switch", async () => {
-		await closeAll();
-		configCache = null;
-	});
-}

package/dist/resources/extensions/remote-questions/config.ts

@@ -1,83 +0,0 @@
-/**
- * Remote Questions — configuration resolution and validation
- */
-
-import { loadEffectiveGSDPreferences, type RemoteQuestionsConfig } from "../gsd/preferences.js";
-import type { RemoteChannel } from "./types.js";
-
-export interface ResolvedConfig {
-  channel: RemoteChannel;
-  channelId: string;
-  timeoutMs: number;
-  pollIntervalMs: number;
-  token: string;
-}
-
-const ENV_KEYS: Record<RemoteChannel, string> = {
-  slack: "SLACK_BOT_TOKEN",
-  discord: "DISCORD_BOT_TOKEN",
-  telegram: "TELEGRAM_BOT_TOKEN",
-};
-
-// Channel ID format validation — prevents SSRF if preferences are attacker-controlled
-const CHANNEL_ID_PATTERNS: Record<RemoteChannel, RegExp> = {
-  slack: /^[A-Z0-9]{9,12}$/,
-  discord: /^\d{17,20}$/,
-  telegram: /^-?\d{5,20}$/,
-};
-
-const DEFAULT_TIMEOUT_MINUTES = 5;
-const DEFAULT_POLL_INTERVAL_SECONDS = 5;
-const MIN_TIMEOUT_MINUTES = 1;
-const MAX_TIMEOUT_MINUTES = 30;
-const MIN_POLL_INTERVAL_SECONDS = 2;
-const MAX_POLL_INTERVAL_SECONDS = 30;
-
-export function resolveRemoteConfig(): ResolvedConfig | null {
-  const prefs = loadEffectiveGSDPreferences();
-  const rq: RemoteQuestionsConfig | undefined = prefs?.preferences.remote_questions;
-  if (!rq || !rq.channel || !rq.channel_id) return null;
-  if (rq.channel !== "slack" && rq.channel !== "discord" && rq.channel !== "telegram") return null;
-
-  const channelId = String(rq.channel_id);
-  if (!CHANNEL_ID_PATTERNS[rq.channel].test(channelId)) return null;
-
-  const token = process.env[ENV_KEYS[rq.channel]];
-  if (!token) return null;
-
-  const timeoutMinutes = clampNumber(rq.timeout_minutes, DEFAULT_TIMEOUT_MINUTES, MIN_TIMEOUT_MINUTES, MAX_TIMEOUT_MINUTES);
-  const pollIntervalSeconds = clampNumber(rq.poll_interval_seconds, DEFAULT_POLL_INTERVAL_SECONDS, MIN_POLL_INTERVAL_SECONDS, MAX_POLL_INTERVAL_SECONDS);
-
-  return {
-    channel: rq.channel,
-    channelId,
-    timeoutMs: timeoutMinutes * 60 * 1000,
-    pollIntervalMs: pollIntervalSeconds * 1000,
-    token,
-  };
-}
-
-export function getRemoteConfigStatus(): string {
-  const prefs = loadEffectiveGSDPreferences();
-  const rq: RemoteQuestionsConfig | undefined = prefs?.preferences.remote_questions;
-  if (!rq || !rq.channel || !rq.channel_id) return "Remote questions: not configured";
-  if (rq.channel !== "slack" && rq.channel !== "discord" && rq.channel !== "telegram") return `Remote questions: unknown channel type \"${rq.channel}\"`;
-  const channelId = String(rq.channel_id);
-  if (!CHANNEL_ID_PATTERNS[rq.channel].test(channelId)) return `Remote questions: invalid ${rq.channel} channel ID format`;
-  const envVar = ENV_KEYS[rq.channel];
-  if (!process.env[envVar]) return `Remote questions: ${envVar} not set — remote questions disabled`;
-
-  const timeoutMinutes = clampNumber(rq.timeout_minutes, DEFAULT_TIMEOUT_MINUTES, MIN_TIMEOUT_MINUTES, MAX_TIMEOUT_MINUTES);
-  const pollIntervalSeconds = clampNumber(rq.poll_interval_seconds, DEFAULT_POLL_INTERVAL_SECONDS, MIN_POLL_INTERVAL_SECONDS, MAX_POLL_INTERVAL_SECONDS);
-  return `Remote questions: ${rq.channel} configured (timeout ${timeoutMinutes}m, poll ${pollIntervalSeconds}s)`;
-}
-
-export function isValidChannelId(channel: RemoteChannel, id: string): boolean {
-  return CHANNEL_ID_PATTERNS[channel].test(id);
-}
-
-function clampNumber(value: unknown, fallback: number, min: number, max: number): number {
-  const n = typeof value === "number" ? value : Number(value);
-  if (!Number.isFinite(n)) return fallback;
-  return Math.max(min, Math.min(max, n));
-}

package/dist/resources/extensions/remote-questions/discord-adapter.ts

@@ -1,148 +0,0 @@
-/**
- * Remote Questions — Discord adapter
- */
-
-import { type ChannelAdapter, type RemotePrompt, type RemoteDispatchResult, type RemoteAnswer, type RemotePromptRef } from "./types.js";
-import { formatForDiscord, parseDiscordResponse, DISCORD_NUMBER_EMOJIS } from "./format.js";
-import { apiRequest } from "./http-client.js";
-
-const DISCORD_API = "https://discord.com/api/v10";
-
-export class DiscordAdapter implements ChannelAdapter {
-  readonly name = "discord" as const;
-  private botUserId: string | null = null;
-  private guildId: string | null = null;
-  private readonly token: string;
-  private readonly channelId: string;
-
-  constructor(token: string, channelId: string) {
-    this.token = token;
-    this.channelId = channelId;
-  }
-
-  async validate(): Promise<void> {
-    const res = await this.discordApi("GET", "/users/@me");
-    if (!res.id) throw new Error("Discord auth failed: invalid token");
-    this.botUserId = String(res.id);
-
-    // Resolve guild ID for message URL generation.
-    // The channel belongs to a guild — fetch channel info to discover it.
-    try {
-      const channelInfo = await this.discordApi("GET", `/channels/${this.channelId}`);
-      if (channelInfo.guild_id) {
-        this.guildId = String(channelInfo.guild_id);
-      }
-    } catch {
-      // Non-fatal — message URLs will be omitted if guild ID can't be resolved
-    }
-  }
-
-  async sendPrompt(prompt: RemotePrompt): Promise<RemoteDispatchResult> {
-    const { embeds, reactionEmojis } = formatForDiscord(prompt);
-    const res = await this.discordApi("POST", `/channels/${this.channelId}/messages`, {
-      content: "**GSD needs your input** — reply to this message with your answer",
-      embeds,
-    });
-
-    if (!res.id) throw new Error(`Discord send failed: ${JSON.stringify(res)}`);
-
-    const messageId = String(res.id);
-    if (prompt.questions.length === 1) {
-      for (const emoji of reactionEmojis) {
-        try {
-          await this.discordApi("PUT", `/channels/${this.channelId}/messages/${messageId}/reactions/${encodeURIComponent(emoji)}/@me`);
-        } catch {
-          // Best-effort only
-        }
-      }
-    }
-
-    // Build message URL if guild ID is available
-    const messageUrl = this.guildId
-      ? `https://discord.com/channels/${this.guildId}/${this.channelId}/${messageId}`
-      : undefined;
-
-    return {
-      ref: {
-        id: prompt.id,
-        channel: "discord",
-        messageId,
-        channelId: this.channelId,
-        threadUrl: messageUrl,
-      },
-    };
-  }
-
-  async pollAnswer(prompt: RemotePrompt, ref: RemotePromptRef): Promise<RemoteAnswer | null> {
-    if (!this.botUserId) await this.validate();
-
-    if (prompt.questions.length === 1) {
-      const reactionAnswer = await this.checkReactions(prompt, ref);
-      if (reactionAnswer) return reactionAnswer;
-    }
-
-    return this.checkReplies(prompt, ref);
-  }
-
-  /**
-   * Acknowledge that an answer was received by adding a ✅ reaction to the
-   * original prompt message. Best-effort — failures are silently ignored.
-   */
-  async acknowledgeAnswer(ref: RemotePromptRef): Promise<void> {
-    try {
-      await this.discordApi(
-        "PUT",
-        `/channels/${ref.channelId}/messages/${ref.messageId}/reactions/${encodeURIComponent("✅")}/@me`,
-      );
-    } catch {
-      // Best-effort — don't let acknowledgement failures affect the flow
-    }
-  }
-
-  private async checkReactions(prompt: RemotePrompt, ref: RemotePromptRef): Promise<RemoteAnswer | null> {
-    const reactions: Array<{ emoji: string; count: number }> = [];
-    for (const emoji of DISCORD_NUMBER_EMOJIS) {
-      try {
-        const users = await this.discordApi("GET", `/channels/${ref.channelId}/messages/${ref.messageId}/reactions/${encodeURIComponent(emoji)}`);
-        if (Array.isArray(users)) {
-          const humanUsers = users.filter((u: { id: string }) => u.id !== this.botUserId);
-          if (humanUsers.length > 0) reactions.push({ emoji, count: humanUsers.length });
-        }
-      } catch (err) {
-        const msg = String((err as Error).message ?? "");
-        // 404 = no reactions for this emoji — expected, continue
-        if (msg.includes("HTTP 404")) continue;
-        // 401/403 = auth failure — surface to caller so it can fail the poll
-        if (msg.includes("HTTP 401") || msg.includes("HTTP 403")) throw err;
-        // Other errors (rate limit, network) — skip this emoji, best-effort
-      }
-    }
-
-    if (reactions.length === 0) return null;
-    return parseDiscordResponse(reactions, null, prompt.questions);
-  }
-
-  private async checkReplies(prompt: RemotePrompt, ref: RemotePromptRef): Promise<RemoteAnswer | null> {
-    const messages = await this.discordApi("GET", `/channels/${ref.channelId}/messages?after=${ref.messageId}&limit=10`);
-    if (!Array.isArray(messages)) return null;
-
-    const replies = messages.filter(
-      (m: { author?: { id?: string }; message_reference?: { message_id?: string }; content?: string }) =>
-        m.author?.id &&
-        m.author.id !== this.botUserId &&
-        m.message_reference?.message_id === ref.messageId &&
-        m.content,
-    );
-
-    if (replies.length === 0) return null;
-    return parseDiscordResponse([], String(replies[0].content), prompt.questions);
-  }
-
-  private async discordApi(method: "GET" | "POST" | "PUT" | "DELETE", path: string, body?: unknown): Promise<any> {
-    return apiRequest(`${DISCORD_API}${path}`, method, body, {
-      authScheme: "Bot",
-      authToken: this.token,
-      errorLabel: "Discord API",
-    });
-  }
-}