appback-remoteagent 0.14.0 → 0.14.2

package/.env.example

@@ -7,6 +7,7 @@ TELEGRAM_EMPTY_RESPONSE_RETRIES=1
 TELEGRAM_RETRYABLE_ERROR_RETRIES=2
 TELEGRAM_RETRYABLE_ERROR_DELAY_MS=5000
 TELEGRAM_UNTAGGED_INTENT_RETRIES=2
+TELEGRAM_POLLING_MAX_CONCURRENCY=8
 TELEGRAM_SCHEDULER_TICK_MS=1000
 TELEGRAM_TIERED_POLLING_MIN_BOTS=5
 TELEGRAM_ACTIVE_POLL_INTERVAL_MS=3000

package/dist/config.js

@@ -133,7 +133,7 @@ export const config = {
     telegramCommandMenuEnabled: readBoolean("TELEGRAM_COMMAND_MENU_ENABLED", true),
     telegramPollingBackoffMinMs: readTimeout("TELEGRAM_POLLING_BACKOFF_MIN_MS", 60_000),
     telegramPollingBackoffMaxMs: readTimeout("TELEGRAM_POLLING_BACKOFF_MAX_MS", 900_000),
-    telegramPollingMaxConcurrency: readTimeout("TELEGRAM_POLLING_MAX_CONCURRENCY", 3),
+    telegramPollingMaxConcurrency: readTimeout("TELEGRAM_POLLING_MAX_CONCURRENCY", 8),
     telegramSchedulerTickMs: readTimeout("TELEGRAM_SCHEDULER_TICK_MS", 1000),
     telegramTieredPollingMinBots: readTimeout("TELEGRAM_TIERED_POLLING_MIN_BOTS", 5),
     telegramActivePollIntervalMs: readTimeout("TELEGRAM_ACTIVE_POLL_INTERVAL_MS", 3000),

package/dist/index.js

@@ -161,28 +161,35 @@ async function startManualPollingScheduler(bots) {
         let activePolls = [...runtimeStates.values()].filter((state) => state.inFlight).length;
         const pollingStates = await botPollingState.list();
         const rankByBotId = computeRecentMessageRanks(botIds, pollingStates);
-        for (const bot of pollingBots) {
-            if (activePolls >= config.telegramPollingMaxConcurrency) {
-                break;
-            }
+        const dueBots = pollingBots
+            .map((bot) => {
             const botId = String(bot.botInfo.id);
             const runtime = runtimeStates.get(botId);
-            if (!runtime || runtime.inFlight) {
-                continue;
-            }
-            const state = await botPollingState.get(botId, bot.botInfo.username);
-            const nextPollAt = state.nextPollAt ? Date.parse(state.nextPollAt) : 0;
-            if (Number.isFinite(nextPollAt) && nextPollAt > now) {
-                continue;
+            const state = pollingStates[botId];
+            const nextPollAt = state?.nextPollAt ? Date.parse(state.nextPollAt) : 0;
+            return {
+                bot,
+                botId,
+                runtime,
+                state,
+                rank: rankByBotId.get(botId) ?? pollingBots.length,
+                nextPollAt: Number.isFinite(nextPollAt) ? nextPollAt : 0,
+            };
+        })
+            .filter((entry) => entry.runtime && !entry.runtime.inFlight && entry.nextPollAt <= now)
+            .sort((left, right) => left.nextPollAt - right.nextPollAt || left.rank - right.rank);
+        for (const entry of dueBots) {
+            if (activePolls >= config.telegramPollingMaxConcurrency) {
+                break;
             }
-            runtime.inFlight = true;
+            entry.runtime.inFlight = true;
             activePolls += 1;
-            void pollTelegramBot(bot, runtime, {
+            void pollTelegramBot(entry.bot, entry.runtime, {
                 totalBots: pollingBots.length,
-                botRank: rankByBotId.get(botId) ?? pollingBots.length,
-                state,
+                botRank: entry.rank,
+                state: entry.state,
             }).finally(() => {
-                runtime.inFlight = false;
+                entry.runtime.inFlight = false;
             });
         }
         await sleep(config.telegramSchedulerTickMs);

package/dist/services/polling-policy.js

@@ -2,10 +2,7 @@ export function computeRecentMessageRanks(botIds, states) {
     const ranked = botIds
         .map((botId) => ({
         botId,
-        timestamp: parseStateTime(states[botId]?.lastMessageAt)
-            ?? parseStateTime(states[botId]?.lastUpdateAt)
-            ?? parseStateTime(states[botId]?.lastPollAt)
-            ?? 0,
+        timestamp: parseStateTime(states[botId]?.lastMessageAt) ?? 0,
     }))
         .sort((left, right) => right.timestamp - left.timestamp);
     return new Map(ranked.map((entry, index) => [entry.botId, index + 1]));

package/docs/BOT_POLLING_POLICY.md

@@ -30,3 +30,4 @@ RemoteAgent no longer uses deep sleep, wake, or a special main bot for polling c
 - `/bot doctor` removes bots that Telegram reports as permanently dead.
 - `/bot remove <username|id>` removes a configured bot from the runtime.
 - Polling state is stored by Telegram bot id, not by display order.
+- The default polling concurrency is 8 because Telegram long polling can hold each request for up to 30 seconds. Lower values can make later bots look unresponsive when many bots are configured.

package/docs/RELEASING.md

@@ -28,7 +28,7 @@ A release is only considered complete when all of the following are done in orde
 4. Run `npm run build`
 5. Commit the completed work
 6. Push `main` to `origin/main`
-7. Publish `appback-remoteagent@<version>` to npm
+7. Publish `appback-remoteagent@<version>` to npm from server 30's npm credentials
 8. Install that exact npm version on server 30 and server 26
 9. Restart `remoteagent.service` on each target if runtime code changed
 10. Verify the relevant runtime path, logs, or Telegram behavior on each target
@@ -64,18 +64,65 @@ git status
 git add -A
 git commit -m "Release 0.12.3"
 git push origin main
-npm publish
+npm pack
 ```
 
-Typical target deployment sequence for server 30 and server 26:
+## npm publish procedure
+
+Use this package-specific path for `appback-remoteagent`.
+
+Do not publish this package from machine 21 with the `21token`. That token is scoped for `@appbackhub` packages and cannot publish the unscoped `appback-remoteagent` package. It can authenticate but `npm publish` fails with:
+
+```text
+403 Forbidden - You may not perform that action with these credentials.
+```
+
+The successful publish path is:
 
 ```bash
-VERSION=0.13.0
+VERSION=0.14.0
+npm pack
+scp appback-remoteagent-$VERSION.tgz au2223@192.168.0.30:/tmp/appback-remoteagent-$VERSION.tgz
+ssh au2223@192.168.0.30 "bash -lc 'npm publish /tmp/appback-remoteagent-$VERSION.tgz'"
+npm view appback-remoteagent version
+ssh au2223@192.168.0.30 'bash -lc "npm view appback-remoteagent version"'
+rm -f appback-remoteagent-$VERSION.tgz
+ssh au2223@192.168.0.30 "rm -f /tmp/appback-remoteagent-$VERSION.tgz"
+```
+
+If registry caching briefly returns the previous version after publish, wait a few seconds and rerun `npm view appback-remoteagent version` before installing to servers.
+
+## Target deployment sequence
+
+Server 30 uses a systemd service:
+
+```bash
+VERSION=0.14.0
+ssh au2223@192.168.0.30 "VERSION=$VERSION bash -s" <<'REMOTE'
+set -euo pipefail
+sudo -n env "PATH=$PATH" npm install -g appback-remoteagent@$VERSION
+/home/au2223/.nvm/versions/node/v22.22.0/bin/remoteagent-install
+sudo -n systemctl restart remoteagent
+systemctl is-active remoteagent
+journalctl -u remoteagent --since '2 minutes ago' --no-pager
+REMOTE
+```
+
+Server 26 currently uses user-level start/stop scripts, not a systemd `remoteagent.service`:
+
+```bash
+VERSION=0.14.0
+ssh ospadmin@192.168.0.26 "VERSION=$VERSION bash -s" <<'REMOTE'
+set -euo pipefail
 npm install -g appback-remoteagent@$VERSION
 remoteagent-install
-sudo systemctl restart remoteagent
-systemctl is-active remoteagent
-journalctl -u remoteagent --since "2 minutes ago" --no-pager
+~/.remoteagent/stop-remoteagent.sh || true
+sleep 2
+~/.remoteagent/start-remoteagent.sh
+sleep 3
+pgrep -af "appback-remoteagent/dist/index.js"
+tail -80 ~/.remoteagent/logs/agent.log
+REMOTE
 ```
 
 ## Other Runtime Follow-up

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appback-remoteagent",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "Personal installable session server for continuing local AI work across PC and Telegram",
   "license": "MIT",
   "type": "module",