Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

extensions/telegram/api.ts

@@ -0,0 +1,192 @@
+// Telegram API module exposes the plugin public contract.
+export { telegramPlugin } from "./src/channel.js";
+export { telegramSetupPlugin } from "./src/channel.setup.js";
+export {
+  type InspectedTelegramAccount,
+  inspectTelegramAccount,
+  type TelegramCredentialStatus,
+} from "./src/account-inspect.js";
+export {
+  createTelegramActionGate,
+  listEnabledTelegramAccounts,
+  listTelegramAccountIds,
+  mergeTelegramAccountConfig,
+  resetMissingDefaultWarnFlag,
+  resolveDefaultTelegramAccountId,
+  type ResolvedTelegramAccount,
+  resolveTelegramAccount,
+  resolveTelegramAccountConfig,
+  resolveTelegramMediaRuntimeOptions,
+  resolveTelegramPollActionGateState,
+  type TelegramMediaRuntimeOptions,
+  type TelegramPollActionGateState,
+} from "./src/accounts.js";
+export { resolveTelegramAutoThreadId } from "./src/action-threading.js";
+export {
+  isNumericTelegramSenderUserId,
+  isNumericTelegramUserId,
+  normalizeTelegramAllowFromEntry,
+} from "./src/allow-from.js";
+export {
+  fetchTelegramChatId,
+  lookupTelegramChatId,
+  resolveTelegramChatLookupFetch,
+} from "./src/api-fetch.js";
+export {
+  buildGroupLabel,
+  buildSenderLabel,
+  buildSenderName,
+  buildTelegramGroupFrom,
+  buildTelegramGroupPeerId,
+  buildTelegramParentPeer,
+  buildTelegramRoutingTarget,
+  buildTelegramThreadParams,
+  buildTypingThreadParams,
+  describeReplyTarget,
+  extractTelegramForumFlag,
+  extractTelegramLocation,
+  getTelegramTextParts,
+  hasBotMention,
+  isBinaryContent,
+  normalizeForwardedContext,
+  resetTelegramForumFlagCacheForTest,
+  resolveTelegramDirectPeerId,
+  resolveTelegramForumFlag,
+  resolveTelegramForumThreadId,
+  resolveTelegramGroupAllowFromContext,
+  resolveTelegramMediaPlaceholder,
+  resolveTelegramReplyId,
+  resolveTelegramStreamMode,
+  resolveTelegramThreadSpec,
+  type TelegramForwardedContext,
+  type TelegramReplyTarget,
+  type TelegramTextEntity,
+  type TelegramThreadSpec,
+  withResolvedTelegramForumFlag,
+} from "./src/bot/helpers.js";
+export {
+  normalizeTelegramCommandDescription,
+  normalizeTelegramCommandName,
+  resolveTelegramCustomCommands,
+  TELEGRAM_COMMAND_NAME_PATTERN,
+  type TelegramCustomCommandInput,
+  type TelegramCustomCommandIssue,
+} from "./src/command-config.js";
+export {
+  buildCommandsPaginationKeyboard,
+  buildTelegramModelsProviderChannelData,
+} from "./src/command-ui.js";
+export {
+  listTelegramDirectoryGroupsFromConfig,
+  listTelegramDirectoryPeersFromConfig,
+} from "./src/directory-config.js";
+export {
+  buildTelegramExecApprovalPendingPayload,
+  shouldSuppressTelegramExecApprovalForwardingFallback,
+} from "./src/exec-approval-forwarding.js";
+export {
+  getTelegramExecApprovalApprovers,
+  isTelegramExecApprovalApprover,
+  isTelegramExecApprovalAuthorizedSender,
+  isTelegramExecApprovalClientEnabled,
+  isTelegramExecApprovalHandlerConfigured,
+  isTelegramExecApprovalTargetRecipient,
+  resolveTelegramExecApprovalConfig,
+  resolveTelegramExecApprovalTarget,
+  shouldEnableTelegramExecApprovalButtons,
+  shouldHandleTelegramExecApprovalRequest,
+  shouldInjectTelegramExecApprovalButtons,
+  shouldSuppressLocalTelegramExecApprovalPrompt,
+} from "./src/exec-approvals.js";
+export {
+  resolveTelegramGroupRequireMention,
+  resolveTelegramGroupToolPolicy,
+} from "./src/group-policy.js";
+export type {
+  TelegramInteractiveHandlerContext,
+  TelegramInteractiveHandlerRegistration,
+} from "./src/interactive-dispatch.js";
+export {
+  isTelegramInlineButtonsEnabled,
+  resolveTelegramInlineButtonsConfigScope,
+  resolveTelegramInlineButtonsScope,
+  resolveTelegramInlineButtonsScopeFromCapabilities,
+  resolveTelegramTargetChatType,
+} from "./src/inline-buttons.js";
+export {
+  buildBrowseProvidersButton,
+  buildModelSelectionCallbackData,
+  buildModelsKeyboard,
+  buildProviderKeyboard,
+  type ButtonRow,
+  calculateTotalPages,
+  getModelsPageSize,
+  type ModelsKeyboardParams,
+  type ParsedModelCallback,
+  parseModelCallbackData,
+  type ProviderInfo,
+  resolveModelSelection,
+  type ResolveModelSelectionResult,
+} from "./src/model-buttons.js";
+export { looksLikeTelegramTargetId, normalizeTelegramMessagingTarget } from "./src/normalize.js";
+export {
+  sendTelegramPayloadMessages,
+  TELEGRAM_TEXT_CHUNK_LIMIT,
+  telegramOutbound,
+} from "./src/outbound-adapter.js";
+export {
+  normalizeTelegramReplyToMessageId,
+  parseTelegramReplyToMessageId,
+  parseTelegramThreadId,
+} from "./src/outbound-params.js";
+export {
+  probeTelegram,
+  resetTelegramProbeFetcherCacheForTests,
+  type TelegramProbe,
+  type TelegramProbeOptions,
+} from "./src/probe.js";
+export {
+  type ResolvedReactionLevel,
+  resolveTelegramReactionLevel,
+  type TelegramReactionLevel,
+} from "./src/reaction-level.js";
+export { collectTelegramSecurityAuditFindings } from "./src/security-audit.js";
+export {
+  type CachedSticker,
+  cacheSticker,
+  describeStickerImage,
+  type DescribeStickerParams,
+  getAllCachedStickers,
+  getCachedSticker,
+  getCacheStats,
+  searchStickers,
+} from "./src/sticker-cache.js";
+export { collectTelegramStatusIssues } from "./src/status-issues.js";
+export {
+  isNumericTelegramChatId,
+  normalizeTelegramChatId,
+  normalizeTelegramLookupTarget,
+  parseTelegramTarget,
+  stripTelegramInternalPrefixes,
+  type TelegramTarget,
+} from "./src/targets.js";
+export {
+  type ParsedTelegramTopicConversation,
+  parseTelegramTopicConversation,
+} from "./src/topic-conversation.js";
+export {
+  deleteTelegramUpdateOffset,
+  readTelegramUpdateOffset,
+  writeTelegramUpdateOffset,
+} from "./src/update-offset-store.js";
+export type { TelegramButtonStyle, TelegramInlineButtons } from "./src/button-types.js";
+export type { StickerMetadata } from "./src/bot/types.js";
+export type { TelegramTokenResolution } from "./src/token.js";
+export {
+  escapeTelegramHtml,
+  markdownToTelegramChunks,
+  markdownToTelegramHtml,
+  markdownToTelegramHtmlChunks,
+  splitTelegramHtmlChunks,
+  type TelegramFormattedChunk,
+} from "./src/format.js";