@blunking/codexlink 0.1.2 → 0.1.9

package/README.md

@@ -11,15 +11,16 @@
 
 CodexLink is the BLUN launcher for one visible CLI session with optional Telegram delivery.
 
-It keeps transport and queueing around the operator, without spinning up a hidden second session.
-
-Telegram delivery is serial by default:
-
-- inbound messages land in queue first
-- active work is not interrupted immediately
-- direct messages wait until the visible session is quiet
-- ambient group noise stays queued until it is relevant or manually drained
-- escalation-style messages can still jump the line
+It keeps transport and queueing around the operator, without spinning up a hidden second session.
+
+Telegram delivery is serial by default:
+
+- inbound messages land in queue first
+- active work is not interrupted immediately
+- direct messages wait until the visible session is quiet
+- ambient group noise stays queued until it is relevant or manually drained
+- escalation-style messages can still jump the line
+- stale pending replies time out automatically, so the queue cannot block forever
 
 ## Install
 
@@ -108,7 +109,18 @@ Status:
 blun-codex telegram-status
 ```
 
-Doctor:
+Wenn waehrend einer laufenden Arbeit Telegram-Nachrichten gepuffert werden, bleibt die sichtbare CLI-Eingabe unberuehrt. Pending-Nachrichten bleiben im Fenstertitel/Status sichtbar, bis die Antwort raus ist oder sie wirklich ablaufen. Den Queue-Stand kannst du jederzeit mit `blun-codex telegram-status` pruefen.
+
+Der automatische Progress-Hinweis ist bewusst defensiv: standardmaessig sendet Telegram nur finale Antworten plus bei laengeren echten Arbeitslaeufen einen neutralen Status. Interne Commentary-Texte werden nicht als zweite fachliche Antwort gespiegelt. Wer das alte Verhalten will, kann `BLUN_TELEGRAM_PROGRESS_RELAY=commentary` setzen; mit `off` werden Progress-Hinweise ganz deaktiviert.
+
+Wenn mehrere Agents denselben Gruppenchat nutzen, kann ein Agent andere Agent-Namen als Fremdroute markieren. Dann werden Owner-Nachrichten wie `Frida mach weiter` nicht in Ottos Session gezogen:
+
+```text
+BLUN_TELEGRAM_MENTION_NAMES=otto
+BLUN_TELEGRAM_OTHER_AGENT_NAMES=frida,angel,dieter,alfred
+```
+
+Doctor:
 
 ```powershell
 blun-codex telegram-doctor
@@ -160,39 +172,39 @@ Why this matters:
 - starting a second operator on `default` will replace the first `default` runtime
 - a private profile gives that operator a separate runtime slot, state directory, and Mnemo binding
 
-For internal/private profiles:
-
-- keep the profile local on the machine
-- give it its own `agent_name`
-- give it its own Telegram state directory
-- do not ship internal agent profiles in the public package
-
-Local private profiles are loaded from:
-
-```text
-%USERPROFILE%\.codex\profiles\codexlink\<name>.json
-```
-
-Example:
-
-```powershell
-blun-codex --profile frida telegram-plugin
-```
-
-looks for:
-
-```text
-%USERPROFILE%\.codex\profiles\codexlink\frida.json
-```
+For internal/private profiles:
+
+- keep the profile local on the machine
+- give it its own `agent_name`
+- give it its own Telegram state directory
+- do not ship internal agent profiles in the public package
+
+Local private profiles are loaded from:
+
+```text
+%USERPROFILE%\.codex\profiles\codexlink\<name>.json
+```
+
+Example:
+
+```powershell
+blun-codex --profile frida telegram-plugin
+```
+
+looks for:
+
+```text
+%USERPROFILE%\.codex\profiles\codexlink\frida.json
+```
 
 ## What it does
 
 - starts one consistent local CLI runtime
 - writes a launch record into `.codex/runtimes/default/`
 - keeps Telegram queue state under `.codex/channels/telegram-default/`
-- attaches Telegram delivery to the same visible session
-- defers automatic Telegram delivery until the foreground session is idle
-- keeps poller, dispatcher, and reply relay separate from the foreground operator
+- attaches Telegram delivery to the same visible session
+- defers automatic Telegram delivery until the foreground session is idle
+- keeps poller, dispatcher, and reply relay separate from the foreground operator
 
 ## What it does not do
 
@@ -232,10 +244,16 @@ The bundled plugin lives under `telegram-plugin/` and contains:
 `blun-codex telegram-plugin` now behaves like a guided setup for normal users:
 
 1. check whether Telegram is already configured
-2. ask for missing Bot Token or allowed Chat ID(s)
+2. ask only for a missing Bot Token
 3. save everything automatically into the local Telegram state folder
 4. continue into Telegram mode
 
+Allowed Chat ID(s) are optional. If you leave them unset, the bot can currently accept any chat it can see. You can tighten that later with:
+
+```powershell
+blun-codex telegram-setup
+```
+
 If something is missing later, `blun-codex telegram-doctor` tells you exactly what is missing and what to run next.
 
 ## Notes

package/package.json

@@ -1,38 +1,40 @@
-{
-  "name": "@blunking/codexlink",
-  "version": "0.1.2",
-  "description": "BLUN CLI launcher with Telegram channel support for one visible session.",
-  "license": "MIT",
-  "private": false,
-  "bin": {
-    "blun-codex": "./bin/blun-codex.js",
-    "codexlink": "./bin/blun-codex.js"
-  },
-  "files": [
-    "bin/",
-    "profiles/default.json",
-    "telegram-plugin/",
-    "README.md",
-    "LICENSE",
-    "blun-codex.cmd",
-    "blun-codex.ps1",
-    "start-codex-agent.ps1",
-    "start-codex.cmd",
-    "telegram-status.ps1",
-    "telegram-doctor.ps1",
-    "telegram-setup.ps1"
-  ],
-  "keywords": [
-    "blun",
-    "codexlink",
-    "telegram",
-    "runtime",
-    "cli"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "@blunking/codexlink",
+  "version": "0.1.9",
+  "description": "BLUN CLI launcher with Telegram channel support for one visible session.",
+  "license": "MIT",
+  "private": false,
+  "bin": {
+    "blun-codex": "bin/blun-codex.js",
+    "codexlink": "bin/blun-codex.js"
+  },
+  "files": [
+    "bin/",
+    "profiles/default.json",
+    "telegram-plugin/",
+    "README.md",
+    "LICENSE",
+    "blun-codex.cmd",
+    "blun-codex.ps1",
+    "start-codex-agent.ps1",
+    "start-codex.cmd",
+    "telegram-title-embed.ps1",
+    "telegram-status.ps1",
+    "telegram-doctor.ps1",
+    "telegram-setup.ps1",
+    "telegram-title-watcher.ps1"
+  ],
+  "keywords": [
+    "blun",
+    "codexlink",
+    "telegram",
+    "runtime",
+    "cli"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/start-codex-agent.ps1

@@ -21,42 +21,42 @@ function Get-JsonFile {
   return Get-Content -Raw -Path $Path | ConvertFrom-Json
 }
 
-function Try-GetJsonFile {
-  param([string]$Path)
-  if (-not (Test-Path $Path)) {
-    return $null
+function Try-GetJsonFile {
+  param([string]$Path)
+  if (-not (Test-Path $Path)) {
+    return $null
   }
   try {
     return Get-Content -Raw -Path $Path | ConvertFrom-Json
   } catch {
     return $null
-  }
-}
-
-function Get-ProfilePath {
-  param(
-    [string]$RuntimeRoot,
-    [string]$ProfileName
-  )
-
-  $normalized = [string]$ProfileName
-  if (-not $normalized) { $normalized = "" }
-  $normalized = $normalized.ToLower()
-  $candidates = @()
-  if ($env:BLUN_CODEX_PROFILE_ROOT) {
-    $candidates += (Join-Path $env:BLUN_CODEX_PROFILE_ROOT ($normalized + ".json"))
-  }
-  $candidates += (Join-Path $env:USERPROFILE (".codex\\profiles\\codexlink\\" + $normalized + ".json"))
-  $candidates += (Join-Path $RuntimeRoot ("profiles\\" + $normalized + ".json"))
-
-  foreach ($candidate in $candidates) {
-    if ($candidate -and (Test-Path $candidate)) {
-      return $candidate
-    }
-  }
-
-  return $candidates[-1]
-}
+  }
+}
+
+function Get-ProfilePath {
+  param(
+    [string]$RuntimeRoot,
+    [string]$ProfileName
+  )
+
+  $normalized = [string]$ProfileName
+  if (-not $normalized) { $normalized = "" }
+  $normalized = $normalized.ToLower()
+  $candidates = @()
+  if ($env:BLUN_CODEX_PROFILE_ROOT) {
+    $candidates += (Join-Path $env:BLUN_CODEX_PROFILE_ROOT ($normalized + ".json"))
+  }
+  $candidates += (Join-Path $env:USERPROFILE (".codex\\profiles\\codexlink\\" + $normalized + ".json"))
+  $candidates += (Join-Path $RuntimeRoot ("profiles\\" + $normalized + ".json"))
+
+  foreach ($candidate in $candidates) {
+    if ($candidate -and (Test-Path $candidate)) {
+      return $candidate
+    }
+  }
+
+  return $candidates[-1]
+}
 
 function Ensure-Dir {
   param([string]$Path)
@@ -113,7 +113,7 @@ function Get-FreeTcpPort {
   }
 }
 
-function Stop-ProcessTree {
+function Stop-ProcessTree {
   param([int[]]$RootIds)
 
   $all = @(Get-CimInstance Win32_Process)
@@ -144,9 +144,9 @@ function Stop-ProcessTree {
     } catch {
     }
   }
-}
-
-function Wait-TcpPort {
+}
+
+function Wait-TcpPort {
   param(
     [string]$HostName,
     [int]$Port,
@@ -301,8 +301,8 @@ function Quote-PowerShellLiteral {
 }
 
 $runtimeRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
-$profilePath = Get-ProfilePath -RuntimeRoot $runtimeRoot -ProfileName $Agent
-$profile = Get-JsonFile -Path $profilePath
+$profilePath = Get-ProfilePath -RuntimeRoot $runtimeRoot -ProfileName $Agent
+$profile = Get-JsonFile -Path $profilePath
 
 $resolvedWorkspace = if ($Workspace) { $Workspace } elseif ($profile.workspace) { $profile.workspace } else { (Get-Location).Path }
 $resolvedWorkspace = Resolve-ConfiguredPath -Value $resolvedWorkspace
@@ -527,13 +527,24 @@ if ($useRemoteAppServer) {
     if ($telegramAllowedChatId) {
       $stateEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"] = $telegramAllowedChatId
     }
-    $stateEnv["BLUN_TELEGRAM_PLUGIN_MODE"] = $TelegramMode
-    $stateEnv["BLUN_TELEGRAM_APP_SERVER_WS_URL"] = $telegramAppServerWsUrl
-    $stateEnv["BLUN_TELEGRAM_THREAD_ID"] = ""
-    Write-DotEnvFile -Path $envFilePath -Values $stateEnv
-    Write-DebugStage -Path $debugLogPath -Message ("ENV_WRITTEN ws_url=" + $telegramAppServerWsUrl + " env_file=" + $envFilePath)
-
-    Set-EnvVar "BLUN_TELEGRAM_APP_SERVER_WS_URL" $telegramAppServerWsUrl
+    $stateEnv["BLUN_TELEGRAM_PLUGIN_MODE"] = $TelegramMode
+    $stateEnv["BLUN_TELEGRAM_APP_SERVER_WS_URL"] = $telegramAppServerWsUrl
+    $stateEnv["BLUN_TELEGRAM_THREAD_ID"] = ""
+    Write-DotEnvFile -Path $envFilePath -Values $stateEnv
+    Write-DebugStage -Path $debugLogPath -Message ("ENV_WRITTEN ws_url=" + $telegramAppServerWsUrl + " env_file=" + $envFilePath)
+    $telegramStateFile = Join-Path $telegramStateDir "state.json"
+    $telegramState = Try-GetJsonFile -Path $telegramStateFile
+    if ($null -ne $telegramState) {
+      if ($telegramState.PSObject.Properties.Name.Contains("currentThreadId")) {
+        $telegramState.currentThreadId = ""
+      } else {
+        $telegramState | Add-Member -NotePropertyName "currentThreadId" -NotePropertyValue ""
+      }
+      Write-TextFileWithRetry -Path $telegramStateFile -Content ($telegramState | ConvertTo-Json -Depth 10)
+      Write-DebugStage -Path $debugLogPath -Message "STATE_THREAD_CLEARED"
+    }
+
+    Set-EnvVar "BLUN_TELEGRAM_APP_SERVER_WS_URL" $telegramAppServerWsUrl
 
     $appServerPidFile = Join-Path $agentRuntimeDir "app-server.pid"
     $appServerInfoFile = Join-Path $agentRuntimeDir "app-server.json"
@@ -545,6 +556,7 @@ if ($useRemoteAppServer) {
       $oldPids = @()
       if ($previousRuntime.frontend_host_pid) { $oldPids += [int]$previousRuntime.frontend_host_pid }
       if ($previousRuntime.app_server_pid) { $oldPids += [int]$previousRuntime.app_server_pid }
+      if ($previousRuntime.queue_notifier_pid) { $oldPids += [int]$previousRuntime.queue_notifier_pid }
       if ($previousRuntime.poller_pid) { $oldPids += [int]$previousRuntime.poller_pid }
       if ($previousRuntime.dispatcher_pid) { $oldPids += [int]$previousRuntime.dispatcher_pid }
       if ($previousRuntime.responder_pid) { $oldPids += [int]$previousRuntime.responder_pid }
@@ -666,26 +678,57 @@ if ($PrintOnly) {
 if ($useRemoteAppServer) {
   $codexScript = (Get-Command codex).Source
   $currentRuntimeFile = Join-Path $agentRuntimeDir "current-remote-runtime.json"
-  $windowTitle = "BLUN Codex Telegram [" + $profile.agent_name + "] " + $telegramAppServerWsUrl
-  $resumeCommand = "$host.UI.RawUI.WindowTitle = " + (Quote-PowerShellLiteral $windowTitle) + "; & " + (Quote-PowerShellLiteral $codexScript) + " " + (($codexArgs | ForEach-Object { Quote-PowerShellLiteral $_ }) -join " ")
+  $windowTitle = "BLUN Codex Telegram [" + $profile.agent_name + "] " + $telegramAppServerWsUrl
+  $titleEmbedScript = Join-Path $runtimeRoot "telegram-title-embed.ps1"
+  $titleEmbedLog = Join-Path $agentRuntimeDir "title-embed.log"
+  $resumeCommand = ""
+  if (Test-Path $titleEmbedScript) {
+    $resumeCommand += "& " + (Quote-PowerShellLiteral $titleEmbedScript)
+    $resumeCommand += " -StateFile " + (Quote-PowerShellLiteral (Join-Path $telegramStateDir "state.json"))
+    $resumeCommand += " -BaseTitle " + (Quote-PowerShellLiteral $windowTitle)
+    $resumeCommand += " -LogFile " + (Quote-PowerShellLiteral $titleEmbedLog)
+    $resumeCommand += "; "
+  }
+  $resumeCommand += "$host.UI.RawUI.WindowTitle = " + (Quote-PowerShellLiteral $windowTitle) + "; & " + (Quote-PowerShellLiteral $codexScript) + " " + (($codexArgs | ForEach-Object { Quote-PowerShellLiteral $_ }) -join " ")
   Write-DebugStage -Path $debugLogPath -Message ("FRONTEND_SPAWN command=" + $resumeCommand)
   $frontendProcess = Start-Process -FilePath "powershell" -WorkingDirectory $resolvedWorkspace -ArgumentList @(
     "-NoExit",
     "-Command",
     $resumeCommand
   ) -PassThru
-  $currentRuntime = [ordered]@{
-    ws_url = $telegramAppServerWsUrl
-    app_server_pid = $backendProcess.Id
-    frontend_host_pid = $frontendProcess.Id
-    profile = $profile.agent_name
+  $currentRuntime = [ordered]@{
+    ws_url = $telegramAppServerWsUrl
+    app_server_pid = $backendProcess.Id
+    frontend_host_pid = $frontendProcess.Id
+    profile = $profile.agent_name
     started_at = (Get-Date).ToUniversalTime().ToString("o")
-  }
-  Write-TextFileWithRetry -Path $currentRuntimeFile -Content ($currentRuntime | ConvertTo-Json -Depth 4)
-  Write-DebugStage -Path $debugLogPath -Message "FRONTEND_SPAWNED"
-  if ($envFilePath -and $bootstrapScript) {
-    try {
-      Write-DebugStage -Path $debugLogPath -Message "LOADED_THREAD_WAIT_START"
+  }
+  Write-TextFileWithRetry -Path $currentRuntimeFile -Content ($currentRuntime | ConvertTo-Json -Depth 4)
+  Write-DebugStage -Path $debugLogPath -Message "FRONTEND_SPAWNED"
+  $sidecarsStartedEarly = $false
+  if ($sidecarManager) {
+    try {
+      & node $sidecarManager | Out-Null
+      if ($LASTEXITCODE -ne 0) {
+        Write-DebugStage -Path $debugLogPath -Message "SIDECAR_MANAGER_EARLY_FAILED"
+      } else {
+        $sidecarsStartedEarly = $true
+        Write-DebugStage -Path $debugLogPath -Message "SIDECAR_MANAGER_EARLY_OK"
+        $pollerPid = Read-PidFileValue -Path (Join-Path $telegramStateDir "poller.pid")
+        $dispatcherPid = Read-PidFileValue -Path (Join-Path $telegramStateDir "dispatcher.pid")
+        $responderPid = Read-PidFileValue -Path (Join-Path $telegramStateDir "responder.pid")
+        if ($pollerPid -gt 0) { $currentRuntime["poller_pid"] = $pollerPid }
+        if ($dispatcherPid -gt 0) { $currentRuntime["dispatcher_pid"] = $dispatcherPid }
+        if ($responderPid -gt 0) { $currentRuntime["responder_pid"] = $responderPid }
+        Write-TextFileWithRetry -Path $currentRuntimeFile -Content ($currentRuntime | ConvertTo-Json -Depth 6)
+      }
+    } catch {
+      Write-DebugStage -Path $debugLogPath -Message ("SIDECAR_MANAGER_EARLY_ERROR " + $_.Exception.Message)
+    }
+  }
+  if ($envFilePath -and $bootstrapScript) {
+    try {
+      Write-DebugStage -Path $debugLogPath -Message "LOADED_THREAD_WAIT_START"
       $loadedIds = @()
       for ($attempt = 1; $attempt -le 40; $attempt++) {
         $loaded = Invoke-NodeJsonWithRetry -NodeArgs @($bootstrapScript, "list-loaded", "--ws-url", $telegramAppServerWsUrl) -Attempts 1 -DelayMs 0
@@ -697,17 +740,67 @@ if ($useRemoteAppServer) {
         if ($attempt -lt 40) {
           Start-Sleep -Milliseconds 500
         }
-      }
-      if ($loadedIds.Count -gt 0) {
-        $activeThreadId = [string]$loadedIds[$loadedIds.Count - 1]
-        Write-DebugStage -Path $debugLogPath -Message ("LOADED_THREAD_PICKED thread_id=" + $activeThreadId + " count=" + $loadedIds.Count)
-        $stateEnv = Read-DotEnvFile -Path $envFilePath
-        $stateEnv["BLUN_TELEGRAM_THREAD_ID"] = $activeThreadId
-        Write-DotEnvFile -Path $envFilePath -Values $stateEnv
-        Set-EnvVar "BLUN_TELEGRAM_THREAD_ID" $activeThreadId
-        Write-DebugStage -Path $debugLogPath -Message "ENV_THREAD_WRITTEN"
-
-        $currentRuntime["thread_id"] = $activeThreadId
+      }
+      if ($loadedIds.Count -gt 0) {
+        $activeThreadId = [string]$loadedIds[$loadedIds.Count - 1]
+        $bestThreadScore = [double]::NegativeInfinity
+        foreach ($candidate in $loadedIds) {
+          $candidateThreadId = [string]$candidate
+          if ([string]::IsNullOrWhiteSpace($candidateThreadId)) {
+            continue
+          }
+          $threadScore = 0.0
+          try {
+            $candidateInfo = Invoke-NodeJsonWithRetry -NodeArgs @($bootstrapScript, "read-thread", "--ws-url", $telegramAppServerWsUrl, "--thread-id", $candidateThreadId) -Attempts 1 -DelayMs 0
+            $thread = $candidateInfo.response.result.thread
+            if ($null -ne $thread -and $null -ne $thread.createdAt) {
+              $threadScore = [double]$thread.createdAt
+              if ($threadScore -gt 0 -and $threadScore -lt 1000000000000) {
+                $threadScore = $threadScore * 1000
+              }
+            }
+            $threadSource = ""
+            $threadStatusType = ""
+            if ($null -ne $thread -and $null -ne $thread.source) {
+              $threadSource = ([string]$thread.source).ToLowerInvariant()
+            }
+            if ($null -ne $thread -and $null -ne $thread.status -and $null -ne $thread.status.type) {
+              $threadStatusType = ([string]$thread.status.type).ToLowerInvariant()
+            }
+            if ($threadSource -eq "cli" -and $threadStatusType -eq "active") {
+              $threadScore += 1000000000000000
+            } elseif ($threadStatusType -eq "active") {
+              $threadScore += 900000000000000
+            } elseif ($threadSource -eq "cli") {
+              $threadScore += 800000000000000
+            }
+          } catch {
+            $threadScore = 0.0
+          }
+          if ($threadScore -ge $bestThreadScore) {
+            $bestThreadScore = $threadScore
+            $activeThreadId = $candidateThreadId
+          }
+        }
+        Write-DebugStage -Path $debugLogPath -Message ("LOADED_THREAD_PICKED thread_id=" + $activeThreadId + " count=" + $loadedIds.Count + " score=" + $bestThreadScore)
+        $stateEnv = Read-DotEnvFile -Path $envFilePath
+        $stateEnv["BLUN_TELEGRAM_THREAD_ID"] = $activeThreadId
+        Write-DotEnvFile -Path $envFilePath -Values $stateEnv
+        Set-EnvVar "BLUN_TELEGRAM_THREAD_ID" $activeThreadId
+        Write-DebugStage -Path $debugLogPath -Message "ENV_THREAD_WRITTEN"
+
+        $telegramState = Try-GetJsonFile -Path (Join-Path $telegramStateDir "state.json")
+        if ($null -ne $telegramState) {
+          if ($telegramState.PSObject.Properties.Name.Contains("currentThreadId")) {
+            $telegramState.currentThreadId = $activeThreadId
+          } else {
+            $telegramState | Add-Member -NotePropertyName "currentThreadId" -NotePropertyValue $activeThreadId
+          }
+          Write-TextFileWithRetry -Path (Join-Path $telegramStateDir "state.json") -Content ($telegramState | ConvertTo-Json -Depth 10)
+          Write-DebugStage -Path $debugLogPath -Message "STATE_THREAD_WRITTEN"
+        }
+
+        $currentRuntime["thread_id"] = $activeThreadId
         Write-TextFileWithRetry -Path $currentRuntimeFile -Content ($currentRuntime | ConvertTo-Json -Depth 6)
         Write-DebugStage -Path $debugLogPath -Message "CURRENT_RUNTIME_THREAD_WRITTEN"
 
@@ -749,9 +842,24 @@ if ($useRemoteAppServer) {
         if ($responderPid -gt 0) { $currentRuntime["responder_pid"] = $responderPid }
         Write-TextFileWithRetry -Path $currentRuntimeFile -Content ($currentRuntime | ConvertTo-Json -Depth 6)
         Write-DebugStage -Path $debugLogPath -Message "APP_SERVER_INFO_WRITTEN"
-      } else {
-        Write-DebugStage -Path $debugLogPath -Message "LOADED_THREAD_NONE"
-      }
+      } else {
+        Write-DebugStage -Path $debugLogPath -Message "LOADED_THREAD_NONE"
+        if ($sidecarsStartedEarly) {
+          $remoteSessionInfo = [ordered]@{
+            ws_url = $telegramAppServerWsUrl
+            thread_id = ""
+            pid = $backendProcess.Id
+            started_at = (Get-Date).ToUniversalTime().ToString("o")
+            sidecars = [ordered]@{
+              poller = [ordered]@{ pid = Read-PidFileValue -Path (Join-Path $telegramStateDir "poller.pid") }
+              dispatcher = [ordered]@{ pid = Read-PidFileValue -Path (Join-Path $telegramStateDir "dispatcher.pid") }
+              responder = [ordered]@{ pid = Read-PidFileValue -Path (Join-Path $telegramStateDir "responder.pid") }
+            }
+          }
+          Write-TextFileWithRetry -Path $appServerInfoFile -Content ($remoteSessionInfo | ConvertTo-Json -Depth 6)
+          Write-DebugStage -Path $debugLogPath -Message "APP_SERVER_INFO_WRITTEN_UNBOUND"
+        }
+      }
     } catch {
       Write-DebugStage -Path $debugLogPath -Message ("LOADED_THREAD_ERROR " + $_.Exception.Message)
     }

package/telegram-doctor.ps1

@@ -195,32 +195,46 @@ $legacyEnv = Read-DotEnvFile -Path $legacyEnvPath
 
 $tokenValue = ""
 $tokenSource = ""
-if (Test-TelegramTokenFormat -Value $activeEnv["BLUN_TELEGRAM_BOT_TOKEN"]) {
-  $tokenValue = [string]$activeEnv["BLUN_TELEGRAM_BOT_TOKEN"]
-  $tokenSource = "state env"
-} elseif (Test-TelegramTokenFormat -Value $legacyEnv["BLUN_TELEGRAM_BOT_TOKEN"]) {
-  $tokenValue = [string]$legacyEnv["BLUN_TELEGRAM_BOT_TOKEN"]
-  $tokenSource = "legacy env fallback"
-}
+if (Test-TelegramTokenFormat -Value $activeEnv["BLUN_TELEGRAM_BOT_TOKEN"]) {
+  $tokenValue = [string]$activeEnv["BLUN_TELEGRAM_BOT_TOKEN"]
+  $tokenSource = "state env"
+} elseif (Test-TelegramTokenFormat -Value $activeEnv["TELEGRAM_BOT_TOKEN"]) {
+  $tokenValue = [string]$activeEnv["TELEGRAM_BOT_TOKEN"]
+  $tokenSource = "state env legacy key"
+} elseif (Test-TelegramTokenFormat -Value $legacyEnv["BLUN_TELEGRAM_BOT_TOKEN"]) {
+  $tokenValue = [string]$legacyEnv["BLUN_TELEGRAM_BOT_TOKEN"]
+  $tokenSource = "legacy env fallback"
+} elseif (Test-TelegramTokenFormat -Value $legacyEnv["TELEGRAM_BOT_TOKEN"]) {
+  $tokenValue = [string]$legacyEnv["TELEGRAM_BOT_TOKEN"]
+  $tokenSource = "legacy env fallback legacy key"
+}
 Add-Check -List $checks -Name "bot_token" -Status $(if ($tokenValue) { "ok" } else { "fail" }) -Detail $(if ($tokenValue) { $tokenSource } else { "No valid BLUN_TELEGRAM_BOT_TOKEN found." })
 
 $allowedChatIds = ""
 $allowedChatSource = ""
-if (Test-AllowedChatIdsFormat -Value $activeEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]) {
-  $allowedChatIds = [string]$activeEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]
-  $allowedChatSource = "state env"
-} elseif (Test-AllowedChatIdsFormat -Value $legacyEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]) {
-  $allowedChatIds = [string]$legacyEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]
-  $allowedChatSource = "legacy env fallback"
-}
-Add-Check -List $checks -Name "allowed_chat_ids" -Status $(if ($allowedChatIds) { "ok" } else { "fail" }) -Detail $(if ($allowedChatIds) { $allowedChatIds } else { "No valid BLUN_TELEGRAM_ALLOWED_CHAT_ID found." })
+if (Test-AllowedChatIdsFormat -Value $activeEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]) {
+  $allowedChatIds = [string]$activeEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]
+  $allowedChatSource = "state env"
+} elseif (Test-AllowedChatIdsFormat -Value $activeEnv["TELEGRAM_ALLOWED_CHAT_ID"]) {
+  $allowedChatIds = [string]$activeEnv["TELEGRAM_ALLOWED_CHAT_ID"]
+  $allowedChatSource = "state env legacy key"
+} elseif (Test-AllowedChatIdsFormat -Value $legacyEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]) {
+  $allowedChatIds = [string]$legacyEnv["BLUN_TELEGRAM_ALLOWED_CHAT_ID"]
+  $allowedChatSource = "legacy env fallback"
+} elseif (Test-AllowedChatIdsFormat -Value $legacyEnv["TELEGRAM_ALLOWED_CHAT_ID"]) {
+  $allowedChatIds = [string]$legacyEnv["TELEGRAM_ALLOWED_CHAT_ID"]
+  $allowedChatSource = "legacy env fallback legacy key"
+}
+Add-Check -List $checks -Name "allowed_chat_ids" -Status $(if ($allowedChatIds) { "ok" } else { "warn" }) -Detail $(if ($allowedChatIds) { $allowedChatIds } else { "No allowlist set. Telegram currently accepts any chat the bot can see." })
 
 Add-Check -List $checks -Name "app_server_ws" -Status $(if ($status.active_ws) { "ok" } else { "warn" }) -Detail $(if ($status.active_ws) { $status.active_ws } else { "No active websocket recorded." })
-Add-Check -List $checks -Name "dispatch_mode" -Status $(if ($status.dispatch_mode -eq "deferred") { "ok" } else { "warn" }) -Detail ("mode=" + [string]$status.dispatch_mode + " cooldown_ms=" + [string]$status.idle_cooldown_ms)
+Add-Check -List $checks -Name "dispatch_mode" -Status $(if ($status.dispatch_mode -eq "deferred") { "ok" } else { "warn" }) -Detail ("mode=" + [string]$status.dispatch_mode + " cooldown_ms=" + [string]$status.idle_cooldown_ms + " pending_reply_timeout_ms=" + [string]$status.pending_reply_timeout_ms)
 Add-Check -List $checks -Name "bound_thread" -Status $(if ($status.active_thread_id) { "ok" } else { "warn" }) -Detail $(if ($status.active_thread_id) { $status.active_thread_id } else { "No active thread bound yet." })
-Add-Check -List $checks -Name "poller" -Status $(if ($status.poller_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.poller_pid + " alive=" + [string]$status.poller_alive)
-Add-Check -List $checks -Name "dispatcher" -Status $(if ($status.dispatcher_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.dispatcher_pid + " alive=" + [string]$status.dispatcher_alive)
-Add-Check -List $checks -Name "responder" -Status $(if ($status.responder_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.responder_pid + " alive=" + [string]$status.responder_alive)
+Add-Check -List $checks -Name "frontend_owner" -Status $(if ($status.frontend_owner_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.frontend_owner_pid + " alive=" + [string]$status.frontend_owner_alive)
+Add-Check -List $checks -Name "queue_notifier" -Status $(if (($null -eq $status.queue_notifier_pid) -or ($status.queue_notifier_alive)) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.queue_notifier_pid + " alive=" + [string]$status.queue_notifier_alive)
+Add-Check -List $checks -Name "poller" -Status $(if ($status.poller_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.poller_pid + " alive=" + [string]$status.poller_alive)
+Add-Check -List $checks -Name "dispatcher" -Status $(if ($status.dispatcher_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.dispatcher_pid + " alive=" + [string]$status.dispatcher_alive)
+Add-Check -List $checks -Name "responder" -Status $(if ($status.responder_alive) { "ok" } else { "warn" }) -Detail ("pid=" + [string]$status.responder_pid + " alive=" + [string]$status.responder_alive)
 
 if ($status.last_inbound) {
   $lastInboundSummary = [string]::Format(
@@ -248,7 +262,7 @@ if ($status.last_outbound) {
   Add-Check -List $checks -Name "last_outbound" -Status "warn" -Detail "No outbound Telegram message recorded yet."
 }
 
-Add-Check -List $checks -Name "queue" -Status $(if (([int]$status.queue_depth -eq 0) -and ([int]$status.pending_reply_depth -eq 0)) { "ok" } else { "warn" }) -Detail ("queued=" + $status.queue_depth + " ambient=" + $status.ambient_queue_depth + " submitted=" + $status.submitted_depth + " pending_replies=" + $status.pending_reply_depth)
+Add-Check -List $checks -Name "queue" -Status $(if (([int]$status.queue_depth -eq 0) -and ([int]$status.pending_reply_depth -eq 0)) { "ok" } else { "warn" }) -Detail ("queued=" + $status.queue_depth + " ambient=" + $status.ambient_queue_depth + " parked=" + $status.parked_queue_depth + " submitted=" + $status.submitted_depth + " pending_replies=" + $status.pending_reply_depth + " expired_pending_replies=" + $status.expired_pending_reply_depth)
 
 $result = [ordered]@{
   profile = $status.profile

package/telegram-plugin/.env.example

@@ -7,5 +7,6 @@ BLUN_TELEGRAM_THREAD_ID=
 BLUN_TELEGRAM_RESUME_TIMEOUT_MS=15000
 BLUN_TELEGRAM_IDLE_COOLDOWN_MS=15000
 BLUN_TELEGRAM_DISPATCH_MODE=deferred
+BLUN_TELEGRAM_PROGRESS_RELAY=status
 BLUN_TELEGRAM_POLL_INTERVAL_MS=5000
 BLUN_TELEGRAM_INJECT_INTERVAL_MS=15000

package/telegram-plugin/README.md

@@ -11,6 +11,7 @@ It is intentionally **not** an autonomous answer bot.
 - keeps private chats and group threads separated
 - binds a live thread id
 - injects the next queued Telegram message into that exact live thread only after the session is idle
+- keeps injected Telegram messages visible as pending until the matching answer is sent
 - sends explicit manual replies from the visible operator session
 - keeps ambient group noise queued unless it is relevant to that operator
 - lets escalation-style messages bypass the normal idle queue
@@ -51,6 +52,8 @@ Copy `.env.example` to `.env` in the state directory or export env vars:
 - `BLUN_TELEGRAM_THREAD_ID`
 - `BLUN_TELEGRAM_RESUME_TIMEOUT_MS`
 - `BLUN_TELEGRAM_IDLE_COOLDOWN_MS`
+- `BLUN_TELEGRAM_PENDING_REPLY_TIMEOUT_MS`
+- `BLUN_TELEGRAM_PROGRESS_RELAY` (`status` by default, `commentary` to mirror commentary updates, `off` to disable progress notices)
 - `BLUN_TELEGRAM_DISPATCH_MODE` (`deferred` by default, `legacy` to restore eager dispatch)
 
 ## Tools

package/telegram-plugin/dispatcher.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { injectNext } from "./lib/bridge.js";
+import { isCurrentSidecarPid } from "./lib/singleton.js";
 
 const intervalMs = Number.parseInt(process.env.BLUN_TELEGRAM_INJECT_INTERVAL_MS || "1500", 10) || 1500;
 let stopping = false;
@@ -18,6 +19,9 @@ process.on("SIGTERM", () => {
 
 async function main() {
   while (!stopping) {
+    if (!isCurrentSidecarPid("dispatcher")) {
+      break;
+    }
     try {
       const result = await injectNext("", { auto: true });
       if (!["empty", "deferred"].includes(result.status)) {