clementine-agent 1.0.73 → 1.0.74

package/dist/brain/connector-recipes.d.ts

@@ -21,8 +21,18 @@ export interface RecipeFieldPicker {
     /** Full tool name, e.g. "mcp__claude_ai_Google_Drive__search_files" */
     tool: string;
     /** Natural-language instruction to the probe agent — becomes the body of
-     *  "Call the tool X to {intent}, return a JSON array of {id, label}". */
+     *  "Call the tool X to {intent}, return a JSON array of {id, label}".
+     *  For typeahead pickers, may include the placeholder `{{query}}` which
+     *  the server substitutes with the user's typed search string. */
     intent: string;
+    /** When set, the picker renders as a typeahead: user types at least
+     *  `minQueryLength` chars (default 2), we debounce ~400ms, then fire the
+     *  probe with `{{query}}` replaced. Use for tools whose list operation
+     *  requires a query argument (e.g. search_contacts, Gmail search). */
+    queryArg?: string;
+    /** Minimum characters the user must type before firing the probe. Ignored
+     *  when queryArg is unset. Default 2. */
+    minQueryLength?: number;
     /** If true, user can type a custom value instead of picking from the list
      *  (falls back to the raw text). Useful when the source allows queries
      *  that aren't enumerable. */

package/dist/brain/connector-recipes.js

@@ -213,7 +213,9 @@ Steps:
                 help: 'Pick an iMessage contact. Their phone number or email becomes the thread id.',
                 picker: {
                     tool: 'mcp__imessage__search_contacts',
-                    intent: 'list my iMessage contacts. Use the handle (phone number or email) as id, the display name (or handle if no name) as label, and the most-recent-message date as sublabel.',
+                    intent: 'call search_contacts with query "{{query}}". For each match, output {id: the contact\'s phone number or email handle, label: the display name (or the handle if no name), sublabel: "handle: " + handle}. Return up to 15 results.',
+                    queryArg: 'query',
+                    minQueryLength: 2,
                     allowCustom: true,
                 },
             },

package/dist/cli/dashboard.js

@@ -2635,15 +2635,20 @@ export async function cmdDashboard(opts) {
         try {
             const body = (req.body ?? {});
             const tool = String(body.tool ?? '').trim();
-            const intent = String(body.intent ?? '').trim();
+            const rawIntent = String(body.intent ?? '').trim();
+            const userQuery = String(body.query ?? '').trim();
             if (!tool) {
                 res.status(400).json({ error: 'tool is required' });
                 return;
             }
-            if (!intent) {
+            if (!rawIntent) {
                 res.status(400).json({ error: 'intent is required' });
                 return;
             }
+            // Typeahead pickers include a {{query}} placeholder. Substitute (and
+            // escape any JSON-breakers) before cache key + prompt.
+            const safeQuery = userQuery.replace(/"/g, '\\"').slice(0, 200);
+            const intent = rawIntent.replace(/\{\{query\}\}/g, safeQuery);
             const cacheKey = `${tool}::${intent}`;
             if (!body.force) {
                 const cached = brainProbeCache.get(cacheKey);
@@ -10784,12 +10789,43 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
           brainFeedWizardRender();
         }
 
+        // Per-field typeahead state: { [fieldKey]: { timer, lastQuery } }
+        const brainPickerTypeahead = {};
+
         async function brainRenderFieldPicker(field, values) {
           const container = document.querySelector('[data-field-picker="' + field.key + '"]');
           const hidden = document.querySelector('input[type=hidden][data-field="' + field.key + '"]');
           if (!container || !hidden) return;
           const picker = field.picker;
 
+          // Typeahead mode: render a search box. User types → debounce → probe.
+          if (picker.queryArg) {
+            const minLen = picker.minQueryLength || 2;
+            const currentVal = hidden.value || values[field.key] || '';
+            container.innerHTML =
+              '<input type="text" id="brain-picker-search-' + field.key + '" placeholder="Type to search (min ' + minLen + ' chars)…" style="width:100%" value="">' +
+              '<div id="brain-picker-results-' + field.key + '" style="margin-top:6px;max-height:240px;overflow-y:auto"></div>' +
+              (currentVal
+                ? '<div style="font-size:12px;margin-top:6px">Selected: <code>' + escapeHtml(currentVal) + '</code></div>'
+                : '');
+            const searchEl = document.getElementById('brain-picker-search-' + field.key);
+            searchEl.oninput = function() {
+              const q = this.value.trim();
+              if (brainPickerTypeahead[field.key] && brainPickerTypeahead[field.key].timer) {
+                clearTimeout(brainPickerTypeahead[field.key].timer);
+              }
+              if (q.length < minLen) {
+                document.getElementById('brain-picker-results-' + field.key).innerHTML =
+                  '<div style="color:var(--muted);font-size:12px;padding:6px">Type at least ' + minLen + ' characters…</div>';
+                return;
+              }
+              brainPickerTypeahead[field.key] = {
+                timer: setTimeout(function() { brainFireTypeaheadProbe(field, q); }, 400),
+              };
+            };
+            return;
+          }
+
           try {
             const resp = await apiFetch('/api/brain/mcp/probe', {
               method: 'POST', headers: { 'content-type': 'application/json' },
@@ -10836,6 +10872,56 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
           }
         }
 
+        async function brainFireTypeaheadProbe(field, query) {
+          const resultsEl = document.getElementById('brain-picker-results-' + field.key);
+          const hidden = document.querySelector('input[type=hidden][data-field="' + field.key + '"]');
+          if (!resultsEl || !hidden) return;
+          resultsEl.innerHTML = '<div style="color:var(--muted);font-size:12px;padding:6px">Searching…</div>';
+          try {
+            const resp = await apiFetch('/api/brain/mcp/probe', {
+              method: 'POST', headers: { 'content-type': 'application/json' },
+              body: JSON.stringify({ tool: field.picker.tool, intent: field.picker.intent, query }),
+            });
+            const data = await resp.json();
+            if (!resp.ok) throw new Error(data.error || 'probe failed');
+            const items = data.items || [];
+            if (!items.length) {
+              resultsEl.innerHTML = '<div style="color:#8a5a00;font-size:12px;padding:6px">No matches for "' + escapeHtml(query) + '"' + (data.rawPreview ? ' (' + escapeHtml(data.rawPreview.slice(0, 100)) + ')' : '') + '</div>';
+              return;
+            }
+            resultsEl.innerHTML = items.map(function(it) {
+              const lbl = escapeHtml(it.label) + (it.sublabel ? ' <span style="color:var(--muted);font-size:11px">— ' + escapeHtml(it.sublabel) + '</span>' : '');
+              return '<button class="btn" onclick="brainPickTypeaheadItem(\\'' + field.key + '\\', \\'' + encodeURIComponent(it.id) + '\\', \\'' + encodeURIComponent(it.label) + '\\')" style="display:block;width:100%;text-align:left;padding:6px 10px;margin-bottom:2px">' + lbl + '</button>';
+            }).join('') +
+              '<div style="font-size:11px;color:var(--muted);margin-top:4px">' + items.length + ' result' + (items.length === 1 ? '' : 's') + (data.cached ? ' (cached)' : '') + '</div>';
+          } catch (err) {
+            resultsEl.innerHTML = '<div style="color:#e66;font-size:12px;padding:6px">' + escapeHtml(String(err && err.message ? err.message : err)) + '</div>';
+          }
+        }
+
+        function brainPickTypeaheadItem(fieldKey, encodedId, encodedLabel) {
+          const id = decodeURIComponent(encodedId);
+          const label = decodeURIComponent(encodedLabel);
+          const hidden = document.querySelector('input[type=hidden][data-field="' + fieldKey + '"]');
+          if (hidden) hidden.value = id;
+          // Show a confirmation chip and collapse the results.
+          const container = document.querySelector('[data-field-picker="' + fieldKey + '"]');
+          if (!container) return;
+          const searchEl = document.getElementById('brain-picker-search-' + fieldKey);
+          if (searchEl) searchEl.value = label;
+          const resultsEl = document.getElementById('brain-picker-results-' + fieldKey);
+          if (resultsEl) resultsEl.innerHTML = '';
+          // Inject a "selected" line
+          let sel = container.querySelector('.brain-picker-selected');
+          if (!sel) {
+            sel = document.createElement('div');
+            sel.className = 'brain-picker-selected';
+            sel.style.cssText = 'font-size:12px;margin-top:6px';
+            container.appendChild(sel);
+          }
+          sel.innerHTML = '✓ Selected: <b>' + escapeHtml(label) + '</b> <code style="font-size:11px;color:var(--muted)">' + escapeHtml(id) + '</code>';
+        }
+
         function brainFieldPickerToggleCustom(fieldKey, encodedPicker) {
           const container = document.querySelector('[data-field-picker="' + fieldKey + '"]');
           const hidden = document.querySelector('input[type=hidden][data-field="' + fieldKey + '"]');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.0.73",
+  "version": "1.0.74",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",