@s0nderlabs/anima-plugin-telegram 0.21.21 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s0nderlabs/anima-plugin-telegram",
-  "version": "0.21.21",
+  "version": "0.22.0",
   "type": "module",
   "description": "Telegram gateway plugin for anima — long-poll bot, debounced dispatch, reactions, allowlist",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@s0nderlabs/anima-core": "0.21.21",
+    "@s0nderlabs/anima-core": "0.22.0",
     "grammy": "^1.42.0",
     "zod": "^3.23.8"
   }

package/src/format.test.ts

@@ -1,5 +1,6 @@
 import { describe, expect, it } from 'bun:test'
-import { formatInboundPreview, formatTelegramChannel } from './format'
+import { formatInboundPreview, formatTelegramChannel, stripTelegramChannelEnvelope } from './format'
+import { parseBypassCommand } from './session-state'
 
 describe('formatTelegramChannel', () => {
   it('wraps text in channel tags with username', () => {
@@ -44,6 +45,51 @@ describe('formatTelegramChannel', () => {
   })
 })
 
+describe('stripTelegramChannelEnvelope', () => {
+  it('strips the envelope and returns inner text', () => {
+    expect(
+      stripTelegramChannelEnvelope(
+        '<channel source="telegram" chat="42" user="el">hello world</channel>',
+      ),
+    ).toBe('hello world')
+  })
+  it('returns input unchanged when no envelope present', () => {
+    expect(stripTelegramChannelEnvelope('hello world')).toBe('hello world')
+    expect(stripTelegramChannelEnvelope('/yolo')).toBe('/yolo')
+  })
+  it('preserves multi-line + nested-bracket content', () => {
+    expect(
+      stripTelegramChannelEnvelope(
+        '<channel source="telegram" chat="1" user="a">line 1\nline 2 with &lt;br&gt; tag</channel>',
+      ),
+    ).toBe('line 1\nline 2 with &lt;br&gt; tag')
+  })
+  // v0.22.0 regression: TG bypass commands (/yolo /perms /reset) fell through
+  // to the brain because parseBypassCommand was given the wrapped string. The
+  // wrapped string starts with '<channel' not '/', so the bypass parser
+  // returns null. After the strip, parseBypassCommand intercepts correctly.
+  it('lets parseBypassCommand intercept after strip (regression)', () => {
+    const wrapped = '<channel source="telegram" chat="1" user="el">/yolo</channel>'
+    expect(parseBypassCommand(wrapped)).toBeNull()
+    expect(parseBypassCommand(stripTelegramChannelEnvelope(wrapped))).toEqual({
+      command: '/yolo',
+      args: [],
+    })
+  })
+  it('handles /perms strict and /reset the same way', () => {
+    const yolo = '<channel source="telegram" chat="1" user="el">/perms strict</channel>'
+    expect(parseBypassCommand(stripTelegramChannelEnvelope(yolo))).toEqual({
+      command: '/perms',
+      args: ['strict'],
+    })
+    const reset = '<channel source="telegram" chat="1" user="el">/reset</channel>'
+    expect(parseBypassCommand(stripTelegramChannelEnvelope(reset))).toEqual({
+      command: '/reset',
+      args: [],
+    })
+  })
+})
+
 describe('formatInboundPreview', () => {
   it('renders short message verbatim', () => {
     expect(

package/src/format.ts

@@ -20,6 +20,24 @@ export function formatTelegramChannel(input: FormatTelegramChannelInput): string
   return `<channel source="telegram" chat="${input.chatId}" user="${safeUser}">${safeText}</channel>`
 }
 
+/**
+ * Inverse of `formatTelegramChannel`: strip the channel envelope and return
+ * the raw inner text. Used by the gateway's TG slot to feed bypass-command
+ * parsing the un-wrapped string (the wrapper would make `parseBypassCommand`'s
+ * `startsWith('/')` check fail and silently drop `/yolo` etc).
+ *
+ * v0.22.0: extracted into plugin-telegram so the regex source lives next to
+ * its forward counterpart `formatTelegramChannel`. If we ever change the
+ * envelope shape (add fields, swap quoting), both stay in sync.
+ *
+ * Returns the input unchanged when there is no envelope (idempotent — safe to
+ * call on already-stripped or non-TG input).
+ */
+const CHANNEL_ENVELOPE_RE = /^<channel[^>]*>([\s\S]*)<\/channel>$/
+export function stripTelegramChannelEnvelope(text: string): string {
+  return text.replace(CHANNEL_ENVELOPE_RE, '$1')
+}
+
 /**
  * One-line preview of an inbound TG message for TUI rows + activity log.
  * Truncated to 80 chars; never includes the bot token or any envelope bytes.

package/src/index.ts

@@ -34,7 +34,11 @@ export {
   formatApprovalResolution,
 } from './listener'
 export { buildSessionKey, sanitizeAgentName } from './session-key'
-export { formatTelegramChannel, formatInboundPreview } from './format'
+export {
+  formatTelegramChannel,
+  formatInboundPreview,
+  stripTelegramChannelEnvelope,
+} from './format'
 export { RateLimiter } from './limits'
 export { sanitizeInbound, type SanitizeReason, type SanitizeResult } from './sanitize'
 export { formatPairingMessage } from './pairing-flow'