@bytesbrains/pi-telegram-bridge 1.1.2 → 1.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytesbrains/pi-telegram-bridge",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Telegram bot bridge for pi agents — send messages, ask questions, and listen for human replies via Telegram.",
   "keywords": [
     "pi-package",
@@ -49,6 +49,7 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
+    "@types/node": "^25.8.0",
     "typescript": "^6.0.3",
     "vitest": "^2.1.9"
   }

package/src/helpers.ts

@@ -6,246 +6,241 @@ const BASE_URL = "https://api.telegram.org/bot";
 // ── Config ──────────────────────────────────────────────────────────
 
 export function getToken(): string {
-  const tok = process.env.TELEGRAM_BOT_TOKEN;
-  if (!tok) throw new Error("TELEGRAM_BOT_TOKEN not set");
-  return tok;
+	const tok = process.env.TELEGRAM_BOT_TOKEN;
+	if (!tok) throw new Error("TELEGRAM_BOT_TOKEN not set");
+	return tok;
 }
 
 export function getChatId(): string {
-  const id = process.env.TELEGRAM_CHAT_ID;
-  if (!id) throw new Error("TELEGRAM_CHAT_ID not set");
-  return id;
+	const id = process.env.TELEGRAM_CHAT_ID;
+	if (!id) throw new Error("TELEGRAM_CHAT_ID not set");
+	return id;
 }
 
 // ── API ─────────────────────────────────────────────────────────────
 
 export async function telegramApi(
-  method: string,
-  body: Record<string, unknown>,
+	method: string,
+	body: Record<string, unknown>,
 ): Promise<unknown> {
-  const url = `${BASE_URL}${getToken()}/${method}`;
-  const res = await fetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(body),
-  });
-  if (!res.ok) {
-    throw new Error(`Telegram API ${res.status}: ${await res.text()}`);
-  }
-  return res.json();
+	const url = `${BASE_URL}${getToken()}/${method}`;
+	const res = await fetch(url, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify(body),
+	});
+	if (!res.ok) {
+		throw new Error(`Telegram API ${res.status}: ${await res.text()}`);
+	}
+	return res.json();
 }
 
 // ── Messaging ───────────────────────────────────────────────────────
 
 export async function sendMsg(
-  text: string,
-  replyMarkup?: object,
+	text: string,
+	replyMarkup?: object,
+	parseMode: "Markdown" | "HTML" | undefined = undefined,
 ): Promise<number> {
-  const body: Record<string, unknown> = {
-    chat_id: getChatId(),
-    text,
-    parse_mode: "Markdown",
-  };
-  if (replyMarkup) body.reply_markup = JSON.stringify(replyMarkup);
-  const r = (await telegramApi("sendMessage", body)) as {
-    ok: boolean;
-    result: { message_id: number };
-  };
-  return r.result.message_id;
+	const body: Record<string, unknown> = {
+		chat_id: getChatId(),
+		text,
+		parse_mode: parseMode,
+	};
+	if (replyMarkup) body.reply_markup = JSON.stringify(replyMarkup);
+	const r = (await telegramApi("sendMessage", body)) as {
+		ok: boolean;
+		result: { message_id: number };
+	};
+	return r.result.message_id;
 }
 
 // ── Polling ─────────────────────────────────────────────────────────
 
 export async function pollReply(
-  sentId: number,
-  chatId: string,
-  timeoutMs: number,
+	sentId: number,
+	chatId: string,
+	timeoutMs: number,
 ): Promise<string | null> {
-  const token = getToken();
-  const deadline = Date.now() + timeoutMs;
+	const token = getToken();
+	const deadline = Date.now() + timeoutMs;
 
-  // Drain pending updates to start fresh
-  let lastId = 0;
-  try {
-    const drain = await fetch(`${BASE_URL}${token}/getUpdates`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ timeout: 0 }),
-    });
-    if (drain.ok) {
-      const d = (await drain.json()) as {
-        ok: boolean;
-        result: Array<{ update_id: number }>;
-      };
-      if (d.ok && d.result.length > 0) {
-        lastId = d.result[d.result.length - 1].update_id;
-      }
-    }
-  } catch {
-    /* ignore drain errors */
-  }
+	// Drain pending updates to start fresh
+	let lastId = 0;
+	try {
+		const drain = await fetch(`${BASE_URL}${token}/getUpdates`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ timeout: 0 }),
+		});
+		if (drain.ok) {
+			const d = (await drain.json()) as {
+				ok: boolean;
+				result: Array<{ update_id: number }>;
+			};
+			if (d.ok && d.result.length > 0) {
+				lastId = d.result[d.result.length - 1].update_id;
+			}
+		}
+	} catch {
+		/* ignore drain errors */
+	}
 
-  while (Date.now() < deadline) {
-    const res = await fetch(
-      `${BASE_URL}${token}/getUpdates`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ offset: lastId + 1, timeout: 5 }),
-      },
-    );
-    if (!res.ok) {
-      await new Promise((r) => setTimeout(r, 3000));
-      continue;
-    }
-    const data = (await res.json()) as {
-      ok: boolean;
-      result: Array<{
-        update_id: number;
-        message?: {
-          message_id: number;
-          chat: { id: number };
-          text?: string;
-        };
-        callback_query?: {
-          id: string;
-          message: { message_id: number; chat: { id: number } };
-          data: string;
-        };
-      }>;
-    };
-    if (!data.ok) {
-      await new Promise((r) => setTimeout(r, 2000));
-      continue;
-    }
-    for (const u of data.result) {
-      lastId = u.update_id;
-      // Check for text reply
-      if (
-        u.message &&
-        u.message.chat.id === Number(chatId) &&
-        u.message.message_id > sentId &&
-        u.message.text
-      ) {
-        return u.message.text;
-      }
-      // Check for callback query (inline button)
-      if (
-        u.callback_query &&
-        u.callback_query.message.chat.id === Number(chatId)
-      ) {
-        await telegramApi("answerCallbackQuery", {
-          callback_query_id: u.callback_query.id,
-        });
-        return u.callback_query.data;
-      }
-    }
-    await new Promise((r) => setTimeout(r, 2000));
-  }
-  return null; // timeout
+	while (Date.now() < deadline) {
+		const res = await fetch(`${BASE_URL}${token}/getUpdates`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ offset: lastId + 1, timeout: 5 }),
+		});
+		if (!res.ok) {
+			await new Promise((r) => setTimeout(r, 3000));
+			continue;
+		}
+		const data = (await res.json()) as {
+			ok: boolean;
+			result: Array<{
+				update_id: number;
+				message?: {
+					message_id: number;
+					chat: { id: number };
+					text?: string;
+				};
+				callback_query?: {
+					id: string;
+					message: { message_id: number; chat: { id: number } };
+					data: string;
+				};
+			}>;
+		};
+		if (!data.ok) {
+			await new Promise((r) => setTimeout(r, 2000));
+			continue;
+		}
+		for (const u of data.result) {
+			lastId = u.update_id;
+			// Check for text reply
+			if (
+				u.message &&
+				u.message.chat.id === Number(chatId) &&
+				u.message.message_id > sentId &&
+				u.message.text
+			) {
+				return u.message.text;
+			}
+			// Check for callback query (inline button)
+			if (
+				u.callback_query &&
+				u.callback_query.message.chat.id === Number(chatId)
+			) {
+				await telegramApi("answerCallbackQuery", {
+					callback_query_id: u.callback_query.id,
+				});
+				return u.callback_query.data;
+			}
+		}
+		await new Promise((r) => setTimeout(r, 2000));
+	}
+	return null; // timeout
 }
 
 // ── Listener State ──────────────────────────────────────────────────
 
 export async function getBotId(): Promise<number | null> {
-  try {
-    const r = (await telegramApi("getMe", {})) as { result: { id: number } };
-    return r.result.id;
-  } catch {
-    return null;
-  }
+	try {
+		const r = (await telegramApi("getMe", {})) as { result: { id: number } };
+		return r.result.id;
+	} catch {
+		return null;
+	}
 }
 
 export async function seedLastUpdateId(
-  lastUpdateId: number,
-  signal?: AbortSignal,
+	lastUpdateId: number,
+	signal?: AbortSignal,
 ): Promise<number> {
-  if (lastUpdateId !== 0) return lastUpdateId;
-  const token = getToken();
-  try {
-    const res = await fetch(`${BASE_URL}${token}/getUpdates`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ timeout: 0 }),
-      signal,
-    });
-    if (res.ok) {
-      const d = (await res.json()) as {
-        ok: boolean;
-        result: Array<{ update_id: number }>;
-      };
-      if (d.ok && d.result.length > 0) {
-        return d.result[d.result.length - 1].update_id;
-      }
-    }
-  } catch {
-    /* ignore */
-  }
-  return lastUpdateId;
+	if (lastUpdateId !== 0) return lastUpdateId;
+	const token = getToken();
+	try {
+		const res = await fetch(`${BASE_URL}${token}/getUpdates`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ timeout: 0 }),
+			signal,
+		});
+		if (res.ok) {
+			const d = (await res.json()) as {
+				ok: boolean;
+				result: Array<{ update_id: number }>;
+			};
+			if (d.ok && d.result.length > 0) {
+				return d.result[d.result.length - 1].update_id;
+			}
+		}
+	} catch {
+		/* ignore */
+	}
+	return lastUpdateId;
 }
 
 export async function pollUpdates(
-  token: string,
-  chatId: string,
-  botId: number | null,
-  lastUpdateId: number,
-  signal: AbortSignal,
-  onMessage: (text: string) => void,
-  onUpdateId: (id: number) => void,
+	token: string,
+	chatId: string,
+	botId: number | null,
+	lastUpdateId: number,
+	signal: AbortSignal,
+	onMessage: (text: string) => void,
+	onUpdateId: (id: number) => void,
 ): Promise<void> {
-  while (!signal.aborted) {
-    try {
-      const res = await fetch(
-        `${BASE_URL}${token}/getUpdates`,
-        {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ offset: lastUpdateId + 1, timeout: 10 }),
-          signal,
-        },
-      );
-      if (!res.ok) {
-        await new Promise((r) => setTimeout(r, 3000));
-        continue;
-      }
-      const data = (await res.json()) as {
-        ok: boolean;
-        result: Array<{
-          update_id: number;
-          message?: {
-            message_id: number;
-            chat: { id: number };
-            from?: { id: number; is_bot?: boolean };
-            text?: string;
-          };
-          callback_query?: unknown;
-        }>;
-      };
-      if (!data.ok) {
-        await new Promise((r) => setTimeout(r, 2000));
-        continue;
-      }
-      for (const u of data.result) {
-        lastUpdateId = u.update_id;
-        onUpdateId(lastUpdateId);
-        // Skip callback queries (handled by telegram_ask)
-        if (u.callback_query) continue;
-        // Only process text messages from the configured chat, not from our bot
-        if (
-          u.message &&
-          u.message.text &&
-          String(u.message.chat.id) === chatId
-        ) {
-          if (u.message.from?.is_bot || u.message.from?.id === botId) {
-            continue;
-          }
-          onMessage(u.message.text);
-        }
-      }
-    } catch (e: unknown) {
-      if (e instanceof Error && e.name === "AbortError") break;
-      await new Promise((r) => setTimeout(r, 3000));
-    }
-    await new Promise((r) => setTimeout(r, 5000));
-  }
+	while (!signal.aborted) {
+		try {
+			const res = await fetch(`${BASE_URL}${token}/getUpdates`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ offset: lastUpdateId + 1, timeout: 10 }),
+				signal,
+			});
+			if (!res.ok) {
+				await new Promise((r) => setTimeout(r, 3000));
+				continue;
+			}
+			const data = (await res.json()) as {
+				ok: boolean;
+				result: Array<{
+					update_id: number;
+					message?: {
+						message_id: number;
+						chat: { id: number };
+						from?: { id: number; is_bot?: boolean };
+						text?: string;
+					};
+					callback_query?: unknown;
+				}>;
+			};
+			if (!data.ok) {
+				await new Promise((r) => setTimeout(r, 2000));
+				continue;
+			}
+			for (const u of data.result) {
+				lastUpdateId = u.update_id;
+				onUpdateId(lastUpdateId);
+				// Skip callback queries (handled by telegram_ask)
+				if (u.callback_query) continue;
+				// Only process text messages from the configured chat, not from our bot
+				if (
+					u.message &&
+					u.message.text &&
+					String(u.message.chat.id) === chatId
+				) {
+					if (u.message.from?.is_bot || u.message.from?.id === botId) {
+						continue;
+					}
+					onMessage(u.message.text);
+				}
+			}
+		} catch (e: unknown) {
+			if (e instanceof Error && e.name === "AbortError") break;
+			await new Promise((r) => setTimeout(r, 3000));
+		}
+		await new Promise((r) => setTimeout(r, 5000));
+	}
 }

package/src/index.ts

@@ -77,7 +77,11 @@ export default function telegramBridge(pi: ExtensionAPI) {
 			// onMessage: forward to pi as user message
 			async (text: string) => {
 				pi.sendUserMessage(text);
-				await sendMsg(`👂 Got it! Working on: _${text.slice(0, 100)}_`);
+				await sendMsg(
+					`👂 Got it! Working on: _${text.slice(0, 100)}_`,
+					undefined,
+					"Markdown",
+				);
 			},
 			// onUpdateId: persist offset
 			(id: number) => {
@@ -226,9 +230,13 @@ export default function telegramBridge(pi: ExtensionAPI) {
 				const opts = params.options ?? ["Yes", "No", "Explain"];
 				const kb = opts.map((o: string) => [{ text: o, callback_data: o }]);
 				const timeoutMs = (params.timeoutMinutes ?? 30) * 60000;
-				const mid = await sendMsg(`❓ *${params.question}*`, {
-					inline_keyboard: kb,
-				});
+				const mid = await sendMsg(
+					`❓ *${params.question}*`,
+					{
+						inline_keyboard: kb,
+					},
+					"Markdown",
+				);
 				const reply = await pollReply(mid, chatId, timeoutMs);
 				if (!reply) {
 					await sendMsg("⏰ No reply. Proceeding autonomously.");
@@ -296,7 +304,7 @@ export default function telegramBridge(pi: ExtensionAPI) {
 				message += `\n_What should I do?_`;
 
 				const kb = opts.map((o: string) => [{ text: o, callback_data: o }]);
-				const mid = await sendMsg(message, { inline_keyboard: kb });
+				const mid = await sendMsg(message, { inline_keyboard: kb }, "Markdown");
 				const reply = await pollReply(mid, chatId, timeoutMs);
 
 				if (!reply) {
@@ -328,7 +336,7 @@ export default function telegramBridge(pi: ExtensionAPI) {
 					action = "explain";
 				}
 
-				await sendMsg(`✅ Choice received: _${choice}_`);
+				await sendMsg(`✅ Choice received: _${choice}_`, undefined, "Markdown");
 
 				return {
 					content: [
@@ -381,7 +389,7 @@ export default function telegramBridge(pi: ExtensionAPI) {
 				const message = buildNotification(
 					params as unknown as import("./templates").NotifyInput,
 				);
-				const mid = await sendMsg(message);
+				const mid = await sendMsg(message, undefined, "HTML");
 				return {
 					content: [{ type: "text", text: `Notification sent (id:${mid})` }],
 					details: {},

package/src/templates.ts

@@ -2,33 +2,37 @@
  * pi-telegram-bridge — Rich Message Templates
  *
  * Well-designed notification templates for Telegram.
- * All use Telegram MarkdownV2 format (no tables, no triple backticks).
+ * Uses HTML parse mode for reliable formatting with special characters.
  * Supports: issue, PR, CI/CD, work progress, agent session, factory, alerts.
  */
 
 // ── Helpers ─────────────────────────────────────────────────────────
 
-const BAR = "━".repeat(30);
+const BAR = "━".repeat(20);
 
 function bold(s: string) {
-	return `*${s}*`;
+	return `<b>${s}</b>`;
 }
 function italic(s: string) {
-	return `_${s}_`;
+	return `<i>${s}</i>`;
 }
 function code(s: string) {
-	return `\`${s}\``;
+	return `<code>${s}</code>`;
 }
 function strike(s: string) {
-	return `~${s}~`;
+	return `<s>${s}</s>`;
 }
 function labelValue(label: string, value: string) {
 	return `${bold(label + ":")} ${value}`;
 }
+function link(url: string, text: string) {
+	return `<a href="${url}">${text}</a>`;
+}
 function progressBar(pct: number, width = 12) {
 	const filled = Math.round((pct / 100) * width);
-	return `${"█".repeat(filled)}${"░".repeat(width - filled)} ${pct}%`;
+	return `<code>${"█".repeat(filled)}${"░".repeat(width - filled)}</code> ${pct}%`;
 }
+
 // ── CI/CD Status Icons ─────────────────────────────────────────────
 
 function jobIcon(status: string): string {
@@ -51,7 +55,7 @@ export interface IssueCard {
 	number: number;
 	title: string;
 	state: "open" | "closed";
-	status?: string; // "in progress", "blocked", etc.
+	status?: string;
 	assignee?: string;
 	labels?: string[];
 	milestone?: string;
@@ -86,12 +90,14 @@ export function issueCard(i: IssueCard): string {
 	msg += labelValue("Repo", italic(`${i.repo.owner}/${i.repo.name}`)) + "\n";
 	msg += `${BAR}\n`;
 	if (i.branch) msg += labelValue("Branch", code(i.branch)) + "\n";
-	if (i.pr) {
+	if (i.pr && i.url) {
 		msg +=
-			labelValue("PR", `[#${i.pr.number}](${i.url ?? ""}) — ${i.pr.status}`) +
+			labelValue("PR", `${link(i.url, `#${i.pr.number}`)} — ${i.pr.status}`) +
 			"\n";
+	} else if (i.pr) {
+		msg += labelValue("PR", `#${i.pr.number} — ${i.pr.status}`) + "\n";
 	}
-	if (i.url) msg += `\n[View on GitHub](${i.url})`;
+	if (i.url) msg += `\n${link(i.url, "View on GitHub")}`;
 	return msg;
 }
 
@@ -137,7 +143,6 @@ export function prCard(pr: PRCard): string {
 	msg += labelValue("Author", code(pr.author)) + "\n";
 	msg += labelValue("Branch", `${code(pr.base)} ← ${code(pr.head)}`) + "\n";
 
-	// CI status
 	if (pr.ci) {
 		const icon = pr.ci.status
 			? jobIcon(pr.ci.status)
@@ -152,7 +157,6 @@ export function prCard(pr: PRCard): string {
 			) + "\n";
 	}
 
-	// Reviews
 	if (pr.reviews) {
 		const parts: string[] = [];
 		if (pr.reviews.approved > 0)
@@ -174,7 +178,7 @@ export function prCard(pr: PRCard): string {
 	if (pr.breaking) msg += labelValue("Breaking", "⚠️ Yes") + "\n";
 
 	msg += `${BAR}\n`;
-	if (pr.url) msg += `[View on GitHub](${pr.url})`;
+	if (pr.url) msg += link(pr.url, "View on GitHub");
 	return msg;
 }
 
@@ -184,8 +188,8 @@ export interface TaskProgress {
 	title: string;
 	emoji?: string;
 	status: "started" | "in-progress" | "paused" | "blocked" | "complete";
-	progress?: number; // 0–100
-	elapsed?: string; // "3m 22s"
+	progress?: number;
+	elapsed?: string;
 	eta?: string;
 	details?: string[];
 	metrics?: Record<string, string>;
@@ -234,7 +238,7 @@ export interface CIPipeline {
 	workflow: string;
 	runNumber: number;
 	branch: string;
-	event: string; // "push", "pull_request"
+	event: string;
 	jobs: Array<{ name: string; status: string; duration?: string }>;
 	triggeredBy?: string;
 	url?: string;
@@ -254,7 +258,7 @@ export function ciPipeline(p: CIPipeline): string {
 		msg += `${jobIcon(j.status)} ${code(j.name)}${dur}\n`;
 	}
 
-	if (p.url) msg += `\n[View Pipeline](${p.url})`;
+	if (p.url) msg += `\n${link(p.url, "View Pipeline")}`;
 	return msg;
 }
 
@@ -389,7 +393,7 @@ export function ack(text: string, emoji = "✅"): string {
 	return `${emoji} ${italic(text)}`;
 }
 
-// ── Decision Card (for override/approval context) ───────────────────
+// ── Decision Card ───────────────────────────────────────────────────
 
 export interface DecisionCard {
 	question: string;
@@ -415,7 +419,7 @@ export function decisionCard(d: DecisionCard): string {
 	if (d.command) msg += labelValue("Command", code(d.command)) + "\n";
 	if (d.reason) msg += labelValue("Reason", d.reason) + "\n";
 	msg += `\n${bold("❓ " + d.question)}\n`;
-	msg += `\n${d.options.map((o, i) => `${i + 1}\\. ${o}`).join("\n")}`;
+	msg += `\n${d.options.map((o, i) => `${i + 1}. ${o}`).join("\n")}`;
 	return msg;
 }
 
@@ -483,14 +487,14 @@ export function diffSummary(d: DiffSummary): string {
 			msg += `  • ${h}\n`;
 		}
 	}
-	if (d.url) msg += `\n[View Diff](${d.url})`;
+	if (d.url) msg += `\n${link(d.url, "View Diff")}`;
 	return msg;
 }
 
 // ── Quick Pickers (for telegram_ask buttons) ────────────────────────
 
 export function quickActions(label: string, actions: string[]): string {
-	return `${bold(label)}\n${actions.map((a, i) => `${i + 1}\\. ${code(a)}`).join("  \n")}`;
+	return `${bold(label)}\n${actions.map((a, i) => `${i + 1}. ${code(a)}`).join("  \n")}`;
 }
 
 export function yesNoExplain(prompt: string): string {
@@ -499,7 +503,6 @@ export function yesNoExplain(prompt: string): string {
 
 // ── Build Notification (main dispatch for telegram_notify tool) ────
 
-// Flattened input from the tool; only the relevant subset is used per kind.
 export interface NotifyInput {
 	kind:
 		| "issue"
@@ -513,7 +516,6 @@ export interface NotifyInput {
 		| "diff"
 		| "decision"
 		| "ack";
-	// issue
 	issueNumber?: number;
 	issueTitle?: string;
 	issueState?: "open" | "closed";
@@ -527,7 +529,6 @@ export interface NotifyInput {
 	issuePRNumber?: number;
 	issuePRStatus?: string;
 	issueUrl?: string;
-	// pr
 	prNumber?: number;
 	prTitle?: string;
 	prState?: "open" | "closed" | "merged" | "draft";
@@ -549,7 +550,6 @@ export interface NotifyInput {
 	prBreaking?: boolean;
 	prDraft?: boolean;
 	prUrl?: string;
-	// task
 	taskTitle?: string;
 	taskEmoji?: string;
 	taskStatus?: "started" | "in-progress" | "paused" | "blocked" | "complete";
@@ -558,7 +558,6 @@ export interface NotifyInput {
 	taskEta?: string;
 	taskDetails?: string[];
 	taskMetrics?: Record<string, string>;
-	// pipeline
 	pipelineWorkflow?: string;
 	pipelineRunNumber?: number;
 	pipelineBranch?: string;
@@ -566,7 +565,6 @@ export interface NotifyInput {
 	pipelineJobs?: Array<{ name: string; status: string; duration?: string }>;
 	pipelineTriggeredBy?: string;
 	pipelineUrl?: string;
-	// session
 	sessionName?: string;
 	sessionBranch?: string;
 	sessionModel?: string;
@@ -575,14 +573,12 @@ export interface NotifyInput {
 	sessionTokensTotal?: number;
 	sessionDuration?: string;
 	sessionStatus?: "idle" | "streaming" | "tool-exec" | "waiting";
-	// alert
 	alertLevel?: "info" | "warning" | "error" | "critical";
 	alertTitle?: string;
 	alertSource?: string;
 	alertDetail?: string;
 	alertAction?: string;
 	alertStack?: string;
-	// factory-job
 	jobId?: string;
 	jobMode?: "single" | "chain" | "parallel";
 	jobStatus?: "pending" | "running" | "success" | "failure" | "cancelled";
@@ -591,28 +587,24 @@ export interface NotifyInput {
 	jobEnvironment?: string;
 	jobDuration?: string;
 	jobWorker?: string;
-	// standup
 	standupDate?: string;
 	standupAgent?: string;
 	standupWorkedOn?: string[];
 	standupNextUp?: string[];
 	standupBlockers?: string[];
 	standupMetrics?: Record<string, string>;
-	// diff
 	diffTitle?: string;
 	diffAdded?: number;
 	diffRemoved?: number;
 	diffFiles?: number;
 	diffHighlights?: string[];
 	diffUrl?: string;
-	// decision
 	decisionQuestion?: string;
 	decisionContext?: string;
 	decisionOptions?: string[];
 	decisionRisk?: "low" | "medium" | "high" | "critical";
 	decisionCommand?: string;
 	decisionReason?: string;
-	// ack
 	ackText?: string;
 	ackEmoji?: string;
 }