chore: fork @llblab/[email protected].0 as @evandrodevbr/oh-my-pi-telegram

Fork of upstream llblab/[email protected].0 (SHA afe09c5) repackaged as a
drop-in extension for can1357/oh-my-pi (omp >= 16.5.2).

Changes vs upstream:
- Rename package: @llblab/pi-telegram -> @evandrodevbr/oh-my-pi-telegram
- Bump version: 0.22.0 -> 0.22.0-evandro.1
- Update repository/homepage/bugs URLs to evandrodevbr
- Add omp field in package.json (displayName + compatibleWith)
- README: prepend 'Oh My Pi (omp) Compatibility' section with install
  commands, verified-components table, upstream lineage, and rationale
- CHANGELOG: add '0.22.0-evandro.1' entry under Unreleased
- docs/: rename @llblab/pi-telegram imports to @evandrodevbr/oh-my-pi-telegram
- tests/public-api.test.ts: rename package import paths

Gates re-run on the fork:
- npm run typecheck  -> tsc --noEmit (success)
- npm test           -> 1229 pass / 0 fail / 1 platform-only skip
- npm run audit      -> found 0 vulnerabilities
- npm run pack:check -> evandrodevbr-oh-my-pi-telegram-0.22.0-evandro.1.tgz

Verified:
- omp install --link ./pi-telegram -> Linked OK
- omp plugin list -> @evandrodevbr/[email protected].0-evandro.1

Upstream lineage: badlogic/pi-telegram -> llblab/pi-telegram (0.22.0) -> evandrodevbr/oh-my-pi-telegram (this fork)

api/activity.ts

@@ -0,0 +1,15 @@
+/**
+ * Public Telegram activity API
+ * Zones: package boundary, pi agent lifecycle, extension interop
+ * Exposes normalized non-blocking activity registration while keeping lifecycle wiring and dispatch internals package-private
+ */
+
+export {
+  registerTelegramActivityHandler,
+  type TelegramActivityContext,
+  type TelegramActivityEnvelope,
+  type TelegramActivityEvent,
+  type TelegramActivityHandlerRegistration,
+  type TelegramActivitySource,
+  type TelegramActivityTarget,
+} from "../lib/activity.ts";

api/commands.ts

@@ -0,0 +1,11 @@
+/**
+ * Public Telegram commands API
+ * Zones: package boundary, extension interop
+ * Exposes the stable Telegram slash-command registration surface while keeping registry internals package-private
+ */
+
+export {
+  registerTelegramCommand,
+  type TelegramExtensionCommandContext,
+  type TelegramExtensionCommandRegistration,
+} from "../lib/commands.ts";

api/delivery.ts

@@ -0,0 +1,21 @@
+/**
+ * Public Telegram delivery API
+ * Zones: package boundary, telegram delivery, extension interop
+ * Exposes target-aware operational view delivery while keeping transport and runtime binding internals package-private
+ */
+
+export {
+  deleteTelegramView,
+  editTelegramView,
+  sendTelegramChatAction,
+  sendTelegramView,
+  type SendTelegramViewOptions,
+  type TelegramDeliveryChatAction,
+  type TelegramDeliveryFailureReason,
+  type TelegramDeliveryHandle,
+  type TelegramDeliveryParseMode,
+  type TelegramDeliveryResult,
+  type TelegramDeliveryScope,
+  type TelegramDeliveryTarget,
+  type TelegramDeliveryView,
+} from "../lib/delivery.ts";

api/inbound.ts

@@ -0,0 +1,14 @@
+/**
+ * Public Telegram inbound API
+ * Zones: package boundary, extension interop
+ * Exposes the stable programmatic inbound handler surface while keeping handler runtime internals package-private
+ */
+
+export {
+  registerTelegramInboundHandler,
+  type TelegramInboundHandlerFile,
+  type TelegramInboundHandlerOutput,
+  type TelegramInboundProgrammaticHandler,
+  type TelegramInboundProgrammaticHandlerInput,
+  type TelegramInboundProgrammaticHandlerResult,
+} from "../lib/inbound.ts";

api/keyboard.ts

@@ -0,0 +1,10 @@
+/**
+ * Public Telegram keyboard API
+ * Zones: package boundary, extension interop
+ * Exposes shared inline-keyboard structural types without runtime exports
+ */
+
+export type {
+  TelegramInlineKeyboardButton,
+  TelegramInlineKeyboardMarkup,
+} from "../lib/keyboard.ts";

api/outbound.ts

@@ -0,0 +1,11 @@
+/**
+ * Public Telegram outbound API
+ * Zones: package boundary, extension interop
+ * Exposes stable outbound handler and diagnostics surfaces while keeping delivery internals package-private
+ */
+
+export {
+  recordTelegramRuntimeEvent,
+  registerTelegramOutboundHandler,
+  type TelegramOutboundProgrammaticHandler,
+} from "../lib/outbound.ts";

api/sections.ts

@@ -0,0 +1,17 @@
+/**
+ * Public Telegram sections API
+ * Zones: package boundary, extension interop
+ * Exposes the stable managed Telegram menu-section surface while keeping registry internals package-private
+ */
+
+export {
+  getTelegramSectionDiagnostics,
+  registerTelegramSection,
+  type TelegramSectionCallbackContext,
+  type TelegramSectionCallbackResult,
+  type TelegramSectionContext,
+  type TelegramSectionDiagnostic,
+  type TelegramSectionRegistration,
+  type TelegramSectionSettingsRegistration,
+  type TelegramSectionView,
+} from "../lib/sections.ts";

api/status.ts

@@ -0,0 +1,12 @@
+/**
+ * Public Telegram status API
+ * Zones: package boundary, extension interop
+ * Exposes compact status-menu line registration for extension consumers while keeping status rendering internals package-private
+ */
+
+export {
+  registerTelegramStatusLineProvider,
+  type TelegramStatusLineProvider,
+  type TelegramStatusLineProviderContext,
+  type TelegramStatusLineProviderResult,
+} from "../lib/status.ts";

api/updates.ts

@@ -0,0 +1,11 @@
+/**
+ * Public Telegram updates API
+ * Zones: package boundary, extension interop
+ * Exposes the stable raw-update handler surface while keeping update routing internals package-private
+ */
+
+export {
+  registerTelegramUpdateHandler,
+  type TelegramUpdateHandler,
+  type TelegramUpdateHandlerVerdict,
+} from "../lib/updates.ts";

api/voice.ts

@@ -0,0 +1,24 @@
+/**
+ * Public Telegram voice API
+ * Zones: package boundary, extension interop
+ * Exposes the stable STT/TTS provider surface and voice policy helpers
+ */
+
+export {
+  TELEGRAM_VOICE_REPLY_MODES,
+  computeVoicePromptContribution,
+  computeVoiceTurnFlags,
+  getTelegramVoiceReplyMode,
+  getTelegramVoiceSendTranscript,
+  isVoiceTurn,
+  registerTelegramVoiceSynthesisProvider,
+  registerTelegramVoiceTranscriptionProvider,
+  shouldSuppressPreviewForVoice,
+  type TelegramVoiceReplyMode,
+  type TelegramVoiceSynthesisProvider,
+  type TelegramVoiceSynthesisProviderResult,
+  type TelegramVoiceTranscriptionFile,
+  type TelegramVoiceTranscriptionProvider,
+  type TelegramVoiceTranscriptionProviderResult,
+  type TelegramVoiceTurnView,
+} from "../lib/voice.ts";