pi-braid-telegram 0.1.4 → 0.1.5

package/README.md

@@ -4,6 +4,12 @@
 
 Bidirectional Telegram channel for pi-braid.
 
+```bash
+pi install npm:pi-braid-telegram
+```
+
+One command, no clone, no build: `pi install` registers the package with pi and installs it under pi's npm directory.
+
 - **Outbound**: `telegram_send` tool - the agent sends text messages to the
   owner (or voice notes once a TTS source is configured). Messages are LONG by
   default: plain text sends verbatim up to the cap (`braid.telegram.sendMaxChars`
@@ -96,6 +102,17 @@ Or register the workspace in `~/.pi/agent/settings.json`:
 - A bot token from @BotFather; optionally `BRAID_TG_CHAT_ID` / `BRAID_TG_ALLOWED_USERS` for the
   allow-list.
 
+## Settings cadence
+
+Settings live in `~/.pi/agent/settings.json`. `braid.telegram.pauseStateFile`
+is captured as the callback write target when the extension loads. `getPauseState()`
+resolves its read path per call, so restart after changing the setting to keep
+reads and writes aligned. `braid.telegram.tts` is loaded into the voice hook at
+extension load; restart after changing its source, rate, or voices.
+The send and notification caps (`braid.telegram.sendMaxChars` and
+`braid.telegram.notifyMaxChars`) are re-read per operation and change without
+a restart.
+
 ## Environment variables
 
 | Var                                | Purpose                                                                | Required                                                        |

package/build-info.json

@@ -0,0 +1,9 @@
+{
+  "name": "pi-braid-telegram",
+  "version": "0.1.5",
+  "sha": "752d2e6e9b45037a8ebcc17f3d6f90c905b2c71c",
+  "shaShort": "752d2e6",
+  "branch": "detached",
+  "dirty": false,
+  "packedAt": "2026-10-19T11:29:41.109Z"
+}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "pi-braid-telegram",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Bidirectional Telegram channel for pi-braid: telegram_send tool (outbound) + inbound long-poll injector (backward channel)",
   "type": "module",
   "files": [
     "src/",
     "docs/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "build-info.json"
   ],
   "exports": {
     ".": "./src/index.ts"
@@ -34,16 +35,17 @@
     "test": "node test/run-tests.mjs",
     "check:doc-index": "node ../../packages/core/scripts/check-doc-index.mjs",
     "publish:local": "node ../../packages/core/scripts/publish-local.mjs telegram",
-    "prepack": "npm run build"
+    "prepack": "npm run build && node ../../packages/core/scripts/pack-provenance.mjs write",
+    "postpack": "node ../../packages/core/scripts/pack-provenance.mjs remove"
   },
   "devDependencies": {
     "typescript": "6.0.2",
     "typebox": "1.1.38"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "typebox": "*"
+    "@earendil-works/pi-ai": "^1.2.0",
+    "@earendil-works/pi-coding-agent": "^1.2.0",
+    "typebox": "^1.1.38"
   },
   "author": "kifirkin",
   "license": "MIT",

package/src/lib/format.ts

@@ -27,7 +27,11 @@ import type {
   TelegramSendResult,
   ParseMode,
 } from "./telegram-client.js";
-import { checkTelegramHtml, parseTelegramTagAt } from "./html-check.js";
+import {
+  TELEGRAM_HTML_TAGS,
+  checkTelegramHtml,
+  parseTelegramTagAt,
+} from "./html-check.js";
 
 /** Telegram hard cap for a single text message (https://core.telegram.org/bots/api#sendmessage). */
 export const TELEGRAM_MAX_TEXT_LENGTH = 4096;
@@ -145,17 +149,26 @@ export function isBalancedMarkdown(text: string): boolean {
 // attribute value is part of the tag, so `<a href="a>b">` is one token and is
 // removed whole rather than truncated at the first `>`.
 
-/** True when the text contains raw HTML tags — a signal it was authored as HTML. */
+/** True when the text contains a tag Telegram's HTML parser accepts.
+ *
+ * Tag-shaped is not enough: auto-selecting HTML for a body carrying `<n>` or
+ * `<b/>` makes Telegram reject the whole message ("Unsupported start tag"),
+ * while as a plain body the same characters reach the reader literally. Only
+ * a token whose name is in Telegram's tag set and whose syntax the parser
+ * accepts is a signal the body was authored as HTML.
+ */
 export function hasHtmlTags(text: string): boolean {
   return findTagToken(text) !== null;
 }
 
-/** First tag-shaped token in `text`, or null. */
+/** First tag-shaped token Telegram would accept, or null. */
 function findTagToken(text: string): { start: number; end: number } | null {
   let i = text.indexOf("<");
   while (i !== -1) {
     const tag = parseTelegramTagAt(text, i);
-    if (tag) return { start: i, end: tag.end };
+    if (tag && tag.error === undefined && TELEGRAM_HTML_TAGS.has(tag.name)) {
+      return { start: i, end: tag.end };
+    }
     i = text.indexOf("<", i + 1);
   }
   return null;