bridgerator 1.1.1 → 1.1.2

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "bridgerator",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bridgerator",
-      "version": "1.1.1",
+      "version": "1.1.2",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.29.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bridgerator",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Connect ChatGPT to your Windows PC: files, search and terminal through an outbound-only bridge with folder limits. No inbound ports, no admin rights.",
   "license": "MIT",
   "type": "module",

package/src/bridge.mjs

@@ -19,7 +19,7 @@ import { shorten } from './tool-text.mjs';
 import { parseDelete, recycle as recycleOnPc, purgeFromBin } from './recycle.mjs';
 import { createSnapshots, changedPaths, undoGroups, SNAP_DEFAULTS, UNDO_TOOL_DEF } from './undo.mjs';
 import { createFuse, wantAwake, FUSE_DEFAULTS } from './guard.mjs';
-import { createQueue, queueTool, QUEUE_TOOL_DEFS, QUEUE_TOOL_NAMES } from './queue.mjs';
+import { createQueue, queueTool, stalledItems, QUEUE_TOOL_DEFS, QUEUE_TOOL_NAMES } from './queue.mjs';
 import { createRecent, outcomeOf } from './recent.mjs';
 import { readSettingsStrict, setIni, writeAtomic, CATEGORIES, findMatch, clip } from './confirm.mjs';
 import { readPlan, planBanner, bannerVisible, dismissFor, safeUrl, forecast, setSite, accountUrl } from './plan.mjs';
@@ -374,6 +374,14 @@ export async function startDesktopCommander(cfg, log = console.log, { ask: askAr
   // --- Recycle Bin, mass-action fuse, Undo (LOGIC: critical-logic/bridge.md) ---------------------
   const fuse = createFuse();
   let fuseAsking = false, inFlight = 0, lastCall = 0, wasPaused = false;
+  // One notice per stalled "doing" item (id + updatedAt), on unless the person turned it off.
+  const stalledWarned = new Set(), started = Date.now();
+  if (queue) setInterval(() => {
+    if (cfg.notify?.queueStalled === false || inFlight) return;
+    const fresh = stalledItems(queue.list('doing'), { now: Date.now(), idleSince: Math.max(lastCall, started) }).filter((it) => !stalledWarned.has(`${it.id}@${it.updatedAt}`));
+    for (const it of fresh) stalledWarned.add(`${it.id}@${it.updatedAt}`);
+    if (fresh.length) showNotice({ kind: 'queue_stalled', title: fresh[0].title, more: fresh.length - 1 }, log); // one notice per check, not a burst
+  }, 60000).unref();
   const fuseCfg = () => ({ ...FUSE_DEFAULTS, ...(cfg.fuse || {}) });
   const setPaused = (v) => { if (out.setPaused) out.setPaused(v); else { out.paused = v; out.onMode(mode()); } };
   const currentTask = () => { const d = queue ? queue.list('doing') : []; return d.length === 1 ? { id: d[0].id, title: d[0].title } : undefined; };
@@ -495,7 +503,7 @@ export async function startDesktopCommander(cfg, log = console.log, { ask: askAr
   const bannerNow = () => { const b = planBanner(out.plan); return { ...b, visible: bannerVisible(b, cfg.planBannerDismissed) }; };
   out.banner = bannerNow;
   out.onPlanMsg = (m) => { out.plan = readPlan(m); out.onPlan?.(); };
-  const BOOL_NOTIFY = ['sound', 'offline', 'queueDone', 'limit'];
+  const BOOL_NOTIFY = ['sound', 'offline', 'queueDone', 'queueStalled', 'limit'];
 
   // Requests of the Bridgerator window (tray helper). Made by the person at the PC: no extra prompt.
   async function rpc(method, p = {}, paths = []) {
@@ -690,6 +698,9 @@ export function cleanEnv(env = process.env) {
 export function engineEnv(env = process.env) {
   const e = cleanEnv(env);
   for (const k of Object.keys(e)) if (/^(BRIDGERATOR_|BR_)/i.test(k)) delete e[k];
+  // The terminal's PowerShell may run .ps1 (npm.ps1, npx.ps1…): Windows' default "Restricted" blocks them (26.10, a user's
+  // PC). Process scope only — the PC's own policy is never changed, a Group Policy still wins, a value the person set stays.
+  if (!Object.keys(e).some((k) => k.toLowerCase() === 'psexecutionpolicypreference')) e.PSExecutionPolicyPreference = 'Bypass';
   return e;
 }
 export function engineCwd(cfg, home = os.homedir()) {

package/src/notice.mjs

@@ -30,6 +30,11 @@ export function noticeText(n) {
     const title = typeof n.title === 'string' ? n.title.replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ').trim().slice(0, 120) : '';
     if (!title) return undefined;
     t = ['Queue task done', title];
+  } else if (kind === 'queue_stalled') {
+    const title = typeof n.title === 'string' ? n.title.replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ').trim().slice(0, 120) : '';
+    if (!title) return undefined;
+    const more = int(n.more) || 0;
+    t = ['ChatGPT may be waiting for you', `No activity on the queue task "${title}"${more ? ` and ${more} more` : ''} for 10 minutes. Open the ChatGPT chat: it may be asking you to allow an action.`];
   } else if (kind === 'protection_off') {
     // Internal list only (the bridge's own labels), never relay text.
     const ok = new Set(['confirmations', 'your own patterns', ...Object.values(LABEL).map((l) => `confirmations for ${l}`)]);

package/src/queue.mjs

@@ -9,7 +9,11 @@ export const STATUSES = ['todo', 'doing', 'done', 'failed', 'skipped'];
 const MAX_ITEMS = 500, MAX_TITLE = 200, MAX_DETAILS = 4000, MAX_NOTE = 1000, MAX_PATHS = 20;
 const RULE = 'The usual loop: queue_next, do the task, queue_update with done / failed / skipped and a short note, then the next one until the queue is empty or the person stops. resultPath set: write the result to that file. from set: another AI added it and reads queue_list.';
 const MAX_FROM = 80, MAX_RESULT_PATH = 1000;
-export const STALE_MS = 30 * 60 * 1000;   // "doing" with no update for this long: another chat gave up
+export const STALE_MS = 30 * 60 * 1000;
+export const STALLED_MS = 10 * 60 * 1000; // "doing" + no tool call at all for this long: ChatGPT is likely waiting for the person
+/** "doing" items with no update and no tool call on this PC for `ms` (owner 26.10: ChatGPT's own Allow dialog is invisible on the PC). */
+// ponytail: one PC-wide idle clock — a second chat busy with other calls hides a stalled one; per-chat tracking would need the worker on every call.
+export const stalledItems = (list, { now, idleSince, ms = STALLED_MS }) => (now - idleSince < ms ? [] : list.filter((x) => x.status === 'doing' && now - Date.parse(x.updatedAt) >= ms));   // "doing" with no update for this long: another chat gave up
 const ID = { type: 'string', description: 'item id' };
 const STR = (n) => ({ type: 'string', maxLength: n });
 const PATHS = { type: 'array', maxItems: MAX_PATHS, items: STR(1000) };
@@ -18,7 +22,7 @@ const HANDOFF = { from: { type: 'string', maxLength: MAX_FROM, description: 'Who
 
 export const QUEUE_TOOL_DEFS = [
   { name: 'queue_list', description: `List the task queue the person keeps on this PC (a checklist of things to do): counts and items (id, title, status, note, worker, updatedAt, from, resultPath), optionally only one status.`, inputSchema: { type: 'object', additionalProperties: false, properties: { status: { type: 'string', enum: STATUSES } } } },
-  { name: 'queue_next', description: `Take the next item of the task queue: returns the first "todo" item and marks it "doing" (nothing when the queue is empty). An item left "doing" for 30 minutes without an update (another chat stopped) is returned first, with resumed: true. Several chats can work through one queue at once; each call gets a different item. Pass worker = a short name for this chat (e.g. its title) so the person sees who is on it. ${RULE}`, inputSchema: { type: 'object', additionalProperties: false, properties: { worker: STR(80) } } },
+  { name: 'queue_next', description: `Take the next item of the task queue: returns the first "todo" item and marks it "doing" (nothing when the queue is empty). An item left "doing" for 30 minutes without an update (another chat stopped) is returned first, with resumed: true. Several chats can work through one queue at once; each call gets a different item. Pass worker = a short name for this chat (e.g. its title) so the person sees who is on it. ${RULE}`, inputSchema: { type: 'object', additionalProperties: false, properties: { worker: STR(80), id: { type: 'string', description: 'take this "todo" item instead of the first one' } } } },
   { name: 'queue_update', description: `Set an item's status (doing / done / failed / skipped / todo) with a short result note.`, inputSchema: { type: 'object', additionalProperties: false, required: ['id', 'status'], properties: { id: ID, status: { type: 'string', enum: STATUSES }, note: STR(MAX_NOTE) } } },
   { name: 'queue_add', description: `Add steps to the task queue (e.g. when planning a bigger job with the person): one { title, details?, paths?, from?, resultPath? } or items: [...] (1–100). Another AI handing work to ChatGPT sets from (its name) and resultPath (a file for the result), then reads the outcome with queue_list.`, inputSchema: { type: 'object', additionalProperties: false, properties: { title: STR(MAX_TITLE), details: STR(MAX_DETAILS), paths: PATHS, ...HANDOFF, items: { type: 'array', minItems: 1, maxItems: 100, items: { type: 'object', additionalProperties: false, required: ['title'], properties: { title: STR(MAX_TITLE), details: STR(MAX_DETAILS), paths: PATHS, ...HANDOFF } } } } } },
   { name: 'queue_clear', description: 'Remove finished items from the task queue: status done, failed or skipped. status "all" removes every item and needs the person\'s OK on the PC.', inputSchema: { type: 'object', additionalProperties: false, properties: { status: { type: 'string', enum: ['done', 'failed', 'skipped', 'all'] } } } },
@@ -99,11 +103,15 @@ export function createQueue(file, { now = () => new Date().toISOString(), onChan
       items.push(it); save(); return it;
     },
     // Synchronous take: parallel chats calling queue_next never get the same item.
-    next({ worker } = {}) { return commit(() => {
+    // id: that item only (a chat told to take certain tasks), if it is "todo" or stale "doing"; else an error.
+    next({ worker, id } = {}) { return commit(() => {
       const w = str(worker, 80, 'worker');
       const t = Date.parse(now());
-      const stale = sorted().find((x) => x.status === 'doing' && t - Date.parse(x.updatedAt) >= STALE_MS);
-      const it = stale || sorted().find((x) => x.status === 'todo');
+      const isStale = (x) => x.status === 'doing' && t - Date.parse(x.updatedAt) >= STALE_MS;
+      const pick = id === undefined ? null : get(str(id, 40, 'id', true));
+      if (pick && pick.status !== 'todo' && !isStale(pick)) throw new Error(`item ${pick.id} is "${pick.status}", not free to take`);
+      const stale = pick ? (isStale(pick) ? pick : null) : sorted().find(isStale);
+      const it = stale || pick || sorted().find((x) => x.status === 'todo');
       if (!it) return null;
       if (stale) it.resumedFrom = it.worker || 'another chat';
       it.status = 'doing'; it.updatedAt = now();

package/src/settings-tool.mjs

@@ -21,11 +21,11 @@ export const DEFAULTS = {
   preset: 'full', terminal: true, allowedDirectories: [], readOnlyDirectories: [], protectSensitive: false,
   confirm: { enabled: false, ...readSettings('').ask, timeoutSeconds: 120 },   // no confirm.ini = the defaults per category
   recycleBin: true, snapshots: { ...SNAP_DEFAULTS }, fuse: { ...FUSE_DEFAULTS }, keepAwake: true, askSettings: false,
-  theme: 'system', language: 'en', popupStyle: 'toast', notify: { sound: true, offline: true, queueDone: true, limit: true },
+  theme: 'system', language: 'en', popupStyle: 'toast', notify: { sound: true, offline: true, queueDone: true, queueStalled: true, limit: true },
   deviceName: '', autostart: true, localHistory: false, telemetryEnabled: true,
   ...EXTRA.defaults(),
 };
-const NOTIFY = ['sound', 'offline', 'queueDone', 'limit'];
+const NOTIFY = ['sound', 'offline', 'queueDone', 'queueStalled', 'limit'];
 const dirs = { type: 'array', maxItems: 20, items: { type: 'string' } };
 export const SETTINGS_TOOL_DEF = {
   name: 'bridgerator_settings',

package/ui/app.js

@@ -331,7 +331,7 @@ P.notifications = () => {
   return `<main class="notifications">${bannerHtml()}
 <div class="head"><h1>${esc(t('notify.title'))}</h1><div class="sub">${esc(t('notify.sub'))}</div></div>
 <div class="styles" role="radiogroup" aria-label="${esc(t('aria.style'))}">${style('toast')}${style('popup')}</div>
-<div class="nsplit"><section class="card" aria-label="${esc(t('aria.options'))}">${sw('sound', 'notify.sound')}${sw('offline', 'notify.offline')}${sw('queueDone', 'notify.queueDone')}${sw('limit', 'notify.limit')}</section>
+<div class="nsplit"><section class="card" aria-label="${esc(t('aria.options'))}">${sw('sound', 'notify.sound')}${sw('offline', 'notify.offline')}${sw('queueDone', 'notify.queueDone')}${sw('queueStalled', 'notify.queueStalled')}${sw('limit', 'notify.limit')}</section>
 <section class="preview" aria-label="${esc(t('notify.preview'))}"><div class="bar-top"><span class="b">${esc(t('notify.preview'))}</span><div class="seg" role="radiogroup" aria-label="${esc(t('aria.previewTheme'))}">${pv('light')}${pv('dark')}</div></div>
 <div class="toast ${previewTheme}"><div class="app">${LOGO16}<span class="grow">Bridgerator</span><span>⋯</span></div><div class="h">${esc(t('notify.pHead'))}</div><div class="c">${esc(t('notify.pCmd'))}</div><div class="m">${esc(t('notify.pMeta', { name: state.name || 'PC' }))}</div>
 <div class="btns"><span>${esc(t('notify.allow'))}</span><span>${esc(t('notify.allow10'))}</span><span>${esc(t('notify.deny'))}</span></div></div>

package/ui/i18n/en.json

@@ -274,6 +274,7 @@
   "sound": "Play a sound",
   "offline": "When the PC goes offline",
   "queueDone": "When a queue task is done",
+  "queueStalled": "When a queue task stalls (ChatGPT may be waiting for your OK in the chat)",
   "limit": "Monthly limit warnings",
   "preview": "Preview",
   "light": "Light",
@@ -364,7 +365,8 @@
      "Add tasks here, or ask ChatGPT to plan the work and add the steps itself.",
      "Attach files or folders to a task so ChatGPT knows where to look.",
      "In ChatGPT, say “Work through my Bridgerator queue”. Watch the ticks appear here.",
-     "Edit, reorder or delete tasks any time. A failed task shows why it failed."
+     "Edit, reorder or delete tasks any time. A failed task shows why it failed.",
+     "ChatGPT may ask you to allow an action in the chat; the task waits for your answer. If a task stalls, Bridgerator shows a notice."
     ],
     "tipLabel": "say",
     "tip": "Work through my Bridgerator queue"

package/ui/i18n/ru.json

@@ -274,6 +274,7 @@
   "sound": "Звук",
   "offline": "Когда ПК уходит из сети",
   "queueDone": "Когда задача из очереди готова",
+  "queueStalled": "Когда задача из очереди зависла (ChatGPT может ждать вашего «Разрешить» в чате)",
   "limit": "Предупреждения о лимите",
   "preview": "Пример",
   "light": "Светлая",
@@ -364,7 +365,8 @@
      "Добавляйте задачи здесь или попросите ChatGPT спланировать работу и добавить шаги самому.",
      "Прикрепите к задаче файлы или папки, чтобы ChatGPT знал, где искать.",
      "Скажите в ChatGPT «Work through my Bridgerator queue» и смотрите, как появляются галочки.",
-     "Меняйте, переставляйте и удаляйте задачи когда угодно. У невыполненной задачи видно, почему."
+     "Меняйте, переставляйте и удаляйте задачи когда угодно. У невыполненной задачи видно, почему.",
+     "ChatGPT может попросить в чате разрешить действие — задача ждёт вашего ответа. Если задача зависла, Bridgerator покажет уведомление."
     ],
     "tipLabel": "say",
     "tip": "Work through my Bridgerator queue"