@inetafrica/open-claudia 2.2.17 → 2.2.19

package/.env.example

@@ -16,6 +16,8 @@ KAZEE_DEBUG_EVENTS=
 
 WORKSPACE=/path/to/your/workspace
 CLAUDE_PATH=/path/to/claude
+# Default Claude Code model when users haven't selected one with /model.
+CLAUDE_MODEL=claude-opus-4-8
 CURSOR_PATH=
 CODEX_PATH=
 AUTO_COMPACT_TOKENS=280000

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v2.2.19
+- Add Claude Opus 4.8 (`claude-opus-4-8`) to the Claude model picker and make it the default Claude Code model used when no per-user model override is selected. The default can still be overridden with `CLAUDE_MODEL`, now documented in `.env.example`.
+
+## v2.2.18
+- Fix the legacy Telegram send/edit path so replies default to Telegram HTML parse mode and go through the shared formatter, preventing raw `<b>`, `<a>`, and related tags from leaking in chat.
+- Preserve safe Telegram HTML tags before Markdown conversion, so underscores inside link URLs such as Higgsfield `wan2_2_video` are not misread as italics and do not break rendered links.
+
 ## v2.2.17
 - Telegram output now uses `parse_mode: "HTML"` instead of legacy Markdown. The Telegram adapter normalizes both model-authored Telegram HTML and ordinary Markdown/CommonMark into Telegram's safe HTML subset before sending, so `<b>...</b>`, `**bold**`, backticks, links, headings, code blocks, strikethrough, and spoilers render cleanly instead of leaking literal markup or being rejected by Telegram. Messages still fall back to plain text if Telegram rejects the markup.
 - Updated the Telegram system prompt to ask agents for short mobile-readable Telegram HTML (`<b>`, `<code>`, `<pre>`, `<a>`) with bullet-style layout. Relay sends and slash-command responses now use the same HTML parse mode as normal assistant replies.

package/bot-agent.js

@@ -6,6 +6,7 @@ const https = require("https");
 const cron = require("node-cron");
 const Vault = require("./vault");
 const CONFIG_DIR = require("./config-dir");
+const { telegramHtml } = require("./channels/telegram/format");
 
 // ── Graceful shutdown & error handling ─────────────────────────────
 process.on("SIGINT", () => process.exit(0));
@@ -77,6 +78,7 @@ const CHAT_ID = CHAT_IDS[0]; // Primary owner chat for crons/notifications
 const WORKSPACE = config.WORKSPACE;
 const CLAUDE_PATH = config.CLAUDE_PATH;
 const CURSOR_PATH = config.CURSOR_PATH || null;
+const DEFAULT_CLAUDE_MODEL = config.CLAUDE_MODEL || process.env.CLAUDE_MODEL || "claude-opus-4-8";
 
 // Resolve Cursor Agent CLI (optional)
 let resolvedCursorPath = CURSOR_PATH;
@@ -653,14 +655,17 @@ function projectKeyboard() {
 }
 
 async function send(text, opts = {}) {
+  const parseMode = opts.parseMode || "HTML";
+  const body = parseMode === "HTML" ? telegramHtml(text) : text;
+  const fallbackBody = String(text ?? "");
   const o = {};
-  if (opts.parseMode) o.parse_mode = opts.parseMode;
+  if (parseMode) o.parse_mode = parseMode;
   if (opts.keyboard) o.reply_markup = opts.keyboard;
   if (opts.replyTo) o.reply_to_message_id = opts.replyTo;
 
   for (let attempt = 0; attempt < 3; attempt++) {
     try {
-      const msg = await bot.sendMessage(CHAT_ID, text, o);
+      const msg = await bot.sendMessage(CHAT_ID, body, o);
       return msg.message_id;
     } catch (e) {
       const errMsg = e.message || "";
@@ -680,10 +685,17 @@ async function send(text, opts = {}) {
         continue;
       }
 
-      // Parse mode failed — retry without it
-      if (opts.parseMode && o.parse_mode) {
+      // Parse mode failed — retry once as plain text, but do not leak raw HTML tags.
+      if (parseMode && o.parse_mode) {
+        console.error("Send parse-mode failed, retrying plain text:", errMsg);
         delete o.parse_mode;
-        continue;
+        try {
+          const msg = await bot.sendMessage(CHAT_ID, fallbackBody, o);
+          return msg.message_id;
+        } catch (plainErr) {
+          console.error("Send plain-text fallback error:", plainErr.message || plainErr);
+          return null;
+        }
       }
 
       console.error("Send error:", errMsg);
@@ -695,16 +707,28 @@ async function send(text, opts = {}) {
 }
 
 async function editMessage(messageId, text, opts = {}) {
+  const parseMode = opts.parseMode || "HTML";
+  const body = parseMode === "HTML" ? telegramHtml(text) : text;
+  const fallbackBody = String(text ?? "");
   try {
     const o = { chat_id: CHAT_ID, message_id: messageId };
+    if (parseMode) o.parse_mode = parseMode;
     if (opts.keyboard) o.reply_markup = opts.keyboard;
-    await bot.editMessageText(text, o);
+    await bot.editMessageText(body, o);
   } catch (e) {
     const errMsg = e.message || "";
     // Rate limited — skip this update (next interval will catch up)
     if (errMsg.includes("retry after")) return;
     // Message unchanged — ignore
     if (errMsg.includes("message is not modified")) return;
+    if (parseMode) {
+      try {
+        const fallback = { chat_id: CHAT_ID, message_id: messageId };
+        if (opts.keyboard) fallback.reply_markup = opts.keyboard;
+        await bot.editMessageText(fallbackBody, fallback);
+        return;
+      } catch (e2) {}
+    }
     // Log anything unexpected
     if (!errMsg.includes("message to edit not found")) {
       console.error("Edit error:", errMsg);
@@ -1125,7 +1149,7 @@ function buildClaudeArgs(prompt, opts = {}) {
     "--append-system-prompt", buildSystemPrompt()];
   if (opts.continueSession) args.push("--continue");
   else if (lastSessionId && !opts.fresh) args.push("--resume", lastSessionId);
-  if (settings.model) args.push("--model", settings.model);
+  args.push("--model", settings.model || DEFAULT_CLAUDE_MODEL);
   if (settings.effort) args.push("--effort", settings.effort);
   if (settings.budget) args.push("--max-budget-usd", String(settings.budget));
   if (settings.permissionMode) args.push("--permission-mode", settings.permissionMode);
@@ -1172,7 +1196,7 @@ async function runClaudeChat(prompt, cwd, replyToMsgId) {
   const args = ["-p", "--verbose", "--output-format", "stream-json",
     "--append-system-prompt", buildSystemPrompt(),
     "--dangerously-skip-permissions"];
-  if (settings.model) args.push("--model", settings.model);
+  args.push("--model", settings.model || DEFAULT_CLAUDE_MODEL);
   args.push(contextPrompt);
 
   const proc = spawn(CLAUDE_PATH, args, {
@@ -1637,7 +1661,8 @@ bot.onText(/\/model$/, (msg) => {
     [{ text: "GPT-5.4", callback_data: "m:gpt-5.4-medium" }, { text: "GPT-5.4 High", callback_data: "m:gpt-5.4-high" }],
     [{ text: "Auto", callback_data: "m:auto" }, { text: "Default", callback_data: "m:default" }],
   ] : [
-    [{ text: "Opus", callback_data: "m:opus" }, { text: "Sonnet", callback_data: "m:sonnet" }, { text: "Haiku", callback_data: "m:haiku" }],
+    [{ text: "Opus 4.8", callback_data: "m:claude-opus-4-8" }, { text: "Opus 4.7", callback_data: "m:claude-opus-4-7" }],
+    [{ text: "Sonnet", callback_data: "m:sonnet" }, { text: "Haiku", callback_data: "m:haiku" }],
     [{ text: "Default", callback_data: "m:default" }],
   ];
   const label = settings.backend === "cursor" ? "Cursor Agent" : "Claude Code";

package/channels/telegram/format.js

@@ -39,29 +39,33 @@ function stashCode(text) {
   return { text: out, blocks };
 }
 
-function restoreAllowedHtmlTags(text) {
+function stashAllowedHtmlTags(text) {
+  const tags = [];
+  const stash = (html) => {
+    const token = `\u0000OCTGHTML${tags.length}\u0000`;
+    tags.push(html);
+    return token;
+  };
   let out = text;
 
-  // Allow model-authored Telegram HTML tags after escaping the rest of the text.
+  // Hide model-authored Telegram HTML tags from Markdown conversion. This keeps
+  // underscores in hrefs such as wan2_2_video from becoming bogus <i> tags.
   for (const tag of ["b", "strong", "i", "em", "u", "s", "strike", "del", "code", "pre", "blockquote"]) {
     const open = new RegExp(`&lt;${tag}&gt;`, "gi");
     const close = new RegExp(`&lt;/${tag}&gt;`, "gi");
-    out = out.replace(open, `<${tag}>`).replace(close, `</${tag}>`);
+    out = out.replace(open, () => stash(`<${tag}>`)).replace(close, () => stash(`</${tag}>`));
   }
 
-  // Telegram spoiler HTML.
   out = out
-    .replace(/&lt;span class="tg-spoiler"&gt;/gi, '<span class="tg-spoiler">')
-    .replace(/&lt;\/span&gt;/gi, "</span>");
+    .replace(/&lt;span class="tg-spoiler"&gt;/gi, () => stash('<span class="tg-spoiler">'))
+    .replace(/&lt;\/span&gt;/gi, () => stash("</span>"));
 
-  // Safe links only. Quotes are not escaped by escapeHtml(), but href content
-  // is still constrained to http(s)/mailto/tg schemes to avoid broken markup.
   out = out.replace(/&lt;a href="([^"<>]+)"&gt;/gi, (_, href) => {
     if (!/^(https?:|mailto:|tg:)/i.test(href)) return "";
-    return `<a href="${href}">`;
-  }).replace(/&lt;\/a&gt;/gi, "</a>");
+    return stash(`<a href="${href}">`);
+  }).replace(/&lt;\/a&gt;/gi, () => stash("</a>"));
 
-  return out;
+  return { text: out, tags };
 }
 
 function convertMarkdownToHtml(text) {
@@ -92,8 +96,12 @@ function convertMarkdownToHtml(text) {
 function telegramHtml(text) {
   const { text: withoutCode, blocks } = stashCode(text);
   let out = escapeHtml(withoutCode);
-  out = restoreAllowedHtmlTags(out);
-  out = convertMarkdownToHtml(out);
+  const { text: withoutHtmlTags, tags } = stashAllowedHtmlTags(out);
+  out = convertMarkdownToHtml(withoutHtmlTags);
+
+  tags.forEach((html, i) => {
+    out = out.replace(`\u0000OCTGHTML${i}\u0000`, html);
+  });
 
   blocks.forEach((html, i) => {
     out = out.replace(`\u0000OCTGCODE${i}\u0000`, html);

package/core/config.js

@@ -47,6 +47,7 @@ const WORKSPACE = config.WORKSPACE;
 const CLAUDE_PATH = config.CLAUDE_PATH;
 const CURSOR_PATH = config.CURSOR_PATH || null;
 const CODEX_PATH = config.CODEX_PATH || null;
+const DEFAULT_CLAUDE_MODEL = config.CLAUDE_MODEL || process.env.CLAUDE_MODEL || "claude-opus-4-8";
 const AUTO_COMPACT_TOKENS = parseInt(config.AUTO_COMPACT_TOKENS || process.env.AUTO_COMPACT_TOKENS || "380000", 10);
 const MIN_COMPACT_INTERVAL_MS = parseInt(config.MIN_COMPACT_INTERVAL_MS || process.env.MIN_COMPACT_INTERVAL_MS || "1800000", 10);
 const PROJECT_TRANSCRIPTS = configTruthy(config.PROJECT_TRANSCRIPTS || process.env.PROJECT_TRANSCRIPTS, true);
@@ -187,6 +188,7 @@ module.exports = {
   TOKEN, CHAT_IDS, CHAT_ID,
   WORKSPACE,
   CLAUDE_PATH,
+  DEFAULT_CLAUDE_MODEL,
   CURSOR_PATH,
   CODEX_PATH,
   resolvedCursorPath,

package/core/handlers.js

@@ -9,7 +9,7 @@ const { execSync } = require("child_process");
 const {
   WORKSPACE, FULL_PATH, AUTO_COMPACT_TOKENS, CONFIG_DIR,
   config, saveEnvKey,
-  CHAT_ID, resolvedCursorPath, resolvedCodexPath, SOUL_FILE,
+  CHAT_ID, DEFAULT_CLAUDE_MODEL, resolvedCursorPath, resolvedCodexPath, SOUL_FILE,
 } = require("./config");
 const { register } = require("./commands");
 const { send, deleteMessage } = require("./io");
@@ -535,8 +535,11 @@ register({
     const rows = [];
     rows.push([{ text: "── Claude ──", callback_data: "noop" }]);
     rows.push([
+      { text: "Opus 4.8", callback_data: "mb:claude:claude-opus-4-8" },
       { text: "Opus 4.7", callback_data: "mb:claude:claude-opus-4-7" },
       { text: "Opus 4.6", callback_data: "mb:claude:claude-opus-4-6" },
+    ]);
+    rows.push([
       { text: "Sonnet 4.6", callback_data: "mb:claude:claude-sonnet-4-6" },
       { text: "Haiku", callback_data: "mb:claude:claude-haiku-4-5-20251001" },
     ]);
@@ -563,7 +566,7 @@ register({
         { text: "o4-mini", callback_data: "mb:codex:o4-mini" },
       ]);
     }
-    rows.push([{ text: "Default (current backend)", callback_data: "m:default" }]);
+    rows.push([{ text: `Default (Claude: ${DEFAULT_CLAUDE_MODEL})`, callback_data: "m:default" }]);
     const beLabel = settings.backend === "cursor" ? "Cursor" : settings.backend === "codex" ? "Codex" : "Claude";
     send(`Current: ${beLabel} · ${settings.model || "default"}\n\nPick a model — backend switches automatically.\nOr type /model <name>.`, { keyboard: { inline_keyboard: rows } });
   },

package/core/runner.js

@@ -5,7 +5,7 @@
 
 const { spawn } = require("child_process");
 const {
-  CLAUDE_PATH, resolvedCursorPath, resolvedCodexPath,
+  CLAUDE_PATH, DEFAULT_CLAUDE_MODEL, resolvedCursorPath, resolvedCodexPath,
   AUTO_COMPACT_TOKENS, MIN_COMPACT_INTERVAL_MS, MAX_PROCESS_TIMEOUT, COMPACT_SUMMARY_TIMEOUT, botSubprocessEnv,
 } = require("./config");
 const { currentState, saveState, recordSession, userOwnsClaudeSession } = require("./state");
@@ -124,7 +124,7 @@ function buildClaudeArgs(prompt, opts = {}) {
       state.lastSessionId = null;
     }
   }
-  if (settings.model) args.push("--model", settings.model);
+  args.push("--model", settings.model || DEFAULT_CLAUDE_MODEL);
   if (settings.effort) args.push("--effort", settings.effort);
   if (settings.budget) args.push("--max-budget-usd", String(settings.budget));
   if (settings.permissionMode) args.push("--permission-mode", settings.permissionMode);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "2.2.17",
+  "version": "2.2.19",
   "description": "Your always-on AI coding assistant — Claude Code, Cursor Agent, and OpenAI Codex via Telegram or Kazee Chat",
   "main": "bot.js",
   "bin": {