instar 1.3.1586 → 1.3.1588

package/dashboard/console/promises-model.js

@@ -174,8 +174,24 @@ export function updateQuestionOf(c, now = Date.now()) {
     : `What is the current status of “${subject}”? Please tell me what is done, what remains, and when I should expect the next update.`;
 }
 
+/** A promise that waits only on the operator's yes or no: the page offers Approve and Decline. */
+export function canDecide(c) {
+  return Boolean(c) && c.status === 'pending' && c.blockedOn === 'user-authorization';
+}
+
+/** The words after an Approve / Decline answer, from the server's reply. */
+export function decideResultWords(decision, res) {
+  if (res && res.ok) {
+    const posted = res.data && res.data.postedInConversation === false ? ' I could not post it in the conversation, so mention it there if it matters.' : '';
+    return { ok: true, text: (decision === 'approve' ? 'Approved. I will go ahead.' : 'Declined. The promise is closed.') + posted };
+  }
+  const why = (res && res.reason) || 'the server could not be reached';
+  return { ok: false, text: `That did not go through: ${String(why).replace(/\.$/, '').replace(/^The /, 'the ')}.` };
+}
+
 /** A concrete next step without assigning the agent's work to the operator. */
 export function nextStepOf(c, now = Date.now()) {
+  if (canDecide(c)) return 'Your approval is needed. Approve or decline it here, or reply in the conversation to talk it through first.';
   if (waitsOnOperator(c)) return 'Your answer or approval is needed. Open the conversation to respond.';
   if (isMissed(c, now) || needsPromiseReview(c, now)) return 'This follow-up is mine: I need to verify the current outcome. No action is needed from you.';
   return 'The next step is mine. No action is needed from you.';

package/dashboard/console/promises.js

@@ -1,7 +1,7 @@
 // Promises page (docs/specs/console-features/work.md, "Commitments → Promises").
 // Read with Home's rules; actions use the bearer token only (no PIN on these routes).
 
-import { buildPromisesPage, storyOf, backstoryOf, updateQuestionOf, nextStepOf, actionsFor } from './promises-model.js';
+import { buildPromisesPage, storyOf, backstoryOf, updateQuestionOf, nextStepOf, actionsFor, canDecide, decideResultWords } from './promises-model.js';
 import { isInternalFollowUp } from './home-model.js';
 import { promiseActionLinks } from './promise-actions.js';
 import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, actionButton, note, cantTell } from './ui.js';
@@ -131,7 +131,7 @@ function openPromise(r, { post, chatId, names, refresh }) {
       el('p', { class: 'promise-backstory-note', text: 'Copy this question and paste it in the conversation:' }),
       el('textarea', { class: 'promise-question', readonly: true }, question)) : null;
     if (fallback) blocks.push(fallback);
-    row.append(el('a', { class: `${actionLinks.length || !waitsOnYou ? 'btn-quiet' : 'btn-primary'} btn-inline`, href: link,
+    row.append(el('a', { class: `${actionLinks.length || !waitsOnYou || canDecide(c) ? 'btn-quiet' : 'btn-primary'} btn-inline`, href: link,
       target: '_blank', rel: 'noopener', text: waitsOnYou ? 'Reply in the conversation' : internal ? 'View source conversation' : 'Optional: copy a question and open chat',
       onclick: question ? () => {
         // Topic links open the right chat; Telegram does not document a draft
@@ -150,6 +150,18 @@ function openPromise(r, { post, chatId, names, refresh }) {
     if (x.ok) return { ok: true, message: path === 'deliver' ? 'Marked as done.' : path === 'withdraw' ? 'Dropped.' : 'Reminders resumed.' };
     return { ok: false, message: x.reason };
   };
+  if (canDecide(c)) {
+    const decide = async (decision, note) => {
+      const x = await post(`/commitments/${id}/decide${q}`, { decision, ...(note ? { note } : {}) });
+      const w = decideResultWords(decision, x);
+      return { ok: w.ok, message: w.text };
+    };
+    const after = () => setTimeout(() => { closeSheet(); refresh(); }, 1200);
+    const decideRow = el('div', { class: 'sheet-actions promise-decide' },
+      actionButton({ label: 'Approve', kind: 'primary', confirm: 'Approve this? The session goes ahead with it.', run: () => decide('approve'), done: after }),
+      actionButton({ label: 'Decline', kind: 'quiet', confirm: 'Decline this? The promise closes and the session is told not to do it.', run: () => decide('decline'), done: after }));
+    blocks.push(decideRow);
+  }
   if (acts.includes('deliver')) row.append(actionButton({ label: waitsOnYou ? 'I handled this' : 'Mark as done', kind: link ? 'quiet' : 'primary',
     confirm: waitsOnYou ? 'Close this reminder? This does not send a reply or perform the requested approval.' : 'Mark this promise as done?',
     run: () => result('deliver', {}), done: () => setTimeout(() => { closeSheet(); refresh(); }, 700) }));

package/dashboard/desktop-setup.js

@@ -0,0 +1,164 @@
+// Guided Remote Desktop setup. Everything shown here comes from the server, so
+// the dashboard and the app say the same thing. It never decides anything.
+const POLL_MS = 4_000;
+const MAX_POLL_MS = 60_000;
+const POLL_FOR_MS = 10 * 60_000;
+
+export function createDesktopSetup({ api, $, onReady, onPinLost }) {
+  const rows = new Map();
+  let activeId = '';
+  let timer = 0;
+  let delay = POLL_MS;
+  let startedAt = 0;
+
+  function stopPolling() {
+    if (timer) clearTimeout(timer);
+    timer = 0;
+    activeId = '';
+  }
+
+  function schedule() {
+    if (timer) clearTimeout(timer);
+    timer = 0;
+    if (!activeId || Date.now() - startedAt > POLL_FOR_MS) { stopPolling(); return; }
+    timer = setTimeout(poll, delay);
+  }
+
+  async function poll() {
+    timer = 0;
+    const id = activeId;
+    if (!id) return;
+    try {
+      const row = await api(`/desktop/setup/${encodeURIComponent(id)}`);
+      delay = POLL_MS;
+      const wasReady = rows.get(id)?.ready;
+      show(row);
+      if (row.ready && !wasReady) {
+        stopPolling();
+        await onReady(row);
+        return;
+      }
+      if (row.ready) { stopPolling(); return; }
+    } catch (error) {
+      if (lostPin(error)) return;
+      delay = Math.min(delay * 2, MAX_POLL_MS);
+    }
+    schedule();
+  }
+
+  function lostPin(error) {
+    // This machine restarting ends the PIN session, which is expected here.
+    if (!/dashboard operator session/i.test(error?.message || '')) return false;
+    stopPolling();
+    onPinLost();
+    return true;
+  }
+
+  function follow(id) {
+    activeId = id;
+    delay = POLL_MS;
+    startedAt = Date.now();
+    schedule();
+  }
+
+  async function act(row, action, note) {
+    if (action.id === 'check') { note.textContent = 'Checking…'; }
+    try {
+      if (action.id === 'check') {
+        show(await api(`/desktop/setup/${encodeURIComponent(row.machineId)}`));
+        rows.get(row.machineId)?.ready ? await onReady(rows.get(row.machineId)) : follow(row.machineId);
+        return;
+      }
+      const reply = await api(`/desktop/setup/${encodeURIComponent(row.machineId)}`, 'POST',
+        { action: action.id, ...(action.pane ? { pane: action.pane } : {}) });
+      show(reply.step);
+      follow(row.machineId);
+    } catch (error) {
+      if (lostPin(error)) return;
+      if (error.step) show(error.step);
+      const current = rowElement(row.machineId)?.querySelector('.setup-note');
+      if (current) current.textContent = error.message || 'That did not work. Try again.';
+      follow(row.machineId);
+    }
+  }
+
+  function rowElement(id) {
+    return [...$('setupRows').children].find(item => item.dataset.machineId === id);
+  }
+
+  function show(row) {
+    rows.set(row.machineId, row);
+    const item = document.createElement('li');
+    item.dataset.machineId = row.machineId;
+    const title = document.createElement('strong');
+    title.textContent = row.title;
+    const detail = document.createElement('p');
+    detail.textContent = row.detail;
+    const actions = document.createElement('div');
+    actions.className = 'setup-actions';
+    const note = document.createElement('p');
+    note.className = 'setup-note';
+    note.setAttribute('role', 'status');
+    for (const action of row.actions) {
+      const button = document.createElement('button');
+      button.type = 'button';
+      button.textContent = action.label;
+      if (action.id === 'turn-off') button.className = 'setup-quiet';
+      button.addEventListener('click', async () => {
+        if (action.id === 'turn-off'
+          && !confirm(`Turn off Remote Desktop on ${row.label}? Its Instar server restarts.`)) return;
+        button.disabled = true;
+        try { await act(row, action, note); } finally { button.disabled = false; }
+      });
+      actions.append(button);
+    }
+    item.append(title, detail, actions);
+    if (row.note) {
+      const extra = document.createElement('p');
+      extra.textContent = row.note;
+      item.append(extra);
+    }
+    if (row.fallback) {
+      const more = document.createElement('details');
+      const summary = document.createElement('summary');
+      summary.textContent = 'Do it by hand instead';
+      const text = document.createElement('p');
+      text.textContent = row.fallback;
+      more.append(summary, text);
+      item.append(more);
+    }
+    item.append(note);
+    const existing = rowElement(row.machineId);
+    if (existing) existing.replaceWith(item);
+    else $('setupRows').append(item);
+  }
+
+  async function refresh() {
+    let list;
+    try { list = await api('/desktop/setup'); }
+    catch (error) {
+      if (lostPin(error)) return false;
+      // An older server, or one with no machine identity yet.
+      $('setup').hidden = true;
+      return false;
+    }
+    stopPolling();
+    $('setupRows').replaceChildren();
+    rows.clear();
+    if (list.frontElsewhere) {
+      $('setupLead').textContent = `Remote Desktop runs from ${list.frontLabel}. Open this page on ${list.frontLabel} to set up other machines.`;
+      for (const row of list.machines || []) show(row);
+      $('setup').hidden = false;
+      return true;
+    }
+    const machines = list.machines || [];
+    $('setupLead').textContent = 'This page rechecks by itself after each step. A machine is ready when the check here says so.';
+    for (const row of machines) show(row);
+    $('setup').hidden = machines.length === 0;
+    // These rows carry the same reasons with the steps to fix them.
+    if (machines.length) $('machineNotes')?.replaceChildren();
+    return machines.length > 0;
+  }
+
+  return { refresh, stop: stopPolling };
+}

package/dashboard/desktop.css

@@ -34,3 +34,9 @@ body.desktop-live #localCursor{display:block}
 .machine-notes{margin:.8rem 0 0;padding-left:1.1rem;font-size:.95rem;line-height:1.4}
 .machine-notes li{margin:.35rem 0}
 .machine-notes:empty{display:none}
+.setup-rows { list-style: none; margin: 0; padding: 0; }
+.setup-rows li { border-top: 1px solid currentColor; padding: 12px 0; }
+.setup-rows p { margin: 6px 0; overflow-wrap: anywhere; }
+.setup-actions { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 8px; }
+.setup-note:empty { display: none; }
+.setup-quiet { background: none; border: none; color: inherit; opacity: 0.7; text-decoration: underline; }

package/dashboard/desktop.html

@@ -20,6 +20,11 @@
     <button id="requestButton">Open selected machine</button>
     <ul id="machineNotes" class="machine-notes" aria-label="Machines that are not ready"></ul>
   </section>
+  <section id="setup" hidden>
+    <h2>Machines</h2>
+    <p id="setupLead"></p>
+    <ul id="setupRows" class="setup-rows" aria-label="Each machine and its next step"></ul>
+  </section>
   <section id="control" hidden>
     <div class="desktop-bar"><strong id="machineName"></strong><span id="liveStatus" role="status"></span><button id="stopButton" class="danger">Stop</button></div>
     <div id="surface" aria-label="Remote desktop touch surface">

package/dashboard/desktop.js

@@ -600,12 +600,15 @@ async function api(path, method = 'GET', body, signal) {
   if (!response.ok) {
     const error = new Error(result.error || `Server answered ${response.status}`);
     error.httpStatus = response.status;
+    if (result.step) error.step = result.step;
     throw error;
   }
   return result;
 }
 
 function requirePinAgain() {
+  desktopSetup?.stop();
+  if ($('setup')) $('setup').hidden = true;
   token = '';
   operatorSession = '';
   $('retryButton').hidden = true;
@@ -614,7 +617,40 @@ function requirePinAgain() {
   status('Your dashboard session ended. Enter your PIN again.');
 }
 
-async function loadTargetsAndMaybeOpen() {
+let desktopSetup = null;
+async function refreshSetup() {
+  try {
+    if (!desktopSetup) {
+      const { createDesktopSetup } = await import('./desktop-setup.js');
+      desktopSetup = createDesktopSetup({
+        api, $,
+        onPinLost: () => requirePinAgain(),
+        onReady: async row => {
+          status(`${row.label} is ready.`);
+          await loadTargetsAndMaybeOpen({ open: false });
+        },
+      });
+    }
+    await desktopSetup.refresh();
+  } catch {
+    // @silent-fallback-ok — setup is an aid; the picker above it still works.
+  }
+}
+
+// Setup exists even while this machine's own desktop is off, which is exactly
+// when /desktop/targets answers 503.
+async function loadDesktopPage(options) {
+  try { await loadTargetsAndMaybeOpen(options); }
+  catch (error) {
+    if (error.httpStatus !== 503) throw error;
+    $('unlock').hidden = true;
+    $('request').hidden = true;
+    status('Remote Desktop is off here. Set it up below.');
+  }
+  await refreshSetup();
+}
+
+async function loadTargetsAndMaybeOpen({ open = true } = {}) {
   const targets = await api('/desktop/targets');
   const machines = targets.machines || [];
   $('machine').replaceChildren();
@@ -664,7 +700,7 @@ async function loadTargetsAndMaybeOpen() {
     return;
   }
   $('retryButton').hidden = true;
-  if (hasPreferredMachine || (machines.length === 1 && ready.length === 1)) {
+  if (open && (hasPreferredMachine || (machines.length === 1 && ready.length === 1))) {
     if (!hasPreferredMachine) $('machine').value = ready[0].value;
     status(`Opening ${$('machine').selectedOptions[0].textContent}…`);
     await requestDesktop();
@@ -689,7 +725,7 @@ $('unlockButton').addEventListener('click', async () => {
     token = result.token;
     operatorSession = result.operatorSessionToken;
     $('pin').value = '';
-    await loadTargetsAndMaybeOpen();
+    await loadDesktopPage();
   } catch (error) {
     if (/dashboard operator session|dashboard PIN session/i.test(error.message || '')) requirePinAgain();
     else status(error.message || 'Could not unlock.');
@@ -699,7 +735,7 @@ $('unlockButton').addEventListener('click', async () => {
 
 $('retryButton').addEventListener('click', async () => {
   $('retryButton').disabled = true;
-  try { await loadTargetsAndMaybeOpen(); }
+  try { await loadDesktopPage(); }
   catch (error) {
     if (/dashboard operator session|dashboard PIN session/i.test(error.message || '')) requirePinAgain();
     else status(error.message || 'Could not check this machine.');

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"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"}

package/dist/commands/server.js

@@ -3873,6 +3873,9 @@ export async function startServer(options) {
     // i.e. this machine is trivially the owner — a strict single-process limiter.
     // The pool block later calls configureBounds AGAIN to add the resolver.
     notificationBatcher.configureBounds({ stateDir: config.stateDir });
+    // Mobile push hub-notice hook (docs/specs/mobile-push.md §2.3); reads the live adapter.
+    let _hubNoticeAdapter = null;
+    const _hubNoticeHook = (t) => _hubNoticeAdapter?.onHubPost?.(t);
     // State reference — set once StateManager is created, used by notify()
     let _notifyState = null;
     /**
@@ -3895,6 +3898,13 @@ export async function startServer(options) {
                 return;
             }
         }
+        // Mobile push (docs/specs/mobile-push.md §2.3): a hub notice the filter admitted.
+        if ((!topicId || topicId === hubTopicId) && hubTopicId) {
+            try {
+                _hubNoticeHook?.({ kind: 'notice', dedupeKey: `notice:${category}`, priority: tier === 'IMMEDIATE' ? 'URGENT' : undefined });
+            }
+            catch { /* @silent-fallback-ok — push is best-effort and never affects the notice */ }
+        }
         // Telegram: via notification batcher
         const resolvedTopicId = topicId ?? hubTopicId;
         if (resolvedTopicId) {
@@ -7804,6 +7814,7 @@ export async function startServer(options) {
                 systemTopics: systemTopicsHooks(state),
             }, config.stateDir);
             armHolderForwardWait(telegram);
+            _hubNoticeAdapter = telegram;
             console.log(pc.green(`  Telegram send-only mode (${isStandbyTelegram ? 'standby' : lifelineOwnsPolling ? 'lifeline owns polling (lease detected)' : 'lifeline owns polling'})`));
             // Send-only still owns the attention store: run its hourly lifecycle
             // pass here too (start() is never called on this path). Idempotent.
@@ -7910,6 +7921,7 @@ export async function startServer(options) {
                 systemTopics: systemTopicsHooks(state),
             }, config.stateDir);
             armHolderForwardWait(telegram);
+            _hubNoticeAdapter = telegram;
             telegram.intelligence = sharedIntelligence ?? null;
             await telegram.start();
             console.log(pc.green(`  Telegram connected (stall alerts: ${sharedIntelligence ? 'LLM-gated' : 'timer-only'})`));