total-recall-brain 3.28.2 → 3.30.0

package/src/server/routes/share.mjs

@@ -79,6 +79,8 @@ router.post('/api/share', requireAuth, requireScope('memory:write'), async (req,
         topic,
         priority: 'medium',
         notes: excerpt || '',
+        origin: 'user',
+        requested_via: String(source || '').includes('extension') ? 'extension' : 'share',
       });
 
       return res.status(201).json({

package/src/server/tools.mjs

@@ -524,9 +524,35 @@ export async function meshMintPreAuthKey(options = {}) {
   }
 }
 
+/**
+ * The user asked, in chat, for background research. Recorded as a user request
+ * (runs ahead of autonomous research, no budget applies).
+ */
+export async function queueResearch(topic, notes) {
+  const { requestResearch } = await import('../core/research-gate.mjs');
+  const item = requestResearch({ topic, notes, via: 'chat' });
+  const state = item.status === 'done' ? 'already researched' : item.status === 'pending' ? 'queued' : item.status;
+  return JSON.stringify({ id: item.id, topic: item.topic, status: state, note: 'Runs in the background; findings will appear in memory and future context.' });
+}
+
 // ─── Tool Definitions ─────────────────────────────────────────────────────────
 
 export const AVAILABLE_TOOLS = [
+  {
+    type: 'function',
+    function: {
+      name: 'queue_research',
+      description: 'Queue deep background research on a topic. Use ONLY when the user explicitly asks you to research something in depth or to look into it later. Returns immediately; the findings land in memory and show up in future context. For an answer right now, use search_web instead.',
+      parameters: {
+        type: 'object',
+        properties: {
+          topic: { type: 'string', description: 'Specific, searchable topic, e.g. "Stripe Node SDK v17 webhook signature verification".' },
+          notes: { type: 'string', description: 'Optional: what the user wants to learn and why.' },
+        },
+        required: ['topic'],
+      },
+    },
+  },
   {
     type: 'function',
     function: {
@@ -787,7 +813,7 @@ export const AVAILABLE_TOOLS = [
       parameters: {
         type: 'object',
         properties: {
-          node: { type: 'string', description: 'Target node hostname, slug, or mesh IP (e.g. "macmini", "cloud", "100.64.0.2").' },
+          node: { type: 'string', description: 'Target node hostname, slug, or mesh IP (e.g. "build-box", "cloud", "100.64.0.10").' },
           command: { type: 'string', description: 'Shell command to execute on the remote node (e.g. "uptime", "git status", "docker ps").' },
           timeoutMs: { type: 'integer', description: 'Timeout in milliseconds (default 60000).' },
         },
@@ -804,7 +830,7 @@ export const AVAILABLE_TOOLS = [
         type: 'object',
         properties: {
           node: { type: 'string', description: 'Target node hostname, slug, or mesh IP.' },
-          ssh_user: { type: 'string', description: 'Username to log in as (e.g. "greg", "root", "gregoryiteen").' },
+          ssh_user: { type: 'string', description: 'Username to log in as (e.g. "admin", "root", "deploy").' },
           ssh_port: { type: 'integer', description: 'SSH port (default 22).' },
           identity_file: { type: 'string', description: 'Path to private SSH key file (e.g. "~/.ssh/id_ed25519").' },
           ssh_host: { type: 'string', description: 'Custom host or IP override if not using the mesh IP.' },
@@ -851,6 +877,7 @@ export async function handleToolCall(toolCall) {
   try {
     const args = JSON.parse(argsString);
     switch (name) {
+      case 'queue_research':    return await queueResearch(args.topic, args.notes);
       case 'search_web':        return await executeWebSearch(args.query);
       case 'browser_navigate':  return await browserNavigate(args.url);
       case 'browser_click':     return await browserClick(args.selector);

package/extension/icons/README.md

@@ -1,27 +0,0 @@
-# Extension Icons
-
-This directory should contain the following PNG icon files for the Total Recall Brain Extension:
-
-| File            | Size    | Usage                                      |
-|-----------------|---------|---------------------------------------------|
-| `icon-16.png`   | 16×16   | Favicon, toolbar (small)                    |
-| `icon-48.png`   | 48×48   | Extensions management page                  |
-| `icon-128.png`  | 128×128 | Chrome Web Store, install dialog            |
-
-## Requirements
-
-- Format: PNG with transparency
-- Design: Should match Total Recall branding (brain / recall motif)
-- The manifest references these exact filenames — do not rename without updating `manifest.json`
-
-## Generating placeholder icons
-
-You can generate minimal placeholder PNGs with ImageMagick:
-
-```bash
-convert -size 16x16 xc:'#6366f1' icon-16.png
-convert -size 48x48 xc:'#6366f1' icon-48.png
-convert -size 128x128 xc:'#6366f1' icon-128.png
-```
-
-Replace these with proper branded icons before publishing.

package/extension/lib/preconfigured.js

@@ -1,5 +0,0 @@
-// Exposes default configuration dynamically injected by the server
-self.PreConfigured = {
-  brainUrl: '',
-  pat: ''
-};

package/extension/popup/popup.css

@@ -1,227 +0,0 @@
-/* Total Recall — Popup Styles (Catppuccin Mocha) */
-
-* {
-  margin: 0;
-  padding: 0;
-  box-sizing: border-box;
-}
-
-body {
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-  background: #11111b;
-  color: #cdd6f4;
-  width: 350px;
-  overflow: hidden;
-}
-
-.popup {
-  padding: 16px;
-}
-
-/* ---- Header ---- */
-.popup-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  margin-bottom: 16px;
-}
-
-.popup-header h1 {
-  font-size: 15px;
-  font-weight: 700;
-}
-
-.dot {
-  width: 10px;
-  height: 10px;
-  border-radius: 50%;
-  background: #6c7086;
-  transition: background 0.3s ease;
-}
-
-.dot.connected {
-  background: #a6e3a1;
-  box-shadow: 0 0 6px #a6e3a1;
-}
-
-.dot.disconnected {
-  background: #f38ba8;
-  box-shadow: 0 0 6px #f38ba8;
-}
-
-/* ---- Fields ---- */
-.field-group {
-  margin-bottom: 12px;
-}
-
-.field-group label {
-  display: block;
-  font-size: 11px;
-  font-weight: 600;
-  text-transform: uppercase;
-  letter-spacing: 0.5px;
-  color: #585b70;
-  margin-bottom: 6px;
-}
-
-.field-group input,
-.field-group textarea {
-  width: 100%;
-  padding: 8px 12px;
-  background: #1e1e2e;
-  border: 1px solid #313244;
-  border-radius: 8px;
-  color: #cdd6f4;
-  font-size: 13px;
-  outline: none;
-  font-family: inherit;
-  transition: border-color 0.2s ease;
-}
-
-.field-group input:focus,
-.field-group textarea:focus {
-  border-color: #89b4fa;
-}
-
-.field-group textarea {
-  resize: vertical;
-  min-height: 60px;
-}
-
-.field-group input[readonly] {
-  color: #a6adc8;
-  cursor: default;
-}
-
-/* ---- Buttons ---- */
-.button-row {
-  display: flex;
-  gap: 8px;
-  margin-bottom: 12px;
-}
-
-.btn {
-  flex: 1;
-  padding: 9px 10px;
-  font-size: 13px;
-  font-weight: 600;
-  border: 1px solid #313244;
-  border-radius: 10px;
-  cursor: pointer;
-  transition: background 0.2s ease, border-color 0.2s ease, transform 0.1s ease;
-}
-
-.btn:active {
-  transform: scale(0.97);
-}
-
-.btn:disabled, .btn.loading {
-  opacity: 0.6;
-  cursor: not-allowed;
-  transform: none !important;
-}
-
-.btn.primary {
-  background: #89b4fa;
-  color: #11111b;
-  border-color: #89b4fa;
-}
-
-.btn.primary:hover {
-  background: #74c7ec;
-  border-color: #74c7ec;
-}
-
-.btn.secondary {
-  background: #1e1e2e;
-  color: #cdd6f4;
-}
-
-.btn.secondary:hover {
-  background: #313244;
-  border-color: #89b4fa;
-}
-
-/* ---- Toggle ---- */
-.toggle-row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 10px 0;
-  border-top: 1px solid #313244;
-}
-
-.toggle-label {
-  font-size: 12px;
-  color: #a6adc8;
-}
-
-.switch {
-  position: relative;
-  display: inline-block;
-  width: 36px;
-  height: 20px;
-}
-
-.switch input {
-  opacity: 0;
-  width: 0;
-  height: 0;
-}
-
-.slider {
-  position: absolute;
-  cursor: pointer;
-  inset: 0;
-  background: #313244;
-  border-radius: 20px;
-  transition: background 0.3s ease;
-}
-
-.slider::before {
-  content: '';
-  position: absolute;
-  height: 14px;
-  width: 14px;
-  left: 3px;
-  bottom: 3px;
-  background: #6c7086;
-  border-radius: 50%;
-  transition: transform 0.3s ease, background 0.3s ease;
-}
-
-.switch input:checked + .slider {
-  background: rgba(137, 180, 250, 0.3);
-}
-
-.switch input:checked + .slider::before {
-  transform: translateX(16px);
-  background: #89b4fa;
-}
-
-/* ---- Status Message ---- */
-.status-msg {
-  margin-top: 10px;
-  padding: 8px 12px;
-  border-radius: 8px;
-  font-size: 12px;
-  font-weight: 600;
-  text-align: center;
-  transition: opacity 0.3s ease;
-}
-
-.status-msg.success {
-  background: rgba(166, 227, 161, 0.1);
-  color: #a6e3a1;
-  border: 1px solid rgba(166, 227, 161, 0.3);
-}
-
-.status-msg.error {
-  background: rgba(243, 139, 168, 0.1);
-  color: #f38ba8;
-  border: 1px solid rgba(243, 139, 168, 0.3);
-}
-
-.hidden {
-  display: none !important;
-}

package/extension/popup/popup.html

@@ -1,50 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <title>Total Recall</title>
-  <link rel="stylesheet" href="popup.css">
-</head>
-<body>
-  <div class="popup">
-    <header class="popup-header">
-      <h1>🧠 Total Recall</h1>
-      <div id="connection-dot" class="dot"></div>
-    </header>
-
-    <div class="field-group">
-      <label for="url-input">Page URL</label>
-      <input type="text" id="url-input" readonly />
-    </div>
-
-    <div class="field-group">
-      <label for="note-input">Quick Note</label>
-      <textarea id="note-input" placeholder="Add a note about this page…" rows="3"></textarea>
-    </div>
-
-    <div class="button-row">
-      <button id="btn-remember" class="btn primary">📌 Remember</button>
-      <button id="btn-research" class="btn secondary">🔬 Research</button>
-    </div>
-
-    <div class="toggle-row">
-      <span class="toggle-label">Passive tracking</span>
-      <label class="switch">
-        <input type="checkbox" id="tracking-toggle" />
-        <span class="slider"></span>
-      </label>
-    </div>
-
-    <div id="status-msg" class="status-msg hidden"></div>
-
-    <footer class="popup-footer" style="margin-top: 16px; padding-top: 8px; border-top: 1px solid rgba(255, 255, 255, 0.05); display: flex; justify-content: space-between; font-size: 10px; color: #6c7086;">
-      <span>Total Recall Brain Connection</span>
-      <span id="version-label">v0.1.0</span>
-    </footer>
-  </div>
-
-  <script src="../lib/preconfigured.js"></script>
-  <script src="../lib/brain-client.js"></script>
-  <script src="popup.js"></script>
-</body>
-</html>

package/extension/popup/popup.js

@@ -1,175 +0,0 @@
-// Total Recall — Popup Logic
-
-(function () {
-  'use strict';
-
-  const dot = document.getElementById('connection-dot');
-  const urlInput = document.getElementById('url-input');
-  const noteInput = document.getElementById('note-input');
-  const btnRemember = document.getElementById('btn-remember');
-  const btnResearch = document.getElementById('btn-research');
-  const trackingToggle = document.getElementById('tracking-toggle');
-  const statusMsg = document.getElementById('status-msg');
-
-  // ---- Auto-fill current tab URL ----
-  async function fillCurrentTab() {
-    try {
-      const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
-      if (tab) urlInput.value = tab.url || '';
-    } catch {
-      // ignore — might not have activeTab permission yet
-    }
-  }
-
-  // ---- Connection check ----
-  async function checkConnection() {
-    try {
-      await self.BrainClient.healthCheck();
-      dot.className = 'dot connected';
-
-      // Check for extension updates
-      try {
-        const status = await self.BrainClient.brainFetch('/api/extension/status');
-        const clientVersion = chrome.runtime.getManifest().version;
-        if (status && status.version && status.version !== clientVersion) {
-          const config = await self.BrainClient.getConfig();
-          const brainUrl = config.brainUrl || 'http://127.0.0.1:3000';
-          const footer = document.querySelector('.popup-footer');
-          if (footer) {
-            footer.innerHTML = `
-              <span style="color: #f38ba8; font-weight: bold; display: flex; align-items: center; gap: 4px;">⚠️ Update Available (v${status.version})</span>
-              <a href="${brainUrl}/health" target="_blank" style="color: #89b4fa; text-decoration: none; font-weight: bold;">Download ZIP</a>
-            `;
-          }
-        }
-      } catch (err) {
-        console.error('Failed to check extension update status:', err);
-      }
-    } catch {
-      dot.className = 'dot disconnected';
-    }
-  }
-
-  // ---- Send share message to background ----
-  function sendShare(data) {
-    return new Promise((resolve, reject) => {
-      chrome.runtime.sendMessage({ type: 'SHARE', data }, (res) => {
-        if (chrome.runtime.lastError) return reject(new Error(chrome.runtime.lastError.message));
-        if (res && res.success) return resolve(res);
-        reject(new Error(res?.error || 'Unknown error'));
-      });
-    });
-  }
-
-  // ---- Show status ----
-  function showStatus(message, isError = false) {
-    statusMsg.textContent = message;
-    statusMsg.className = `status-msg ${isError ? 'error' : 'success'}`;
-    statusMsg.classList.remove('hidden');
-    setTimeout(() => statusMsg.classList.add('hidden'), 3000);
-  }
-
-  // ---- Remember ----
-  btnRemember.addEventListener('click', async () => {
-    if (btnRemember.disabled) return;
-    const originalText = btnRemember.innerHTML;
-    btnRemember.innerHTML = '⏳ Remembering...';
-    btnRemember.disabled = true;
-    btnRemember.classList.add('loading');
-    try {
-      const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
-      const note = noteInput.value.trim();
-      const targetUrl = tab?.url || urlInput.value || '';
-      
-      // If we don't have a URL, we must have a note/excerpt
-      if (!targetUrl && !note) {
-        throw new Error('Please enter a note or browse to a webpage to remember.');
-      }
-      if (targetUrl && (targetUrl.startsWith('chrome://') || targetUrl.startsWith('about:') || targetUrl.startsWith('chrome-extension://'))) {
-        if (!note) {
-          throw new Error('Cannot capture system pages. Please enter a note to save.');
-        }
-      }
-
-      const payload = {
-        url: targetUrl && !targetUrl.startsWith('chrome://') && !targetUrl.startsWith('about:') && !targetUrl.startsWith('chrome-extension://') ? targetUrl : undefined,
-        title: tab?.title || '',
-        action: 'remember',
-        source: 'chrome-extension-popup'
-      };
-      if (note) payload.excerpt = note;
-
-      await sendShare(payload);
-      showStatus('Page remembered!');
-      noteInput.value = '';
-    } catch (err) {
-      showStatus('Error: ' + err.message, true);
-    } finally {
-      btnRemember.innerHTML = originalText;
-      btnRemember.disabled = false;
-      btnRemember.classList.remove('loading');
-    }
-  });
-
-  // ---- Research ----
-  btnResearch.addEventListener('click', async () => {
-    if (btnResearch.disabled) return;
-    const originalText = btnResearch.innerHTML;
-    btnResearch.innerHTML = '⏳ Researching...';
-    btnResearch.disabled = true;
-    btnResearch.classList.add('loading');
-    try {
-      const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
-      const note = noteInput.value.trim();
-      const targetUrl = tab?.url || urlInput.value || '';
-
-      if (!targetUrl && !note) {
-        throw new Error('Please enter research notes or browse to a webpage to queue research.');
-      }
-      if (targetUrl && (targetUrl.startsWith('chrome://') || targetUrl.startsWith('about:') || targetUrl.startsWith('chrome-extension://'))) {
-        if (!note) {
-          throw new Error('Cannot research system pages. Please enter research notes.');
-        }
-      }
-
-      const payload = {
-        url: targetUrl && !targetUrl.startsWith('chrome://') && !targetUrl.startsWith('about:') && !targetUrl.startsWith('chrome-extension://') ? targetUrl : undefined,
-        title: tab?.title || '',
-        action: 'research',
-        source: 'chrome-extension-popup'
-      };
-      if (note) payload.excerpt = note;
-
-      await sendShare(payload);
-      showStatus('Research queued!');
-      noteInput.value = '';
-    } catch (err) {
-      showStatus('Error: ' + err.message, true);
-    } finally {
-      btnResearch.innerHTML = originalText;
-      btnResearch.disabled = false;
-      btnResearch.classList.remove('loading');
-    }
-  });
-
-  // ---- Tracking toggle ----
-  async function loadTrackingPref() {
-    const { passiveTracking } = await chrome.storage.sync.get('passiveTracking');
-    trackingToggle.checked = passiveTracking || false;
-  }
-
-  trackingToggle.addEventListener('change', () => {
-    chrome.storage.sync.set({ passiveTracking: trackingToggle.checked });
-  });
-
-  // ---- Init ----
-  fillCurrentTab();
-  checkConnection();
-  loadTrackingPref();
-
-  // Populate version label
-  const versionLabel = document.getElementById('version-label');
-  if (versionLabel) {
-    versionLabel.textContent = 'v' + chrome.runtime.getManifest().version;
-  }
-})();