clementine-agent 1.0.73 → 1.0.75

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

@@ -208,14 +208,10 @@ Steps:
         fields: [
             {
                 key: 'contact',
-                label: 'Contact',
+                label: 'Phone number or email',
+                placeholder: '+15551234567  or  someone@example.com',
                 required: true,
-                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.',
-                    allowCustom: true,
-                },
+                help: 'Paste the contact\'s iMessage handle exactly as it appears in your Messages thread. The iMessage MCP\'s search_contacts reads the Contacts app via AppleScript and is unreliable — we bypass it by letting you paste the handle directly.',
             },
             { key: 'limit', label: 'Max messages per run', placeholder: '50', defaultValue: '50' },
         ],

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);
@@ -2654,7 +2659,13 @@ export async function cmdDashboard(opts) {
             }
             const { query } = await import('@anthropic-ai/claude-agent-sdk');
             const { parseJsonResponse } = await import('../brain/llm-client.js');
+            const { getMcpServersForAgent } = await import('../agent/mcp-bridge.js');
             const { MODELS } = await import('../config.js');
+            // Pass the full MCP server map so the one-shot probe can call
+            // Extension-provided tools (iMessage, figma, supabase, etc.).
+            // Without this the SDK only sees built-in + claude_ai_* tools
+            // and every Extension tool call is silently rejected at runtime.
+            const mcpServers = getMcpServersForAgent();
             // Strict prompt: force JSON-only output. The tool lookup goes through
             // the SDK so claude_ai_* and regular MCP servers work uniformly.
             const stream = query({
@@ -2667,6 +2678,7 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
                     maxTurns: 3,
                     systemPrompt: 'You are a data enumerator. You call the given tool once, extract the items from its response, and emit a strict JSON array. No commentary.',
                     allowedTools: [tool],
+                    mcpServers,
                     permissionMode: 'bypassPermissions',
                     settingSources: [],
                 },
@@ -10784,12 +10796,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); }, 600),
+              };
+            };
+            return;
+          }
+
           try {
             const resp = await apiFetch('/api/brain/mcp/probe', {
               method: 'POST', headers: { 'content-type': 'application/json' },
@@ -10836,6 +10879,64 @@ 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) {
+              // If the raw preview is anything other than an empty array (with
+              // or without a markdown code fence), show it so the user can tell
+              // whether the tool actually ran.
+              const trimmed = (data.rawPreview || '').trim();
+              const isEmptyArray = /^\s*\[\s*\]\s*$/.test(trimmed.replace(/^[^\[]*/, '').replace(/[^\]]*$/, ''));
+              const rawHint = trimmed && !isEmptyArray
+                ? ' <span style="color:var(--muted)">Tool said: ' + escapeHtml(trimmed.slice(0, 140)) + '</span>'
+                : '';
+              resultsEl.innerHTML = '<div style="color:#8a5a00;font-size:12px;padding:6px">No matches for "' + escapeHtml(query) + '". The tool may be limited by macOS permissions or not support this query — use <a href="#" onclick="brainFieldPickerToggleCustom(\\'' + field.key + '\\', \\'\\');return false">type a value directly</a>.' + rawHint + '</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.75",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",