@llblab/pi-kit 0.1.7 → 0.1.9

package/node_modules/@llblab/pi-telegram/lib/journal.ts

@@ -157,6 +157,7 @@ export interface TelegramUpdateJournalEntry {
 export interface TelegramUpdateJournalFile {
   version: typeof TELEGRAM_UPDATE_JOURNAL_VERSION;
   revision?: number;
+  acceptedThroughUpdateId?: number;
   profile: string;
   botIdentity: TelegramUpdateJournalBotIdentity;
   entries: TelegramUpdateJournalEntry[];
@@ -312,6 +313,7 @@ export interface TelegramUpdateJournalStore {
   read(): TelegramUpdateJournalSnapshot;
   appendBatch<TUpdate extends TelegramUpdateJournalInput>(
     updates: readonly TUpdate[],
+    acceptedThroughUpdateId?: number,
   ): TelegramUpdateJournalAppendResult;
   markQueued(
     receipt: TelegramUpdateJournalQueueReceipt,
@@ -385,6 +387,7 @@ export interface TelegramUpdateJournalSegment {
   version: typeof TELEGRAM_UPDATE_JOURNAL_VERSION;
   revision: number;
   previousRevision: number;
+  acceptedThroughUpdateId?: number;
   profile: string;
   botIdentity: TelegramUpdateJournalBotIdentity;
   upsertedEntries: TelegramUpdateJournalEntry[];
@@ -975,6 +978,7 @@ function parseJournalFile(
     !hasOnlyKeys(value, [
       "version",
       "revision",
+      "acceptedThroughUpdateId",
       "profile",
       "botIdentity",
       "entries",
@@ -983,6 +987,8 @@ function parseJournalFile(
     !Number.isSafeInteger(value.version) ||
     (value.revision !== undefined &&
       (!isSafeNonNegativeInteger(value.revision) || value.revision === 0)) ||
+    (value.acceptedThroughUpdateId !== undefined &&
+      !isSafeNonNegativeInteger(value.acceptedThroughUpdateId)) ||
     !isNonEmptyString(value.profile) ||
     !Array.isArray(value.entries) ||
     (value.operatorDispositions !== undefined &&
@@ -1009,6 +1015,17 @@ function parseJournalFile(
       );
     }
   }
+  if (
+    entries.length > 0 &&
+    value.acceptedThroughUpdateId !== undefined &&
+    value.acceptedThroughUpdateId < entries.at(-1)!.updateId
+  ) {
+    throw createJournalError(
+      "invalid",
+      path,
+      "has an admission cursor behind its active entries",
+    );
+  }
   const queuedReceipts = new Map<
     string,
     {
@@ -1096,6 +1113,9 @@ function parseJournalFile(
     ...(value.revision !== undefined
       ? { revision: value.revision as number }
       : {}),
+    ...(value.acceptedThroughUpdateId !== undefined
+      ? { acceptedThroughUpdateId: value.acceptedThroughUpdateId as number }
+      : {}),
     profile: value.profile,
     botIdentity: validateBotIdentity(value.botIdentity, path),
     entries,
@@ -1113,6 +1133,7 @@ function parseJournalSegment(
       "version",
       "revision",
       "previousRevision",
+      "acceptedThroughUpdateId",
       "profile",
       "botIdentity",
       "upsertedEntries",
@@ -1122,6 +1143,8 @@ function parseJournalSegment(
     value.version !== TELEGRAM_UPDATE_JOURNAL_VERSION ||
     !isSafePositiveInteger(value.revision) ||
     !isSafeNonNegativeInteger(value.previousRevision) ||
+    (value.acceptedThroughUpdateId !== undefined &&
+      !isSafeNonNegativeInteger(value.acceptedThroughUpdateId)) ||
     !isNonEmptyString(value.profile) ||
     !Array.isArray(value.upsertedEntries) ||
     !Array.isArray(value.removedUpdateIds) ||
@@ -1140,6 +1163,18 @@ function parseJournalSegment(
     }
     upsertedIds.add(entry.updateId);
   }
+  if (
+    upsertedEntries.length > 0 &&
+    value.acceptedThroughUpdateId !== undefined &&
+    value.acceptedThroughUpdateId <
+      Math.max(...upsertedEntries.map((entry) => entry.updateId))
+  ) {
+    throw createJournalError(
+      "invalid",
+      path,
+      "has an admission cursor behind its segment upserts",
+    );
+  }
   const removedUpdateIds: number[] = [];
   const removedIds = new Set<number>();
   for (const updateId of value.removedUpdateIds) {
@@ -1162,6 +1197,9 @@ function parseJournalSegment(
     version: TELEGRAM_UPDATE_JOURNAL_VERSION,
     revision: value.revision,
     previousRevision: value.previousRevision,
+    ...(value.acceptedThroughUpdateId !== undefined
+      ? { acceptedThroughUpdateId: value.acceptedThroughUpdateId as number }
+      : {}),
     profile: value.profile,
     botIdentity: validateBotIdentity(value.botIdentity, path),
     upsertedEntries,
@@ -1190,6 +1228,9 @@ function cloneFile(file: TelegramUpdateJournalFile): TelegramUpdateJournalFile {
   return {
     version: TELEGRAM_UPDATE_JOURNAL_VERSION,
     ...(file.revision !== undefined ? { revision: file.revision } : {}),
+    ...(file.acceptedThroughUpdateId !== undefined
+      ? { acceptedThroughUpdateId: file.acceptedThroughUpdateId }
+      : {}),
     profile: file.profile,
     botIdentity: { ...file.botIdentity },
     entries: file.entries.map(cloneEntry),
@@ -1879,6 +1920,17 @@ export function createTelegramUpdateJournalStore(
           `has a revision gap after ${revision}`,
         );
       }
+      if (
+        segment.acceptedThroughUpdateId !== undefined &&
+        file.acceptedThroughUpdateId !== undefined &&
+        segment.acceptedThroughUpdateId < file.acceptedThroughUpdateId
+      ) {
+        throw createJournalError(
+          "invalid",
+          segmentPath,
+          "regresses the admission cursor",
+        );
+      }
       if (
         segment.profile !== storedProfile ||
         !identitiesMatch(segment.botIdentity, storedIdentity)
@@ -1907,6 +1959,11 @@ export function createTelegramUpdateJournalStore(
         {
           version: TELEGRAM_UPDATE_JOURNAL_VERSION,
           revision: segment.revision,
+          ...(segment.acceptedThroughUpdateId !== undefined
+            ? { acceptedThroughUpdateId: segment.acceptedThroughUpdateId }
+            : file.acceptedThroughUpdateId !== undefined
+              ? { acceptedThroughUpdateId: file.acceptedThroughUpdateId }
+              : {}),
           profile: storedProfile,
           botIdentity: mergeBotIdentity(file.botIdentity, segment.botIdentity),
           entries: [...entriesById.values()].sort(
@@ -2136,6 +2193,7 @@ export function createTelegramUpdateJournalStore(
     entries: TelegramUpdateJournalEntry[],
     contentChanged: boolean,
     operatorDispositions = current.file.operatorDispositions,
+    acceptedThroughUpdateId = current.file.acceptedThroughUpdateId,
   ): { file: TelegramUpdateJournalFile; serializedBytes: number } => {
     const botIdentity = mergeBotIdentity(
       current.file.botIdentity,
@@ -2147,7 +2205,8 @@ export function createTelegramUpdateJournalStore(
       isDeepStrictEqual(
         current.file.operatorDispositions ?? [],
         operatorDispositions ?? [],
-      )
+      ) &&
+      current.file.acceptedThroughUpdateId === acceptedThroughUpdateId
     ) {
       return { file: current.file, serializedBytes: current.serializedBytes };
     }
@@ -2156,6 +2215,9 @@ export function createTelegramUpdateJournalStore(
       profile,
       botIdentity,
       entries,
+      ...(acceptedThroughUpdateId !== undefined
+        ? { acceptedThroughUpdateId }
+        : {}),
       ...(operatorDispositions?.length
         ? { operatorDispositions }
         : {}),
@@ -2164,6 +2226,7 @@ export function createTelegramUpdateJournalStore(
     const serializedBytes = assertCapacity(file, serialized);
     const changed =
       contentChanged ||
+      current.file.acceptedThroughUpdateId !== acceptedThroughUpdateId ||
       !isDeepStrictEqual(current.file.botIdentity, file.botIdentity);
     if (!changed) {
       return { file, serializedBytes: current.serializedBytes };
@@ -2193,6 +2256,9 @@ export function createTelegramUpdateJournalStore(
       botIdentity: file.botIdentity,
       upsertedEntries,
       removedUpdateIds,
+      ...(acceptedThroughUpdateId !== undefined
+        ? { acceptedThroughUpdateId }
+        : {}),
       ...(!isDeepStrictEqual(
         current.file.operatorDispositions ?? [],
         operatorDispositions ?? [],
@@ -2260,8 +2326,18 @@ export function createTelegramUpdateJournalStore(
         };
       });
     },
-    appendBatch(updates) {
+    appendBatch(updates, requestedAcceptedThroughUpdateId) {
       return runMutation(() => {
+        if (
+          requestedAcceptedThroughUpdateId !== undefined &&
+          !isSafeNonNegativeInteger(requestedAcceptedThroughUpdateId)
+        ) {
+          throw createJournalError(
+            "invalid",
+            path,
+            "received an invalid admission cursor",
+          );
+        }
         const current = readCurrent();
         const normalizedUpdates: TelegramJournaledUpdate[] = [];
         for (const update of updates) {
@@ -2290,6 +2366,8 @@ export function createTelegramUpdateJournalStore(
         const entriesById = new Map(
           current.file.entries.map((entry) => [entry.updateId, entry]),
         );
+        const previousAcceptedThroughUpdateId =
+          current.file.acceptedThroughUpdateId;
         const discardedUpdateIds = new Set(
           (current.file.operatorDispositions ?? [])
             .filter((disposition) => disposition.action === "discard")
@@ -2335,6 +2413,31 @@ export function createTelegramUpdateJournalStore(
           addedUpdateIds.push(entry.updateId);
         }
 
+        const batchLastUpdateId = normalizedUpdates.at(-1)?.update_id;
+        if (
+          requestedAcceptedThroughUpdateId !== undefined &&
+          batchLastUpdateId !== undefined &&
+          requestedAcceptedThroughUpdateId < batchLastUpdateId
+        ) {
+          throw createJournalError(
+            "invalid",
+            path,
+            "received an admission cursor behind its batch",
+          );
+        }
+        if (
+          requestedAcceptedThroughUpdateId !== undefined &&
+          previousAcceptedThroughUpdateId !== undefined &&
+          requestedAcceptedThroughUpdateId < previousAcceptedThroughUpdateId
+        ) {
+          throw createJournalError(
+            "conflict",
+            path,
+            "received a regressing admission cursor",
+          );
+        }
+        const acceptedThroughUpdateId =
+          requestedAcceptedThroughUpdateId ?? previousAcceptedThroughUpdateId;
         const contentChanged = addedUpdateIds.length > 0;
         const published = publishMutation(
           current,
@@ -2344,6 +2447,8 @@ export function createTelegramUpdateJournalStore(
               )
             : current.file.entries,
           contentChanged,
+          current.file.operatorDispositions,
+          acceptedThroughUpdateId,
         );
         return {
           addedUpdateIds,

package/node_modules/@llblab/pi-telegram/lib/menu-model.ts

@@ -103,7 +103,7 @@ export interface TelegramModelMenuRuntimeOptions<
 }
 
 export interface MenuSettingsManager {
-  reload: () => Promise<void>;
+  reload?: () => Promise<void>;
   flush?: () => Promise<void>;
   getEnabledModels: () => string[] | undefined;
   setEnabledModels?: (patterns: string[] | undefined) => void;
@@ -498,7 +498,9 @@ export function createTelegramModelMenuStateBuilder<
       threadId,
       activeModel: deps.getActiveModel(ctx),
       ctx,
-      reloadSettings: () => settingsManager.reload(),
+      reloadSettings: async () => {
+        await settingsManager.reload?.();
+      },
       getConfiguredScopedModelPatterns: () =>
         settingsManager.getEnabledModels(),
     });

package/node_modules/@llblab/pi-telegram/lib/menu-settings.ts

@@ -149,9 +149,7 @@ export const TIME_INJECTION_MODE_SETTINGS_TITLE =
   "<b>🕒 Time injection mode:</b>";
 export const VOICE_REPLY_MODE_SETTINGS_TITLE = "<b>👄 Voice reply mode:</b>";
 
-type TelegramVoiceReplyModeSetting = TelegramVoiceReplyMode | "hidden";
-
-function getVoiceReplyModeLabel(mode: TelegramVoiceReplyModeSetting): string {
+function getVoiceReplyModeLabel(mode: TelegramVoiceReplyMode): string {
   return mode;
 }
 
@@ -162,8 +160,8 @@ function getTelegramSettingsStateValueLabel(value: string): string {
 function getVoiceReplyModeSetting(
   mode: TelegramVoiceReplyMode,
   configured: boolean,
-): TelegramVoiceReplyModeSetting {
-  return configured ? mode : "hidden";
+): TelegramVoiceReplyMode {
+  return configured ? mode : "manual";
 }
 
 export function buildTelegramSettingsMenuText(): string {
@@ -246,8 +244,8 @@ export function buildVoiceReplyModeSettingsText(
     "",
     "Controls when pi-telegram converts assistant text replies into Telegram voice messages.",
     "",
-    "<code>-</code> <code>hidden</code> (default): add no automatic voice context; explicit 'telegram_voice' actions still work.",
-    "<code>-</code> <code>mirror</code>: voice input activates automatic voice delivery; text input follows 'hidden' behavior.",
+    "<code>-</code> <code>manual</code> (default): add no automatic voice context; explicit 'telegram_voice' actions still work.",
+    "<code>-</code> <code>mirror</code>: voice input activates automatic voice delivery; text input follows 'manual' behavior.",
     "<code>-</code> <code>always</code>: activate automatic voice delivery for every reply.",
   ].join("\n");
 }
@@ -502,7 +500,7 @@ export function buildVoiceReplyModeSettingsReplyMarkup(
   configured = true,
 ): TelegramSettingsMenuReplyMarkup {
   const activeMode = getVoiceReplyModeSetting(mode, configured);
-  const modes: TelegramVoiceReplyModeSetting[] = ["hidden", "mirror", "always"];
+  const modes: TelegramVoiceReplyMode[] = ["manual", "mirror", "always"];
   return {
     inline_keyboard: [
       [{ text: "⬆️ Back", callback_data: "settings:list" }],
@@ -661,12 +659,18 @@ export async function handleTelegramSettingsMenuCallbackAction(
   }
   if (data.startsWith("settings:set:voice-reply:")) {
     const mode = data.slice("settings:set:voice-reply:".length);
-    if (mode === "hidden" || mode === "mirror" || mode === "always") {
-      await deps.setVoiceReplyMode(mode === "hidden" ? undefined : mode);
+    if (
+      mode === "manual" ||
+      mode === "hidden" ||
+      mode === "mirror" ||
+      mode === "always"
+    ) {
+      const normalizedMode = mode === "hidden" ? "manual" : mode;
+      await deps.setVoiceReplyMode(normalizedMode);
       await updateVoiceReplyModeSettingsMessage(deps);
       await deps.answerCallbackQuery(
         callbackQueryId,
-        `Voice reply mode: ${mode}`,
+        `Voice reply mode: ${normalizedMode}`,
       );
       return true;
     }

package/node_modules/@llblab/pi-telegram/lib/outbound-voice.ts

@@ -100,17 +100,6 @@ async function ensureTelegramVoiceFileFormat(
   );
 }
 
-function extractVoiceResult(result: any): {
-  filePath: string;
-  transcriptText?: string;
-} {
-  if (typeof result === "string") return { filePath: result };
-  return {
-    filePath: result.audioPath,
-    transcriptText: result.transcriptText,
-  };
-}
-
 async function sendVoiceChatAction(
   deps: TelegramVoiceReplySenderDeps,
   chatId: number,
@@ -132,7 +121,6 @@ export function createTelegramVoiceReplySender<THandler = unknown>(
     options?: {
       replyToPrompt?: boolean;
       replyMarkup?: unknown;
-      transcriptText?: string;
     },
   ): Promise<void> => {
     const voiceFilePath = await ensureTelegramVoiceFileFormat(filePath);
@@ -148,7 +136,6 @@ export function createTelegramVoiceReplySender<THandler = unknown>(
       "sendVoice",
       {
         chat_id: String(turn.chatId),
-        ...(options?.transcriptText ? { caption: options.transcriptText } : {}),
         ...(replyParameters ? { reply_parameters: replyParameters } : {}),
         ...(turn.target
           ? Object.fromEntries(
@@ -257,13 +244,11 @@ export function createTelegramVoiceReplySender<THandler = unknown>(
           continue;
         }
 
-        const { filePath, transcriptText } = extractVoiceResult(providerResult);
-        voiceFilePath = filePath;
-        originalFilePath = filePath;
-        await uploadVoiceFile(turn, filePath, {
+        voiceFilePath = providerResult;
+        originalFilePath = providerResult;
+        await uploadVoiceFile(turn, providerResult, {
           replyToPrompt: options?.replyToPrompt,
           replyMarkup: options?.replyMarkup,
-          transcriptText,
         });
         return;
       } catch (error) {

package/node_modules/@llblab/pi-telegram/lib/polling.ts

@@ -8,7 +8,6 @@ type MaybePromise<T> = T | Promise<T>;
 
 export interface TelegramPollingConfig {
   botToken?: string;
-  lastUpdateId?: number;
 }
 
 export interface TelegramUpdate {
@@ -227,6 +226,7 @@ export interface TelegramPollingAdmissionRuntime<TContext> {
 
 export function createTelegramPollingAdmissionRuntime<TContext>(deps: {
   polling: TelegramPollingController<TContext>;
+  prepareStart?: () => MaybePromise<void>;
   validateStart?: () => void;
   worker: {
     onSessionStart: (ctx: TContext) => Promise<void>;
@@ -235,6 +235,7 @@ export function createTelegramPollingAdmissionRuntime<TContext>(deps: {
   return {
     isActive: deps.polling.isActive,
     async start(ctx) {
+      await deps.prepareStart?.();
       deps.validateStart?.();
       await deps.worker.onSessionStart(ctx);
       await deps.polling.start(ctx);
@@ -256,7 +257,12 @@ export type TelegramDurablePollingRuntimeAssemblyDeps<
   "appendUpdateBatch" | "getJournalEntryCount" | "signalUpdateWorker"
 > & {
   journal: {
-    appendBatch: (updates: readonly TUpdate[]) => MaybePromise<unknown>;
+    appendBatch: (
+      updates: readonly TUpdate[],
+      acceptedThroughUpdateId?: number,
+    ) => MaybePromise<unknown>;
+    getAcceptedThroughUpdateId: () => number | undefined;
+    prepareCursorCutover?: () => MaybePromise<void>;
     getEntryCount: () => number;
     signalWorker: () => void;
     getBootstrapEntryCount: () => number;
@@ -274,13 +280,15 @@ export function createTelegramDurablePollingRuntimeAssembly<
   const controller = createTelegramPollingControllerRuntime({
     ...deps,
     appendUpdateBatch: deps.journal.appendBatch,
+    getAcceptedThroughUpdateId: deps.journal.getAcceptedThroughUpdateId,
     getJournalEntryCount: deps.journal.getEntryCount,
     signalUpdateWorker: deps.journal.signalWorker,
   });
   const admission = createTelegramPollingAdmissionRuntime({
     polling: controller,
+    prepareStart: deps.journal.prepareCursorCutover,
     validateStart() {
-      if (deps.getConfig().lastUpdateId !== undefined) return;
+      if (deps.journal.getAcceptedThroughUpdateId() !== undefined) return;
       if (deps.journal.getBootstrapEntryCount() === 0) return;
       throw new TelegramPollingCursorBootstrapError(
         "Telegram polling cursor is missing while the durable update journal is non-empty.",
@@ -356,6 +364,7 @@ export function createTelegramPollingControllerRuntime<
       getUpdatesRequestBudgetMs: deps.getUpdatesRequestBudgetMs,
       persistConfig: deps.persistConfig,
       appendUpdateBatch: deps.appendUpdateBatch,
+      getAcceptedThroughUpdateId: deps.getAcceptedThroughUpdateId,
       getJournalEntryCount: deps.getJournalEntryCount,
       signalUpdateWorker: deps.signalUpdateWorker,
       prepareUpdateBatch: deps.prepareUpdateBatch,
@@ -1185,6 +1194,32 @@ export class TelegramPollingCursorBootstrapError extends Error {
   }
 }
 
+export interface TelegramPollingCursorCutoverDeps {
+  getLegacyCursor: () => number | undefined;
+  readJournal: () => {
+    acceptedThroughUpdateId?: number;
+    entries: readonly { updateId: number }[];
+  };
+  publishJournalCursor: (acceptedThroughUpdateId: number) => MaybePromise<void>;
+  removeLegacyCursor: () => MaybePromise<void>;
+}
+
+/** Transfer one legacy config cursor into journal authority before deleting it. */
+export async function cutOverTelegramPollingCursor(
+  deps: TelegramPollingCursorCutoverDeps,
+): Promise<void> {
+  const legacyCursor = deps.getLegacyCursor();
+  if (legacyCursor === undefined) return;
+  const snapshot = deps.readJournal();
+  if (snapshot.acceptedThroughUpdateId === undefined) {
+    const provenEntryCursor = snapshot.entries.at(-1)?.updateId;
+    await deps.publishJournalCursor(
+      Math.max(legacyCursor, provenEntryCursor ?? legacyCursor),
+    );
+  }
+  await deps.removeLegacyCursor();
+}
+
 export interface TelegramPollingBatchAdmissionResult {
   updateCount: number;
   latestUpdateId?: number;
@@ -1195,7 +1230,11 @@ export interface TelegramPollingBatchAdmissionDeps<
 > extends TelegramRuntimeEventRecorderPort {
   updates: readonly TUpdate[];
   config: TelegramPollingConfig;
-  appendBatch: (updates: readonly TUpdate[]) => MaybePromise<unknown>;
+  appendBatch: (
+    updates: readonly TUpdate[],
+    acceptedThroughUpdateId?: number,
+  ) => MaybePromise<unknown>;
+  getAcceptedThroughUpdateId?: () => number | undefined;
   persistConfig: (config: TelegramPollingConfig) => Promise<void>;
   signalWorker: () => void;
   onPhaseChange?: (
@@ -1229,7 +1268,8 @@ export async function admitTelegramPollingUpdateBatch<
   deps: TelegramPollingBatchAdmissionDeps<TUpdate>,
 ): Promise<TelegramPollingBatchAdmissionResult> {
   if (deps.updates.length === 0) return { updateCount: 0 };
-  validateTelegramPollingBatch(deps.updates, deps.config.lastUpdateId);
+  const acceptedThroughUpdateId = deps.getAcceptedThroughUpdateId?.();
+  validateTelegramPollingBatch(deps.updates, acceptedThroughUpdateId);
   const latestUpdateId = getLatestTelegramUpdateId(deps.updates);
   if (latestUpdateId === undefined) return { updateCount: 0 };
   reportTelegramPollingPhase(
@@ -1237,18 +1277,7 @@ export async function admitTelegramPollingUpdateBatch<
     "persisting-journal",
     deps.updates[0]?.update_id,
   );
-  await deps.appendBatch(deps.updates);
-  reportTelegramPollingPhase(deps, "persisting-offset", latestUpdateId);
-  const previousUpdateId = deps.config.lastUpdateId;
-  deps.config.lastUpdateId = latestUpdateId;
-  try {
-    await deps.persistConfig(deps.config);
-  } catch (error) {
-    if (deps.config.lastUpdateId === latestUpdateId) {
-      deps.config.lastUpdateId = previousUpdateId;
-    }
-    throw error;
-  }
+  await deps.appendBatch(deps.updates, latestUpdateId);
   try {
     deps.signalWorker();
   } catch (error) {
@@ -1275,7 +1304,11 @@ export interface TelegramPollLoopDeps<
   ) => Promise<TUpdate[]>;
   getUpdatesRequestBudgetMs?: (body: Record<string, unknown>) => number;
   persistConfig: (config: TelegramPollingConfig) => Promise<void>;
-  appendUpdateBatch: (updates: readonly TUpdate[]) => MaybePromise<unknown>;
+  appendUpdateBatch: (
+    updates: readonly TUpdate[],
+    acceptedThroughUpdateId?: number,
+  ) => MaybePromise<unknown>;
+  getAcceptedThroughUpdateId?: () => number | undefined;
   getJournalEntryCount: () => number;
   signalUpdateWorker: () => void;
   prepareUpdateBatch?: (updates: readonly TUpdate[]) => void;
@@ -1301,7 +1334,11 @@ export interface TelegramPollLoopRunnerDeps<
   ) => Promise<TUpdate[]>;
   getUpdatesRequestBudgetMs?: (body: Record<string, unknown>) => number;
   persistConfig: (config: TelegramPollingConfig) => Promise<void>;
-  appendUpdateBatch: (updates: readonly TUpdate[]) => MaybePromise<unknown>;
+  appendUpdateBatch: (
+    updates: readonly TUpdate[],
+    acceptedThroughUpdateId?: number,
+  ) => MaybePromise<unknown>;
+  getAcceptedThroughUpdateId?: () => number | undefined;
   getJournalEntryCount: () => number;
   signalUpdateWorker: () => void;
   prepareUpdateBatch?: (updates: readonly TUpdate[]) => void;
@@ -1356,6 +1393,7 @@ export function createTelegramPollLoopRunner<
       getUpdatesRequestBudgetMs: deps.getUpdatesRequestBudgetMs,
       persistConfig: deps.persistConfig,
       appendUpdateBatch: deps.appendUpdateBatch,
+      getAcceptedThroughUpdateId: deps.getAcceptedThroughUpdateId,
       getJournalEntryCount: deps.getJournalEntryCount,
       signalUpdateWorker: deps.signalUpdateWorker,
       prepareUpdateBatch: deps.prepareUpdateBatch,
@@ -1494,14 +1532,16 @@ export async function runTelegramPollLoop<
     // ignore
   }
   if (
-    deps.config.lastUpdateId === undefined &&
+    deps.getAcceptedThroughUpdateId?.() === undefined &&
     deps.getJournalEntryCount() > 0
   ) {
     throw new TelegramPollingCursorBootstrapError(
       "Telegram polling cursor is missing while the durable update journal is non-empty.",
     );
   }
-  if (deps.config.lastUpdateId === undefined) {
+  if (
+    deps.getAcceptedThroughUpdateId?.() === undefined
+  ) {
     try {
       const request = buildTelegramInitialSyncRequest();
       reportTelegramPollingPhase(deps, "long-poll");
@@ -1514,8 +1554,7 @@ export async function runTelegramPollLoop<
           "persisting-offset",
           lastUpdateId,
         );
-        deps.config.lastUpdateId = lastUpdateId;
-        await deps.persistConfig(deps.config);
+        await deps.appendUpdateBatch([], lastUpdateId);
         deps.recordRuntimeEvent?.(
           "polling",
           new Error("Initialized Telegram cursor without executing history."),
@@ -1538,7 +1577,9 @@ export async function runTelegramPollLoop<
   while (!deps.signal.aborted) {
     try {
       currentUpdateId = undefined;
-      const request = buildTelegramLongPollRequest(deps.config.lastUpdateId);
+      const request = buildTelegramLongPollRequest(
+        deps.getAcceptedThroughUpdateId?.(),
+      );
       reportTelegramPollingPhase(deps, "long-poll");
       const updates = await requestTelegramUpdatesWithinBudget(deps, request);
       reportTelegramPollingResponse(deps, updates.length);
@@ -1549,6 +1590,7 @@ export async function runTelegramPollLoop<
         updates,
         config: deps.config,
         appendBatch: deps.appendUpdateBatch,
+        getAcceptedThroughUpdateId: deps.getAcceptedThroughUpdateId,
         persistConfig: deps.persistConfig,
         signalWorker: deps.signalUpdateWorker,
         onPhaseChange: deps.onPhaseChange,

package/node_modules/@llblab/pi-telegram/lib/setup.ts

@@ -9,7 +9,6 @@ export interface TelegramSetupConfig {
   botId?: number;
   botUsername?: string;
   allowedUserId?: number;
-  lastUpdateId?: number;
 }
 
 export interface TelegramBotTokenPromptSpec {

package/node_modules/@llblab/pi-telegram/lib/status.ts

@@ -321,7 +321,6 @@ export interface TelegramBridgeStatusConfig {
   botToken?: string;
   botUsername?: string;
   allowedUserId?: number;
-  lastUpdateId?: number;
 }
 
 export interface TelegramBridgeStatusRuntimeDeps<
@@ -337,6 +336,7 @@ export interface TelegramBridgeStatusRuntimeDeps<
   isPollingActive: () => boolean;
   getPollingState?: () => TelegramBridgePollingState;
   getInboundWorkerState?: () => TelegramBridgeInboundWorkerState | undefined;
+  getAcceptedThroughUpdateId?: () => number | undefined;
   getActiveSourceMessageIds: () => number[] | undefined;
   hasActiveTurn: () => boolean;
   hasDispatchPending: () => boolean;
@@ -717,7 +717,7 @@ export function createTelegramBridgeStatusRuntime<
         ...(deps.getInboundWorkerState
           ? { inboundWorker: deps.getInboundWorkerState() }
           : {}),
-        lastUpdateId: config.lastUpdateId,
+        lastUpdateId: deps.getAcceptedThroughUpdateId?.(),
         activeSourceMessageIds: deps.getActiveSourceMessageIds(),
         pendingDispatch: deps.hasDispatchPending(),
         compactionInProgress: deps.isCompactionInProgress(),