channel-worker 2.5.113 → 2.5.115

package/lib/api-client.js

@@ -75,7 +75,7 @@ class ApiClient {
     // nào — xảy ra 14/09 với verify_facebook_reels_pw (cổng thứ nhất là enum
     // của app/models/WorkerCommand.js, cũng đã quên một lần cùng ngày).
     // api/tests/publish-verify-wiring.test.js canh cả hai cổng.
-    const workerTypes = 'launch_profile,close_profile,launch_veo3_profile,set_profile_proxy,save_file,set_thumbnail,set_tags,set_file_input,click_and_upload,type_text,verify_logins,update_extension,sync_youtube_stats,restart_worker,upload_youtube_pw,upload_tiktok_pw,upload_facebook_pw,upload_facebook_photo_pw,warmup_youtube_pw,warmup_facebook_pw,warmup_tiktok_pw,nurture_facebook_pw,fetch_facebook_reel_stats_pw,verify_facebook_reels_pw,comment_facebook_pw,scrape_affiliate_products,ingest_shopee_product,get_affiliate_link';
+    const workerTypes = 'launch_profile,close_profile,launch_veo3_profile,set_profile_proxy,save_file,set_thumbnail,set_tags,set_file_input,click_and_upload,type_text,verify_logins,update_extension,sync_youtube_stats,restart_worker,upload_youtube_pw,upload_tiktok_pw,upload_facebook_pw,upload_facebook_photo_pw,upload_facebook_post_pw,warmup_youtube_pw,warmup_facebook_pw,warmup_tiktok_pw,nurture_facebook_pw,fetch_facebook_reel_stats_pw,verify_facebook_reels_pw,comment_facebook_pw,scrape_affiliate_products,ingest_shopee_product,get_affiliate_link';
     return this.request('GET', `/workers/commands?worker_id=${workerId}&types=${encodeURIComponent(workerTypes)}`);
   }
 

package/lib/command-poller.js

@@ -1,4 +1,5 @@
 const { NstManager } = require('./nst-manager');
+const { refreshPinnedAgentAddress } = require('./nst-agent-locator');
 const { checkAndUpdateExtension } = require('./extension-updater');
 const { StatsSyncer } = require('./stats-syncer');
 
@@ -7,6 +8,12 @@ const { StatsSyncer } = require('./stats-syncer');
 // tới và dùng lại browser, nhưng không được để mở qua đêm.
 const PW_IDLE_CLOSE_MS = Number(process.env.PW_IDLE_CLOSE_MS || 5 * 60 * 1000);
 
+// Người bấm "Mở trình duyệt" trên web → profile đó là của NGƯỜI trong quãng
+// này, automation không được đóng ngang. Trước 16/09/2026 không có hàng rào
+// nào: hẹn đóng 300s của lượt đăng bài trước đó vẫn chạy và đóng profile ngay
+// trước mũi chủ tịch (đo thật: kenh-21, mở 11:42 → bị đóng vài phút sau).
+const HUMAN_HOLD_MS = Number(process.env.HUMAN_HOLD_MS || 15 * 60 * 1000);
+
 class CommandPoller {
   constructor(api, config) {
     this.api = api;
@@ -538,6 +545,8 @@ class CommandPoller {
     if (!this._keptOpenProfiles || this._keptOpenProfiles.size <= max) return;
     const candidates = [...this._keptOpenProfiles.entries()]
       .filter(([id]) => !(this._pwInFlight && this._pwInFlight.has(id)))
+      // Profile người vừa mở tay không phải ứng viên để nhường suất.
+      .filter(([id]) => this._humanHoldLeft(id) <= 0)
       .sort((a, b) => a[1] - b[1]);
     let over = this._keptOpenProfiles.size - max;
     for (const [id] of candidates) {
@@ -558,7 +567,7 @@ class CommandPoller {
   // Hẹn đóng profile sau một quãng RẢNH. Lượt _pw kế tiếp của cùng profile huỷ
   // hẹn (xem đầu handlePlaywrightCommand), nên chuỗi upload nhiều nền tảng liên
   // tiếp vẫn dùng chung một browser như thiết kế cũ.
-  _schedulePwClose(profileId, scriptName) {
+  _schedulePwClose(profileId, scriptName, delayMs = PW_IDLE_CLOSE_MS) {
     if (!this._pwCloseTimers) this._pwCloseTimers = new Map();
     const prev = this._pwCloseTimers.get(profileId);
     if (prev) clearTimeout(prev);
@@ -566,13 +575,22 @@ class CommandPoller {
       this._pwCloseTimers.delete(profileId);
       // Có lệnh khác vừa chiếm profile này → để yên, lượt đó sẽ tự hẹn lại.
       if (this._pwInFlight && this._pwInFlight.has(profileId)) return;
+      // Người vừa mở profile này bằng tay → hoãn tới khi hết giữ chỗ. Đóng ở
+      // đây là đóng ngay trước mũi người đang ngồi trong browser.
+      const hold = this._humanHoldLeft(profileId);
+      if (hold > 0) {
+        console.log(`[commands/pw] hoãn đóng ${profileId} — người đang dùng, `
+          + `còn ${Math.ceil(hold / 1000)}s`);
+        this._schedulePwClose(profileId, scriptName, hold + 1000);
+        return;
+      }
       try {
         await this.nst.stopProfile(profileId);
-        console.log(`[commands/pw] đóng profile ${profileId} sau ${PW_IDLE_CLOSE_MS / 1000}s rảnh (${scriptName})`);
+        console.log(`[commands/pw] đóng profile ${profileId} sau ${delayMs / 1000}s rảnh (${scriptName})`);
       } catch (e) {
         console.warn(`[commands/pw] đóng trễ ${profileId} lỗi: ${e.message}`);
       }
-    }, PW_IDLE_CLOSE_MS);
+    }, delayMs);
     // Đừng giữ tiến trình sống chỉ vì một cái hẹn đóng browser.
     if (typeof t.unref === 'function') t.unref();
     this._pwCloseTimers.set(profileId, t);
@@ -640,12 +658,43 @@ class CommandPoller {
         }
       }
 
-      const result = await this.nst.launchProfile(profile_id, { proxy, extensionPath });
+      const result = await this._launchWithAgentRetry(profile_id, { proxy, extensionPath });
+
+      // Đang mở sẵn: KHÔNG có cửa sổ mới nào bật lên. Trên máy đang có hơn chục
+      // browser thì với người bấm, cú bấm coi như rơi vào hư không. Đẩy cửa sổ
+      // sẵn có lên trước và giữ nó lại cho người dùng.
+      if (result.alreadyRunning) {
+        this._cancelPwClose(profile_id);
+        this._holdProfileForHuman(profile_id);
+        const fronted = await this.nst.bringProfileToFront(profile_id);
+        console.log(`[commands] Profile ${profile_id} đang mở sẵn — `
+          + `${fronted ? 'đã đưa cửa sổ lên trước' : 'KHÔNG đưa được cửa sổ lên trước'}, `
+          + `giữ cho người dùng ${Math.round(HUMAN_HOLD_MS / 60000)} phút`);
+        await this.api.updateCommand(command._id, {
+          status: 'done',
+          result: {
+            profile_id: result.profileId,
+            already_running: true,
+            brought_to_front: fronted,
+            launched_at: new Date().toISOString(),
+            message: fronted
+              ? 'Profile đã mở sẵn — đã đưa cửa sổ lên trước trên máy chạy.'
+              : 'Profile đã mở sẵn trên máy chạy, nhưng không đưa được cửa sổ lên trước — tìm trong đám cửa sổ đang mở.',
+          },
+        });
+        return;
+      }
+
       console.log(`[commands] Profile ${profile_id} launched${extensionPath ? ' (ext)' : ''}`);
+      this._holdProfileForHuman(profile_id);
 
       await this.api.updateCommand(command._id, {
         status: 'done',
-        result: { profile_id: result.profileId, launched_at: new Date().toISOString() },
+        result: {
+          profile_id: result.profileId,
+          launched_at: new Date().toISOString(),
+          message: 'Đã mở trình duyệt trên máy chạy.',
+        },
       });
     } catch (err) {
       console.error(`[commands] Failed to launch profile: ${err.message}`);
@@ -656,6 +705,60 @@ class CommandPoller {
     }
   }
 
+  /**
+   * Mở profile, thử lại khi agent NST chưa dò ra.
+   *
+   * Agent đổi cổng mỗi lần Nstbrowser khởi động lại (chủ tịch tắt hết profile =
+   * app restart), và nó cần vài giây để nghe cổng mới. Không có vòng thử lại
+   * này thì cú bấm rơi đúng khoảng đó chết hẳn, người bấm phải tự đoán mà bấm
+   * lại — đúng cảnh 16/09/2026: lệnh 11:50:48 chết, lệnh 11:51:34 chạy ngon.
+   * Các lỗi khác (hết slot NST, profile mở ở phiên khác) KHÔNG thử lại: thử lại
+   * cũng vậy, mà còn giấu mất lỗi thật.
+   */
+  async _launchWithAgentRetry(profileId, options, { attempts = 3, waitMs = 3000 } = {}) {
+    let lastErr = null;
+    for (let i = 1; i <= attempts; i++) {
+      try {
+        return await this.nst.launchProfile(profileId, options);
+      } catch (err) {
+        lastErr = err;
+        if (!/NST_AGENT_UNRESOLVED/.test(err.message || '')) throw err;
+        if (i === attempts) break;
+        console.warn(`[commands] agent NST chưa sẵn sàng (lần ${i}/${attempts}) — `
+          + `dò lại sau ${waitMs / 1000}s`);
+        await new Promise(r => setTimeout(r, waitMs));
+        await refreshPinnedAgentAddress({ minIntervalMs: 0 });
+      }
+    }
+    throw lastErr;
+  }
+
+  // ─── Giữ chỗ cho NGƯỜI ────────────────────────────────────────────────────
+  // Profile do người mở bằng tay không được để automation đóng ngang: lượt đăng
+  // bài trước đó đã hẹn đóng sau PW_IDLE_CLOSE_MS và cái hẹn đó không biết có
+  // người đang ngồi trong browser.
+  _cancelPwClose(profileId) {
+    if (this._pwCloseTimers && this._pwCloseTimers.has(profileId)) {
+      clearTimeout(this._pwCloseTimers.get(profileId));
+      this._pwCloseTimers.delete(profileId);
+      return true;
+    }
+    return false;
+  }
+
+  _holdProfileForHuman(profileId, ms = HUMAN_HOLD_MS) {
+    if (!this._humanHold) this._humanHold = new Map();
+    this._humanHold.set(profileId, Date.now() + ms);
+  }
+
+  /** Còn bao nhiêu ms giữ chỗ cho người (0 = hết/không có). */
+  _humanHoldLeft(profileId) {
+    if (!this._humanHold || !profileId) return 0;
+    const left = (this._humanHold.get(profileId) || 0) - Date.now();
+    if (left <= 0) { this._humanHold.delete(profileId); return 0; }
+    return left;
+  }
+
   async handleLaunchVeo3Profile(command) {
     const { nst_profile_id, name, veo3_worker_id, os, proxy } = command.payload || {};
     console.log(`[commands] Launching Veo3 profile: ${nst_profile_id} (${name}) os=${os || 'windows'}`);
@@ -2173,6 +2276,8 @@ class CommandPoller {
         // Queue holds work pinned to THIS profile → it's about to be claimed,
         // leave the browser open.
         if (pinnedForId(profileId) > 0 || pinnedForId(name) > 0) continue;
+        // Người vừa mở profile này từ web → để yên cho tới hết giữ chỗ.
+        if (this._humanHoldLeft(profileId) > 0 || this._humanHoldLeft(browser.name) > 0) continue;
         // Match by UUID or name (renderers use name as nst_profile_id)
         const lastActivity = this._profileLastActivity[profileId]
           || (name && this._profileLastActivity[name])

package/lib/nst-agent-locator.js

@@ -159,7 +159,58 @@ function listAgentsCached(ttlMs = 60000, now = Date.now()) {
   return agents;
 }
 
+// Quên bản cache đi, lần dò sau đọc lại tiến trình thật. Gọi khi vừa biết
+// địa chỉ cũ đã sai — cache 60s đang giữ đúng cái bản đồ lỗi thời đó.
+function invalidateAgentCache() {
+  _agentCache = { at: 0, agents: [] };
+}
+
+/**
+ * Dò LẠI NGAY agent của user đang ghim, ghi thẳng vào NST_API_ADDRESS.
+ *
+ * Agent đổi cổng mỗi lần Nstbrowser khởi động lại (8848 ↔ 8849 theo thứ tự
+ * login). Watcher của daemon chỉ dò mỗi 60s, nên lệnh rơi vào khoảng trống đó
+ * chết oan bằng NST_AGENT_UNRESOLVED dù agent vẫn sống, chỉ nằm ở cổng khác.
+ * Đo thật trên win-worker 16/09/2026: chủ tịch tắt hết profile → agent nhảy
+ * 8849 → 8848; cú bấm "Mở trình duyệt" lúc 11:50:48 chết, cú 11:51:34 (sau khi
+ * watcher kịp chạy) mở được. Hàm này xoá hẳn khoảng trống đó.
+ *
+ * Fail-closed vẫn nguyên: dò không ra thì trả null và KHÔNG đặt địa chỉ nào —
+ * người gọi tiếp tục gặp NST_AGENT_UNRESOLVED thay vì rơi về :8848 của phiên
+ * Windows khác.
+ */
+let _pinnedRefresh = null;
+let _pinnedRefreshAt = 0;
+async function refreshPinnedAgentAddress({ minIntervalMs = 2000, now = Date.now() } = {}) {
+  const user = process.env.NST_AGENT_PINNED_USER;
+  if (!user) return process.env.NST_API_ADDRESS || null;
+  // Nhiều lệnh cùng vấp một lúc (đăng bài + nút bấm) — chỉ dò một lần, cả đám
+  // chờ chung kết quả; tasklist + netstat là lệnh nặng, đừng nhân lên.
+  if (_pinnedRefresh) return _pinnedRefresh;
+  if (now - _pinnedRefreshAt < minIntervalMs) return process.env.NST_API_ADDRESS || null;
+  _pinnedRefresh = (async () => {
+    try {
+      invalidateAgentCache();
+      const found = await agentAddressForUser(user);
+      if (!found) return null;
+      if (process.env.NST_API_ADDRESS !== found.address) {
+        console.log(`[nst] agent của "${user}" dò lại tại chỗ: ${found.address} `
+          + `(pid ${found.pid}, session ${found.sessionId}/${found.sessionName})`);
+      }
+      process.env.NST_API_ADDRESS = found.address;
+      return found.address;
+    } catch {
+      return null;
+    } finally {
+      _pinnedRefreshAt = Date.now();
+      _pinnedRefresh = null;
+    }
+  })();
+  return _pinnedRefresh;
+}
+
 module.exports = {
-  listAgents, listAgentsCached, resolveAgentForUser, agentAddressForUser, probeIsNstAgent, lanAddress,
+  listAgents, listAgentsCached, invalidateAgentCache, resolveAgentForUser, agentAddressForUser,
+  refreshPinnedAgentAddress, probeIsNstAgent, lanAddress,
   parseTasklistCsv, parseListening,
 };

package/lib/nst-manager.js

@@ -1,4 +1,4 @@
-const { listAgentsCached, lanAddress } = require('./nst-agent-locator');
+const { listAgentsCached, lanAddress, refreshPinnedAgentAddress } = require('./nst-agent-locator');
 
 function nstLaunchError(response, { profileId = '', runningCount = 0 } = {}) {
   const raw = String(response?.msg || 'Failed to connect browser').trim();
@@ -51,7 +51,21 @@ class NstManager {
     return 'http://localhost:8848/api/v2';
   }
 
+  /**
+   * Có địa chỉ agent chưa? Chưa thì dò lại NGAY thay vì chờ watcher 60s.
+   *
+   * Không đặt bừa địa chỉ nào khi dò không ra: `baseUrl` vẫn ném
+   * NST_AGENT_UNRESOLVED như cũ (fail-closed — mở nhầm agent của phiên Windows
+   * khác = profile trắng = báo logout oan cả loạt kênh).
+   */
+  async ensureAgent() {
+    if (this._apiAddress || process.env.NST_API_ADDRESS) return true;
+    if (!process.env.NST_AGENT_PINNED_USER) return true;
+    return Boolean(await refreshPinnedAgentAddress());
+  }
+
   async api(path, options = {}) {
+    await this.ensureAgent();
     const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
     const res = await fetch(url, {
       ...options,
@@ -92,6 +106,7 @@ class NstManager {
   // Get all running browsers
   async getRunningBrowsers() {
     try {
+      await this.ensureAgent();
       const rawRes = await fetch(`${this.baseUrl}/browsers`, {
         headers: { 'x-api-key': this.apiKey },
       });
@@ -139,6 +154,34 @@ class NstManager {
     return { profileId, httpEndpoint, wsEndpoint, port };
   }
 
+  /**
+   * Đưa cửa sổ của một profile ĐANG MỞ lên trước mặt người dùng.
+   *
+   * Người bấm "Mở trình duyệt" mà profile đã mở sẵn (lượt đăng bài tự động mở
+   * trước đó) thì `launchProfile` bỏ qua, không có cửa sổ nào bật lên — trên máy
+   * đang có hơn chục browser thì coi như không có gì xảy ra (chủ tịch gặp
+   * 16/09/2026 lúc 11:42).
+   *
+   * Đi qua cổng debug của chính Chrome (`/json/activate/<targetId>` → CDP
+   * Target.activateTarget): KHÔNG tốn lượt mở NST và không cần thư viện CDP.
+   * → true nếu đã đẩy được cửa sổ lên trước.
+   */
+  async bringProfileToFront(profileIdOrName) {
+    const ep = await this.resolveRunningEndpoint(profileIdOrName);
+    if (!ep) return false;
+    try {
+      const res = await fetch(`${ep.httpEndpoint}/json/list`);
+      const targets = await res.json();
+      const page = (Array.isArray(targets) ? targets : []).find(t => t.type === 'page');
+      if (!page || !page.id) return false;
+      const act = await fetch(`${ep.httpEndpoint}/json/activate/${page.id}`);
+      return act.ok;
+    } catch (e) {
+      console.warn(`[nst] bringProfileToFront ${profileIdOrName}: ${e.message}`);
+      return false;
+    }
+  }
+
   // Check if profile is already running
   async isProfileRunning(profileId) {
     const running = await this.getRunningBrowsers();
@@ -232,6 +275,7 @@ class NstManager {
     if (!proxyUrl) return;
     console.log(`[nst] Setting proxy for ${profileId}: ${proxyUrl}`);
     try {
+      await this.ensureAgent();
       const res = await fetch(`${this.baseUrl}/profiles/${profileId}/proxy`, {
         method: 'PUT',
         headers: { 'Content-Type': 'application/json', 'x-api-key': this.apiKey },
@@ -293,6 +337,7 @@ class NstManager {
 
   // Launch browser — skip if already running, set proxy if provided
   async launchProfile(profileIdOrName, options = {}) {
+    await this.ensureAgent();
     let profileId = profileIdOrName;
     if (!this.isUUID(profileIdOrName)) {
       profileId = await this.ensureProfile(profileIdOrName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "channel-worker",
-  "version": "2.5.113",
+  "version": "2.5.115",
   "description": "Channel Manager worker daemon — runs on remote machines to execute video pipeline jobs",
   "main": "lib/daemon.js",
   "bin": {

package/scripts/upload_facebook.js

@@ -997,6 +997,43 @@ async function hasVisibleReelComposer(page) {
   }).catch(() => false);
 }
 
+// Dựng câu báo lỗi cho ca "đi thẳng /reels/create/ rồi bị Facebook đá về feed".
+//
+// Trước 17/09/2026 chỗ này là MỘT chuỗi cứng luôn khẳng định `widget "Tạo bài
+// viết" không có mục Thước phim … tài khoản có thể chưa đủ điều kiện đăng
+// Reels`. Câu đó ĐỔ OAN trong ít nhất hai ca thật cùng ngày:
+//   • "Làm Giàu Từ Chăn Nuôi": log ngay trên nó ghi `page.goto: Timeout
+//     45000ms` rồi `KHÔNG thấy widget … các region đang có: []` — trang chưa
+//     tải xong chứ tài khoản không sao (chủ tịch xác nhận vẫn đăng nhập bình
+//     thường). Chạy lại là được.
+//   • profile "Aly L": widget CÓ, nhưng là tường CÁ NHÂN chứ không phải Page.
+// Người vận hành chỉ đọc câu này trên web, không mở log worker — nên câu lỗi
+// phải tự nói đúng tên bệnh và đúng việc cần làm.
+function describeReelCreateBounce(wallDiag, afterUrl) {
+  const tail = `/reels/create/ bị Facebook đá về feed (${afterUrl}). Đây KHÔNG phải lỗi selector.`;
+
+  // Không dò được tường (page.evaluate ném) → đừng đoán bừa bệnh nào.
+  if (!wallDiag) {
+    return `FB không mở được trình tạo Thước phim: không đọc được tường trang, và ${tail} Cần xem log worker dòng "[fb-pw]" ngay trước lỗi này để biết nguyên nhân.`;
+  }
+
+  // (1) Không có region nào = trang chưa render. Gần như luôn là trang tải
+  //     hỏng/timeout, KHÔNG phải chuyện quyền Reels hay đăng nhập.
+  if (!wallDiag.regionSeen) {
+    return `FB không mở được trình tạo Thước phim: TRANG CHƯA TẢI XONG — không có một vùng nội dung nào trên trang chủ (regions=${JSON.stringify(wallDiag.allRegions)}), và ${tail} Thường do mạng/proxy chậm hoặc page.goto timeout; KHÔNG phải tài khoản thiếu quyền đăng Reels. Cách xử: chạy lại lượt đăng; nếu lặp lại nhiều lần thì kiểm proxy của profile này.`;
+  }
+
+  // (2) Tường CÁ NHÂN: composer cá nhân vốn không có mục Thước phim. Chạy lại
+  //     bao nhiêu lần cũng vô ích.
+  if (wallDiag.personalWall) {
+    return `FB không mở được trình tạo Thước phim: profile này đang đăng nhập TÀI KHOẢN CÁ NHÂN chứ không phải Page (nút đang có: ${JSON.stringify(wallDiag.inventory)}), và ${tail} Composer cá nhân không có mục Thước phim — chạy lại vô ích. Cách xử: đăng nhập lại profile và chuyển sang đúng Page.`;
+  }
+
+  // (3) Tường Page thật mà vẫn thiếu mục Thước phim → mới đúng là nghi vấn
+  //     quyền đăng Reels của Page.
+  return `FB không mở được trình tạo Thước phim: widget "Tạo bài viết" CÓ nhưng thiếu mục Thước phim (nút đang có: ${JSON.stringify(wallDiag.inventory)}), và ${tail} Cách xử: cần người đăng nhập profile này và thử tạo Thước phim bằng tay — Page có thể chưa đủ điều kiện đăng Reels.`;
+}
+
 async function runOnce({ page, payload, log }) {
   const {
     video_url, title, description = '', tags = [],
@@ -1152,6 +1189,13 @@ async function runOnce({ page, payload, log }) {
         break;
       } catch {}
     }
+    // Chẩn đoán của lượt dò tường, giữ lại để câu BÁO LỖI cuối cùng nói đúng
+    // bệnh. Trước 17/09 câu lỗi là một chuỗi CỨNG luôn khẳng định "có widget
+    // mà thiếu mục Thước phim", kể cả khi log ngay trên nó vừa ghi "KHÔNG thấy
+    // widget nào" — người đọc bị đẩy đi kiểm quyền đăng Reels trong khi bệnh
+    // thật là trang chưa tải xong (ca "Làm Giàu Từ Chăn Nuôi" 17/09:
+    // `page.goto: Timeout 45000ms` ngay trước đó, regions = []).
+    let wallDiag = null;
     // Fallback — walk the "Tạo bài viết" region in JS, find a button whose
     // text/aria starts with "Thước phim"/"Reel" but is NOT in the sidebar.
     if (!reelOpened) {
@@ -1194,6 +1238,17 @@ async function runOnce({ page, payload, log }) {
         } else {
           log('warn', `[fb-pw] có widget "Tạo bài viết" nhưng KHÔNG có mục Thước phim — nút đang có: ${JSON.stringify(probed.inventory)}`);
         }
+        wallDiag = {
+          regionSeen: probed.regionSeen,
+          inventory: probed.inventory || [],
+          allRegions: probed.allRegions || [],
+          // Composer của TRANG CÁ NHÂN không bao giờ có mục Thước phim — nhận
+          // ra bằng hai nhãn đặc trưng, không phải bằng việc thiếu nút Reel.
+          // Ca thật 17/09: profile "Aly L" đăng nhập tài khoản cá nhân thay vì
+          // Page → al="Dòng thời gian của Aly L", t="Aly ơi, bạn đang nghĩ gì".
+          personalWall: (probed.inventory || []).some(s =>
+            /Dòng thời gian của |ơi, bạn đang nghĩ gì|'s timeline|What's on your mind/i.test(s)),
+        };
       }
       if (probed && probed.selector) {
         try {
@@ -1236,7 +1291,12 @@ async function runOnce({ page, payload, log }) {
       //      Thước phim. Sửa selector bao nhiêu cũng vô ích.
       await dumpFailure(page, 'reel-create-bounced', log).catch(() => {});
       if (usedCreateRoute) {
-        throw new Error(`FB không mở được trình tạo Thước phim cho tài khoản này: widget "Tạo bài viết" không có mục Thước phim, và /reels/create/ bị Facebook đá về feed (${afterUrl}). Đây KHÔNG phải lỗi selector — cần người đăng nhập profile này và thử tạo Thước phim bằng tay (tài khoản có thể chưa đủ điều kiện đăng Reels, hoặc đang đăng nhập sai trang).`);
+        // BA bệnh khác hẳn nhau, trước 17/09 gộp chung MỘT câu cứng luôn phán
+        // "widget có mà thiếu mục Thước phim" → đổ oan tài khoản, người đọc đi
+        // kiểm quyền đăng Reels trong khi bệnh thật nằm chỗ khác. Nói đúng tên
+        // bệnh ngay trong câu lỗi, vì người vận hành chỉ nhìn thấy câu này trên
+        // web chứ không mở log worker ra đọc.
+        throw new Error(describeReelCreateBounce(wallDiag, afterUrl));
       }
       throw new Error(`FB Thước phim click navigated to Reels feed (${afterUrl}) — wrong button matched, should be composer modal. Check "Tạo bài viết" widget layout on this Page.`);
     }
@@ -3448,6 +3508,7 @@ module.exports.__testables = {
   waitForPublishEnabled,
   isThumbnailEditorVisible,
   hasVisibleReelComposer,
+  describeReelCreateBounce,
   SAFE_RETRY_COMPOSER_CLOSED,
   navigateFacebookHome,
   navigateFacebookReelCreate,

package/scripts/upload_facebook_photo.js

@@ -1,7 +1,7 @@
-// upload_facebook_photo — publish an IMAGE (photo) post to a Facebook Page via
+// upload_facebook_photo / upload_facebook_post — publish an IMAGE or TEXT post to a Facebook Page via
 // the "Tạo bài viết" composer (NOT the Reels composer). Driven by the worker
 // daemon's Playwright pipeline; command type upload_facebook_photo_pw →
-// scripts/upload_facebook_photo.js. Payload: { image_url, caption, tags[] }.
+// scripts/upload_facebook_photo.js. Payload: { image_url?, caption, tags[] }.
 //
 // Strict-input contract (same as upload_facebook.js): every step throws on
 // failure so the cmd is marked failed — no silent false-success. In particular
@@ -111,8 +111,8 @@ function composerStillOpen(page, verbs) {
 
 async function run({ page, payload, log }) {
   const { image_url, caption = '', tags = [] } = payload || {};
-  if (!image_url) throw new Error('No image_url provided');
   if (!caption || !caption.trim()) throw new Error('No caption provided');
+  const hasImage = !!String(image_url || '').trim();
 
   log('info', '[fbphoto] selectors version=2026.07.01a');
   page.on('dialog', (d) => { d.accept().catch(() => {}); });
@@ -137,13 +137,15 @@ async function run({ page, payload, log }) {
     .map((t) => `#${t}`).join(' ');
   const fullCaption = hashtagLine ? `${caption.trim()}\n\n${hashtagLine}` : caption.trim();
 
-  log('info', '[fbphoto] downloading image to local…');
-  const imagePath = await downloadToTemp(image_url, { prefix: 'fbphoto', ext: '.png' });
-  log('info', `[fbphoto] image at ${imagePath}`);
-
+  let imagePath = '';
   const publishVerbs = ['Đăng', 'Đăng bài', 'Post', 'Publish'];
 
   try {
+    if (hasImage) {
+      log('info', '[fbphoto] downloading image to local…');
+      imagePath = await downloadToTemp(image_url, { prefix: 'fbphoto', ext: '.png' });
+      log('info', `[fbphoto] image at ${imagePath}`);
+    }
     // 1) Open the Page wall.
     log('info', '[fbphoto] navigating to facebook.com…');
     await page.goto('https://www.facebook.com/', { waitUntil: 'domcontentloaded', timeout: 60_000 });
@@ -154,8 +156,8 @@ async function run({ page, payload, log }) {
     // 2) Open the "Tạo bài viết" composer via the "Ảnh/video" entry (this opens
     //    the post composer directly in photo-attach mode). Fall back to the
     //    status box ("Bạn đang nghĩ gì") if the photo entry isn't found.
-    const openPhotoComposer = async () => {
-      const photoBtn = await page.evaluate(() => {
+    const openComposer = async () => {
+      const photoBtn = hasImage ? await page.evaluate(() => {
         const els = document.querySelectorAll("div[role='button'], span, a[role='button']");
         for (const el of els) {
           const t = (el.innerText || '').trim();
@@ -167,7 +169,7 @@ async function run({ page, payload, log }) {
           }
         }
         return false;
-      }).catch(() => false);
+      }).catch(() => false) : false;
       if (photoBtn) {
         await page.locator("[__fbphoto_open__='1']").click({ timeout: 4000 }).catch(() => {});
         await page.evaluate(() => document.querySelectorAll('[__fbphoto_open__]').forEach((e) => e.removeAttribute('__fbphoto_open__'))).catch(() => {});
@@ -178,16 +180,16 @@ async function run({ page, payload, log }) {
       if (box) { await box.click({ timeout: 4000 }).catch(() => {}); await pause(page, 1500); return true; }
       return false;
     };
-    if (!(await openPhotoComposer())) {
+    if (!(await openComposer())) {
       await dumpFailure(page, 'no-composer-entry', log);
-      throw new Error('FB: không tìm thấy nút "Ảnh/video" / ô "Tạo bài viết" trên trang. Kiểm tra layout Page.');
+      throw new Error('FB: không tìm thấy ô "Tạo bài viết" trên trang. Kiểm tra layout Page.');
     }
     await pause(page, 2500);
 
     // 3) Ensure the composer modal is open; click its "Ảnh/video" if the file
     //    input isn't ready yet.
-    let fileInput = await page.$("input[type='file'][accept*='image']");
-    if (!fileInput) {
+    let fileInput = hasImage ? await page.$("input[type='file'][accept*='image']") : null;
+    if (hasImage && !fileInput) {
       const inModalPhoto = await page.evaluate(() => {
         const dlg = document.querySelector("[role='dialog']");
         if (!dlg) return false;
@@ -208,16 +210,18 @@ async function run({ page, payload, log }) {
         if (!fileInput) await pause(page, 1000);
       }
     }
-    if (!fileInput) {
+    if (hasImage && !fileInput) {
       await dumpFailure(page, 'no-file-input', log);
       throw new Error('FB: không tìm thấy ô upload ảnh trong composer.');
     }
 
     // 4) Attach the image.
-    log('info', '[fbphoto] attaching image…');
-    await setImageFile(page, fileInput, imagePath, log);
-    // Wait for the image preview to render inside the composer.
-    await pause(page, 4000);
+    if (hasImage) {
+      log('info', '[fbphoto] attaching image…');
+      await setImageFile(page, fileInput, imagePath, log);
+      // Wait for the image preview to render inside the composer.
+      await pause(page, 4000);
+    }
 
     // 5) Fill caption into the composer's contenteditable textbox.
     log('info', '[fbphoto] filling caption…');
@@ -323,7 +327,7 @@ async function run({ page, payload, log }) {
     }
     if (await composerStillOpen(page, publishVerbs)) {
       await dumpFailure(page, 'composer-stuck-open', log);
-      throw new Error('FB đăng ảnh KHÔNG commit — composer vẫn mở sau 3 lần thử (bài CHƯA được đăng).');
+      throw new Error('FB đăng bài KHÔNG commit — composer vẫn mở sau 3 lần thử (bài CHƯA được đăng).');
     }
 
     // 8) Best-effort post URL.

package/scripts/upload_facebook_post.js

@@ -0,0 +1,4 @@
+// Standalone Page posts share the proven Facebook composer implementation with
+// idea-derived photo posts. The shared runner treats image_url as optional, so
+// an empty image_url publishes a text-only post.
+module.exports = require('./upload_facebook_photo');