@hienlh/ppm 0.9.39 → 0.9.41

package/src/services/ppmbot/ppmbot-telegram.ts

@@ -1,279 +0,0 @@
-import type {
-  TelegramUpdate,
-  TelegramMessage,
-  TelegramSentMessage,
-  PPMBotCommand,
-} from "../../types/ppmbot.ts";
-
-const TELEGRAM_API = "https://api.telegram.org/bot";
-const POLL_TIMEOUT = 25;
-const MIN_EDIT_INTERVAL = 1000;
-const BOT_TOKEN_RE = /^\d+:[A-Za-z0-9_-]{30,50}$/;
-
-/** Known PPMBot slash commands */
-const COMMANDS = new Set([
-  "start", "project", "new", "sessions", "resume",
-  "status", "stop", "memory", "forget", "remember", "help",
-]);
-
-export type UpdateHandler = (update: TelegramUpdate) => Promise<void>;
-
-export class PPMBotTelegram {
-  private token: string;
-  private offset = 0;
-  private running = false;
-  private abortController: AbortController | null = null;
-  private retryCount = 0;
-
-  /** Track last edit time per chatId:messageId to throttle */
-  private lastEditTime = new Map<string, number>();
-
-  constructor(token: string) {
-    if (!BOT_TOKEN_RE.test(token)) {
-      throw new Error("Invalid Telegram bot token format");
-    }
-    this.token = token;
-  }
-
-  // ── Polling ─────────────────────────────────────────────────────
-
-  /** Register bot commands with Telegram so they show in the menu */
-  async registerCommands(): Promise<void> {
-    try {
-      await this.callApi("setMyCommands", {
-        commands: [
-          { command: "start", description: "Greeting + list projects" },
-          { command: "project", description: "Switch project" },
-          { command: "new", description: "Fresh session (current project)" },
-          { command: "sessions", description: "List recent sessions" },
-          { command: "resume", description: "Resume a previous session" },
-          { command: "status", description: "Current project/session info" },
-          { command: "stop", description: "End current session" },
-          { command: "memory", description: "Show project memories" },
-          { command: "forget", description: "Remove matching memories" },
-          { command: "remember", description: "Save a fact" },
-          { command: "help", description: "Show all commands" },
-        ],
-      });
-      console.log("[ppmbot] Commands registered");
-    } catch (err) {
-      console.warn("[ppmbot] Failed to register commands:", (err as Error).message);
-    }
-  }
-
-  /** Start long-polling loop. Calls handler for each update. */
-  async startPolling(handler: UpdateHandler): Promise<void> {
-    if (this.running) return;
-    this.running = true;
-    this.retryCount = 0;
-
-    // Register commands on startup
-    await this.registerCommands();
-
-    console.log("[ppmbot] Polling started");
-
-    while (this.running) {
-      try {
-        const updates = await this.getUpdates();
-        this.retryCount = 0;
-
-        for (const update of updates) {
-          this.offset = update.update_id + 1;
-          // Fire-and-forget: don't block polling on handler execution
-          // Per-chatId serialization is handled by processing lock in service
-          handler(update).catch((err) => {
-            console.error("[ppmbot] Handler error:", (err as Error).message);
-          });
-        }
-      } catch (err) {
-        if (!this.running) break;
-        this.retryCount++;
-        const delay = Math.min(1000 * 2 ** this.retryCount, 30_000);
-        console.error(
-          `[ppmbot] Poll error (retry ${this.retryCount}): ${(err as Error).message}. Retrying in ${delay}ms`,
-        );
-        await Bun.sleep(delay);
-      }
-    }
-
-    console.log("[ppmbot] Polling stopped");
-  }
-
-  /** Stop polling gracefully */
-  stop(): void {
-    this.running = false;
-    this.abortController?.abort();
-    this.lastEditTime.clear();
-  }
-
-  get isRunning(): boolean {
-    return this.running;
-  }
-
-  // ── Telegram API Methods ────────────────────────────────────────
-
-  /** Fetch updates via long-polling */
-  private async getUpdates(): Promise<TelegramUpdate[]> {
-    this.abortController = new AbortController();
-    const fetchTimeout = setTimeout(
-      () => this.abortController?.abort(),
-      (POLL_TIMEOUT + 10) * 1000,
-    );
-
-    try {
-      const res = await fetch(`${TELEGRAM_API}${this.token}/getUpdates`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          offset: this.offset,
-          timeout: POLL_TIMEOUT,
-          allowed_updates: ["message"],
-        }),
-        signal: this.abortController.signal,
-      });
-
-      const json = (await res.json()) as { ok: boolean; result?: TelegramUpdate[] };
-      if (!json.ok || !json.result) return [];
-      return json.result;
-    } finally {
-      clearTimeout(fetchTimeout);
-      this.abortController = null;
-    }
-  }
-
-  /** Send a text message */
-  async sendMessage(
-    chatId: number | string,
-    text: string,
-    parseMode: "HTML" | "Markdown" = "HTML",
-  ): Promise<TelegramSentMessage | null> {
-    try {
-      const res = await this.callApi("sendMessage", {
-        chat_id: chatId,
-        text,
-        parse_mode: parseMode,
-        disable_web_page_preview: true,
-      });
-      const json = (await res.json()) as { ok: boolean; result?: TelegramSentMessage; description?: string };
-      if (!json.ok) {
-        console.error(`[ppmbot] sendMessage failed: ${json.description}`);
-        return null;
-      }
-      return json.result ?? null;
-    } catch (err) {
-      console.error(`[ppmbot] sendMessage error: ${(err as Error).message}`);
-      return null;
-    }
-  }
-
-  /** Edit an existing message text (throttled at 1s intervals) */
-  async editMessage(
-    chatId: number | string,
-    messageId: number,
-    text: string,
-    parseMode: "HTML" | "Markdown" = "HTML",
-  ): Promise<boolean> {
-    const key = `${chatId}:${messageId}`;
-    const now = Date.now();
-    const lastEdit = this.lastEditTime.get(key) ?? 0;
-    if (now - lastEdit < MIN_EDIT_INTERVAL) return false;
-
-    this.lastEditTime.set(key, now);
-
-    try {
-      const res = await this.callApi("editMessageText", {
-        chat_id: chatId,
-        message_id: messageId,
-        text,
-        parse_mode: parseMode,
-        disable_web_page_preview: true,
-      });
-      const json = (await res.json()) as { ok: boolean; description?: string };
-      if (!json.ok) {
-        if (json.description?.includes("not modified")) return true;
-        console.error(`[ppmbot] editMessage failed: ${json.description}`);
-        return false;
-      }
-      return true;
-    } catch (err) {
-      console.error(`[ppmbot] editMessage error: ${(err as Error).message}`);
-      return false;
-    }
-  }
-
-  /** Force-edit (bypass throttle) — used for final message */
-  async editMessageFinal(
-    chatId: number | string,
-    messageId: number,
-    text: string,
-    parseMode: "HTML" | "Markdown" = "HTML",
-  ): Promise<boolean> {
-    const key = `${chatId}:${messageId}`;
-    this.lastEditTime.delete(key);
-    return this.editMessage(chatId, messageId, text, parseMode);
-  }
-
-  /** Send "typing" chat action */
-  async sendTyping(chatId: number | string): Promise<void> {
-    try {
-      await this.callApi("sendChatAction", {
-        chat_id: chatId,
-        action: "typing",
-      });
-    } catch {
-      // Best-effort, ignore errors
-    }
-  }
-
-  /** Delete a message */
-  async deleteMessage(chatId: number | string, messageId: number): Promise<void> {
-    try {
-      await this.callApi("deleteMessage", {
-        chat_id: chatId,
-        message_id: messageId,
-      });
-    } catch {
-      // Best-effort
-    }
-  }
-
-  // ── Command Parsing ─────────────────────────────────────────────
-
-  /** Parse a Telegram message into a PPMBotCommand if it starts with / */
-  static parseCommand(message: TelegramMessage): PPMBotCommand | null {
-    const text = message.text ?? message.caption ?? "";
-    if (!text.startsWith("/")) return null;
-
-    const match = text.match(/^\/(\w+)(?:@\S+)?\s*(.*)/s);
-    if (!match) return null;
-
-    const command = match[1]!.toLowerCase();
-    if (!COMMANDS.has(command)) return null;
-
-    return {
-      command,
-      args: match[2]?.trim() ?? "",
-      chatId: message.chat.id,
-      messageId: message.message_id,
-      userId: message.from?.id ?? 0,
-      username: message.from?.username,
-    };
-  }
-
-  // ── Private Helpers ─────────────────────────────────────────────
-
-  private async callApi(method: string, body: Record<string, unknown>): Promise<Response> {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 10_000);
-    try {
-      return await fetch(`${TELEGRAM_API}${this.token}/${method}`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-        signal: controller.signal,
-      });
-    } finally {
-      clearTimeout(timeout);
-    }
-  }
-}

package/src/types/ppmbot.ts

@@ -1,103 +0,0 @@
-/** Telegram update object (subset we care about) */
-export interface TelegramUpdate {
-  update_id: number;
-  message?: TelegramMessage;
-  edited_message?: TelegramMessage;
-}
-
-export interface TelegramMessage {
-  message_id: number;
-  from?: { id: number; first_name: string; username?: string };
-  chat: { id: number; type: "private" | "group" | "supergroup" };
-  date: number;
-  text?: string;
-  caption?: string;
-}
-
-/** Sent message result from Telegram API */
-export interface TelegramSentMessage {
-  message_id: number;
-  chat: { id: number };
-  date: number;
-}
-
-/** PPMBot session row from SQLite */
-export interface PPMBotSessionRow {
-  id: number;
-  telegram_chat_id: string;
-  session_id: string;
-  provider_id: string;
-  project_name: string;
-  project_path: string;
-  is_active: number;
-  created_at: number;
-  last_message_at: number;
-}
-
-/** PPMBot memory row from SQLite */
-export interface PPMBotMemoryRow {
-  id: number;
-  project: string;
-  content: string;
-  category: PPMBotMemoryCategory;
-  importance: number;
-  created_at: number;
-  updated_at: number;
-  session_id: string | null;
-  superseded_by: number | null;
-}
-
-export type PPMBotMemoryCategory =
-  | "fact"
-  | "decision"
-  | "preference"
-  | "architecture"
-  | "issue";
-
-/** Active session state tracked in memory (not DB) */
-export interface PPMBotActiveSession {
-  telegramChatId: string;
-  sessionId: string;
-  providerId: string;
-  projectName: string;
-  projectPath: string;
-  /** Telegram message ID being edited for streaming */
-  currentMessageId?: number;
-  /** Debounce timer for rapid messages */
-  debounceTimer?: ReturnType<typeof setTimeout>;
-  /** Accumulated debounced text */
-  debouncedText?: string;
-}
-
-/** Parsed command from Telegram message */
-export interface PPMBotCommand {
-  command: string;
-  args: string;
-  chatId: number;
-  messageId: number;
-  userId: number;
-  username?: string;
-}
-
-/** Memory recall result with relevance score */
-export interface MemoryRecallResult {
-  id: number;
-  content: string;
-  category: PPMBotMemoryCategory;
-  importance: number;
-  project: string;
-  /** FTS5 rank score (lower = more relevant) */
-  rank?: number;
-}
-
-/** Paired chat row from SQLite */
-export interface PPMBotPairedChat {
-  id: number;
-  telegram_chat_id: string;
-  telegram_user_id: string | null;
-  display_name: string | null;
-  pairing_code: string | null;
-  status: "pending" | "approved" | "revoked";
-  created_at: number;
-  approved_at: number | null;
-}

package/src/web/components/settings/ppmbot-settings-section.tsx

@@ -1,270 +0,0 @@
-import { useState, useEffect, useCallback, type ChangeEvent } from "react";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
-import { api } from "@/lib/api-client";
-import { Trash2, CheckCircle, Clock } from "lucide-react";
-
-interface PPMBotConfig {
-  enabled: boolean;
-  default_provider: string;
-  default_project: string;
-  system_prompt: string;
-  show_tool_calls: boolean;
-  show_thinking: boolean;
-  permission_mode: string;
-  debounce_ms: number;
-}
-
-interface PairedChat {
-  id: number;
-  telegram_chat_id: string;
-  telegram_user_id: string | null;
-  display_name: string | null;
-  pairing_code: string | null;
-  status: "pending" | "approved";
-  created_at: number;
-  approved_at: number | null;
-}
-
-export function PPMBotSettingsSection() {
-  const [config, setConfig] = useState<PPMBotConfig | null>(null);
-  const [saving, setSaving] = useState(false);
-  const [status, setStatus] = useState<{ type: "ok" | "err"; msg: string } | null>(null);
-
-  const [enabled, setEnabled] = useState(false);
-  const [defaultProject, setDefaultProject] = useState("");
-  const [systemPrompt, setSystemPrompt] = useState("");
-  const [showToolCalls, setShowToolCalls] = useState(true);
-  const [showThinking, setShowThinking] = useState(false);
-  const [debounceMs, setDebounceMs] = useState(2000);
-
-  const [pairedChats, setPairedChats] = useState<PairedChat[]>([]);
-  const [approveCode, setApproveCode] = useState("");
-  const [approving, setApproving] = useState(false);
-
-  const fetchPairedChats = useCallback(async () => {
-    try {
-      const data = await api.get<PairedChat[]>("/api/settings/clawbot/paired");
-      setPairedChats(data);
-    } catch {}
-  }, []);
-
-  useEffect(() => {
-    api.get<PPMBotConfig>("/api/settings/clawbot").then((data) => {
-      setConfig(data);
-      setEnabled(data.enabled);
-      setDefaultProject(data.default_project);
-      setSystemPrompt(data.system_prompt);
-      setShowToolCalls(data.show_tool_calls);
-      setShowThinking(data.show_thinking);
-      setDebounceMs(data.debounce_ms);
-    }).catch(() => {});
-    fetchPairedChats();
-  }, [fetchPairedChats]);
-
-  const save = async () => {
-    setSaving(true);
-    setStatus(null);
-    try {
-      const body: Partial<PPMBotConfig> = {
-        enabled,
-        default_project: defaultProject.trim(),
-        system_prompt: systemPrompt,
-        show_tool_calls: showToolCalls,
-        show_thinking: showThinking,
-        debounce_ms: debounceMs,
-      };
-      const data = await api.put<PPMBotConfig>("/api/settings/clawbot", body);
-      setConfig(data);
-      setStatus({ type: "ok", msg: enabled ? "Saved — bot started" : "Saved — bot stopped" });
-    } catch (e) {
-      setStatus({ type: "err", msg: (e as Error).message });
-    } finally {
-      setSaving(false);
-    }
-  };
-
-  const handleApprovePairing = async () => {
-    if (!approveCode.trim()) return;
-    setApproving(true);
-    try {
-      await api.post("/api/settings/clawbot/paired/approve", { code: approveCode.trim().toUpperCase() });
-      setApproveCode("");
-      await fetchPairedChats();
-      setStatus({ type: "ok", msg: "Device approved" });
-    } catch (e) {
-      setStatus({ type: "err", msg: (e as Error).message });
-    } finally {
-      setApproving(false);
-    }
-  };
-
-  const handleRevokePairing = async (chatId: string) => {
-    try {
-      await api.del(`/api/settings/clawbot/paired/${chatId}`);
-      await fetchPairedChats();
-      setStatus({ type: "ok", msg: "Device revoked" });
-    } catch (e) {
-      setStatus({ type: "err", msg: (e as Error).message });
-    }
-  };
-
-  if (!config) return <p className="text-xs text-muted-foreground">Loading...</p>;
-
-  return (
-    <div className="space-y-4">
-      {/* Enable/Disable */}
-      <div className="flex items-center justify-between">
-        <div>
-          <p className="text-xs font-medium">Enable PPMBot</p>
-          <p className="text-[10px] text-muted-foreground">
-            Telegram bot that chats with your AI providers
-          </p>
-        </div>
-        <Switch checked={enabled} onCheckedChange={setEnabled} />
-      </div>
-
-      {/* Paired Devices */}
-      <div className="space-y-2">
-        <p className="text-xs font-medium">Paired Devices</p>
-        <p className="text-[10px] text-muted-foreground">
-          Send any message to the bot on Telegram to get a pairing code. Enter it below to approve.
-        </p>
-
-        <div className="flex gap-2">
-          <Input
-            placeholder="Enter pairing code (e.g. A3K7WR)"
-            value={approveCode}
-            onChange={(e) => setApproveCode(e.target.value.toUpperCase())}
-            className="h-8 text-xs font-mono tracking-wider uppercase"
-            maxLength={6}
-          />
-          <Button
-            variant="outline"
-            size="sm"
-            className="h-8 text-xs shrink-0 cursor-pointer"
-            disabled={approving || approveCode.length < 6}
-            onClick={handleApprovePairing}
-          >
-            {approving ? "..." : "Approve"}
-          </Button>
-        </div>
-
-        {pairedChats.length === 0 ? (
-          <p className="text-[10px] text-muted-foreground italic">No paired devices yet.</p>
-        ) : (
-          <div className="space-y-1">
-            {pairedChats.map((chat) => (
-              <div
-                key={chat.id}
-                className="flex items-center justify-between rounded-md border p-2"
-              >
-                <div className="flex items-center gap-2 min-w-0">
-                  {chat.status === "approved" ? (
-                    <CheckCircle className="size-3.5 text-green-500 shrink-0" />
-                  ) : (
-                    <Clock className="size-3.5 text-yellow-500 shrink-0" />
-                  )}
-                  <div className="min-w-0">
-                    <p className="text-xs truncate">
-                      {chat.display_name || `Chat ${chat.telegram_chat_id}`}
-                    </p>
-                    <p className="text-[10px] text-muted-foreground">
-                      {chat.status === "pending" && chat.pairing_code
-                        ? `Code: ${chat.pairing_code}`
-                        : chat.status}
-                    </p>
-                  </div>
-                </div>
-                <Button
-                  variant="ghost"
-                  size="sm"
-                  className="h-7 w-7 p-0 text-destructive hover:text-destructive cursor-pointer"
-                  onClick={() => handleRevokePairing(chat.telegram_chat_id)}
-                >
-                  <Trash2 className="size-3.5" />
-                </Button>
-              </div>
-            ))}
-          </div>
-        )}
-      </div>
-
-      {/* Default Project */}
-      <div className="space-y-1.5">
-        <label className="text-[11px] text-muted-foreground">Default Project</label>
-        <Input
-          placeholder="my-project"
-          value={defaultProject}
-          onChange={(e) => setDefaultProject(e.target.value)}
-          className="h-7 text-xs"
-        />
-        <p className="text-[10px] text-muted-foreground">
-          Project used when starting a new chat. Must match a project name in PPM.
-        </p>
-      </div>
-
-      {/* System Prompt */}
-      <div className="space-y-1.5">
-        <label className="text-[11px] text-muted-foreground">System Prompt</label>
-        <textarea
-          placeholder="You are a helpful assistant..."
-          value={systemPrompt}
-          onChange={(e: ChangeEvent<HTMLTextAreaElement>) => setSystemPrompt(e.target.value)}
-          className="flex w-full rounded-md border border-input bg-background px-3 py-2 text-xs min-h-[60px] resize-y ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
-          rows={3}
-        />
-        <p className="text-[10px] text-muted-foreground">
-          Custom personality/instructions prepended to each session.
-        </p>
-      </div>
-
-      {/* Display Toggles */}
-      <div className="space-y-2">
-        <div className="flex items-center justify-between">
-          <p className="text-xs">Show tool calls</p>
-          <Switch checked={showToolCalls} onCheckedChange={setShowToolCalls} />
-        </div>
-        <div className="flex items-center justify-between">
-          <p className="text-xs">Show thinking</p>
-          <Switch checked={showThinking} onCheckedChange={setShowThinking} />
-        </div>
-      </div>
-
-      {/* Debounce */}
-      <div className="space-y-1.5">
-        <label className="text-[11px] text-muted-foreground">Debounce (ms)</label>
-        <Input
-          type="number"
-          min={0}
-          max={30000}
-          step={500}
-          value={debounceMs}
-          onChange={(e) => setDebounceMs(Number(e.target.value))}
-          className="h-7 text-xs w-24"
-        />
-        <p className="text-[10px] text-muted-foreground">
-          Merge rapid messages within this window. 0 = no debounce.
-        </p>
-      </div>
-
-      {/* Save */}
-      <Button
-        variant="default"
-        size="sm"
-        className="h-8 text-xs w-full cursor-pointer"
-        disabled={saving}
-        onClick={save}
-      >
-        {saving ? "Saving..." : "Save"}
-      </Button>
-
-      {status && (
-        <p className={`text-[11px] ${status.type === "ok" ? "text-green-600 dark:text-green-400" : "text-destructive"}`}>
-          {status.msg}
-        </p>
-      )}
-    </div>
-  );
-}