@dollhousemcp/mcp-server 2.0.9 → 2.0.10

package/dist/web/public/app.js

@@ -1796,6 +1796,17 @@ function safeParseYaml(content) {
     }
   }
 
+  // ── URL parameter helpers ────────────────────────────────────────────────
+
+  /**
+   * Map sort + order URL params to the select value format used by the UI.
+   */
+  function mapSortParams(sort = 'name', order = 'asc') {
+    if (sort === 'name') return `name-${order}`;
+    if (sort === 'updated' || sort === 'created') return `date-${order}`;
+    return `${sort}-${order}`;
+  }
+
   // ── Event wiring ───────────────────────────────────────────────────────────
 
   document.addEventListener('DOMContentLoaded', () => {
@@ -1941,14 +1952,114 @@ function safeParseYaml(content) {
       });
     };
 
+    /**
+     * Parse the URL hash into tab name and query parameters.
+     * Supports fragment-query pattern: #tab?key=value&key=value
+     * @returns {{ tab: string, params: URLSearchParams }}
+     */
+    function getTabAndParams() {
+      const raw = globalThis.location.hash.replace('#', '');
+      // Guard against excessively long URLs (browser limit ~2048 chars)
+      if (raw.length > 2048) return { tab: '', params: new URLSearchParams() };
+      const qIdx = raw.indexOf('?');
+      if (qIdx === -1) return { tab: raw, params: new URLSearchParams() };
+      return {
+        tab: raw.substring(0, qIdx),
+        params: new URLSearchParams(raw.substring(qIdx + 1)),
+      };
+    }
+
+    // Expose for other scripts (logs.js, metrics.js, permissions.js)
+    globalThis.DollhouseConsole = globalThis.DollhouseConsole || {};
+    globalThis.DollhouseConsole.getUrlParams = () => getTabAndParams().params;
+
+    /**
+     * Apply URL params to the portfolio tab.
+     * Reads q, type, name, sort, order, active, category, author, page.
+     */
+    function applyPortfolioParams(params) {
+      if (!params || params.toString() === '') return;
+
+      applyPortfolioSearch(params);
+      applyPortfolioTypeFilter(params);
+      applyPortfolioSort(params);
+
+      // active — filter to active elements only
+      if (params.get('active') === 'true') {
+        activeSource = 'portfolio';
+      }
+
+      // page
+      const page = params.get('page');
+      if (page) {
+        currentPage = Math.max(1, Number.parseInt(page, 10) || 1);
+      }
+
+      applyFilters();
+      applyPortfolioNameNavigation(params);
+    }
+
+    function applyPortfolioSearch(params) {
+      const q = params.get('q');
+      if (!q) return;
+      const searchInput = document.getElementById('search-input');
+      if (searchInput) {
+        searchInput.value = q;
+        searchQuery = q.toLowerCase();
+      }
+    }
+
+    function applyPortfolioTypeFilter(params) {
+      const type = params.get('type');
+      if (!type) return;
+      activeTypes.clear();
+      activeTypes.add(type);
+      document.querySelectorAll('.type-btn').forEach(btn => {
+        btn.classList.toggle('active', btn.dataset.type === type);
+      });
+    }
+
+    function applyPortfolioSort(params) {
+      const sort = params.get('sort');
+      const order = params.get('order');
+      if (!sort && !order) return;
+      const sortSelect = document.getElementById('sort-select');
+      if (sortSelect) {
+        const mapped = mapSortParams(sort, order);
+        sortSelect.value = mapped;
+        activeSort = mapped;
+      }
+    }
+
+    function applyPortfolioNameNavigation(params) {
+      const name = params.get('name');
+      if (!name) return;
+      requestAnimationFrame(() => {
+        const card = document.querySelector(`[data-element-name="${CSS.escape(name)}"]`);
+        if (card) {
+          card.click();
+          card.scrollIntoView({ behavior: 'smooth', block: 'center' });
+        }
+      });
+    }
+
     // Tab selection priority: URL hash > localStorage > first-visit setup > portfolio default
     function applyHashTab() {
-      const hashTab = globalThis.location.hash.replace('#', '');
+      const { tab: hashTab, params } = getTabAndParams();
       if (hashTab && document.getElementById('tab-' + hashTab)) {
         switchToTab(hashTab);
-        lazyInitTab(hashTab, tabInits);
+        lazyInitTab(hashTab, tabInits, params);
         localStorage.setItem(TAB_KEY, hashTab);
-        history.replaceState(null, '', globalThis.location.pathname);
+
+        // Apply tab-specific URL params
+        if (hashTab === 'portfolio') {
+          applyPortfolioParams(params);
+        }
+
+        // Clean hash but preserve it for bookmarkability if params were present
+        if (params.toString() === '') {
+          history.replaceState(null, '', globalThis.location.pathname);
+        }
         return true;
       }
       return false;
@@ -1981,18 +2092,18 @@ function safeParseYaml(content) {
       });
     }
 
-    function lazyInitTab(tab, tabInits) {
+    function lazyInitTab(tab, tabInits, params) {
       const dc = globalThis.DollhouseConsole;
       if (tab === 'logs' && dc?.logs) {
-        if (!tabInits.logs) { tabInits.logs = true; dc.logs.init(); }
+        if (!tabInits.logs) { tabInits.logs = true; dc.logs.init(params); }
         else if (dc.logs.refresh) { dc.logs.refresh(); }
       }
       if (tab === 'metrics' && dc?.metrics) {
-        if (!tabInits.metrics) { tabInits.metrics = true; dc.metrics.init(); }
+        if (!tabInits.metrics) { tabInits.metrics = true; dc.metrics.init(params); }
         else if (dc.metrics.refresh) { dc.metrics.refresh(); }
       }
       if (tab === 'permissions' && dc?.permissions) {
-        if (!tabInits.permissions) { tabInits.permissions = true; dc.permissions.init(); }
+        if (!tabInits.permissions) { tabInits.permissions = true; dc.permissions.init(params); }
         else if (dc.permissions.refresh) { dc.permissions.refresh(); }
       }
     }

package/dist/web/public/index.html

@@ -23,8 +23,11 @@
 
   <header class="site-header">
     <div class="header-brand">
-      <h1 class="site-title">DollhouseMCP Console</h1>
-      <p class="site-tagline">Management console</p>
+      <img src="dollhouse-logo.png" alt="DollhouseMCP" class="header-logo" width="32" height="32">
+      <div class="header-brand-text">
+        <h1 class="site-title">DollhouseMCP</h1>
+        <p class="site-tagline">Management Console</p>
+      </div>
     </div>
     <div class="header-right">
       <nav class="console-tabs" id="console-tabs" aria-label="Console tabs">

package/dist/web/public/logs.js

@@ -58,12 +58,16 @@
     },
   };
 
-  function initLogViewer() {
+  function initLogViewer(urlParams) {
     const container = document.getElementById('log-viewer-root');
     if (!container || container.dataset.initialized === 'true') return;
     container.dataset.initialized = 'true';
 
     buildDOM(container);
+
+    // Apply URL params before binding events and connecting SSE
+    if (urlParams) applyLogUrlParams(urlParams);
+
     bindEvents();
     connectSSE();
 
@@ -73,6 +77,57 @@
     });
   }
 
+  /**
+   * Parse a comma-separated level string and return the minimum valid level.
+   * @param {string} levelParam - e.g., "error,warn" or "info"
+   * @returns {string|null} The minimum valid level, or null if none valid
+   */
+  function parseMinLevel(levelParam) {
+    const levelOrder = ['debug', 'info', 'warn', 'error'];
+    const levels = levelParam.split(',')
+      .map(l => l.trim().toLowerCase())
+      .filter(l => levelOrder.includes(l));
+    if (levels.length === 0) return null;
+    return levels.reduce((min, l) =>
+      levelOrder.indexOf(l) < levelOrder.indexOf(min) ? l : min
+    , levels[0]);
+  }
+
+  /**
+   * Apply URL parameters to log viewer state.
+   * Supports: level, category, source, q (message search), correlationId, tail
+   * @param {URLSearchParams} params
+   */
+  /** Apply a single string URL param to a filter variable and optional DOM element. */
+  function applyStringParam(params, key, setter, element) {
+    const val = params.get(key);
+    if (!val) return;
+    setter(val);
+    if (element) element.value = val;
+  }
+
+  function applyLogUrlParams(params) {
+    if (!params || params.toString() === '') return;
+
+    const level = params.get('level');
+    if (level) {
+      const minLevel = parseMinLevel(level);
+      if (minLevel) {
+        filterLevel = minLevel;
+        if (levelSelect) levelSelect.value = minLevel;
+      }
+    }
+
+    applyStringParam(params, 'category', v => { filterCategory = v; }, categorySelect);
+    applyStringParam(params, 'source', v => { filterSource = v; }, sourceInput);
+    applyStringParam(params, 'q', v => { filterMessage = v; }, searchInput);
+
+    const cid = params.get('correlationId');
+    if (cid) filterCorrelationId = cid;
+
+    if (params.get('tail') === 'false') autoScroll = false;
+  }
+
   function destroyLogViewer() {
     if (eventSource) {
       eventSource.close();

package/dist/web/public/metrics.js

@@ -34,11 +34,14 @@
     },
   };
 
-  function initMetrics() {
+  function initMetrics(urlParams) {
     const container = document.getElementById('metrics-dashboard-root');
     if (!container || container.dataset.initialized === 'true') return;
     container.dataset.initialized = 'true';
 
+    // Apply URL params before building DOM
+    if (urlParams) applyMetricsUrlParams(urlParams);
+
     uPlotAvailable = typeof globalThis.uPlot !== 'undefined'; // NOSONAR — typeof is the safe check for optional globals that may not be loaded
     buildDOM(container);
     bindEvents();
@@ -46,6 +49,34 @@
     pollTimer = setInterval(fetchLatest, POLL_INTERVAL_MS);
   }
 
+  /**
+   * Apply URL parameters to metrics dashboard state.
+   * Supports: since (time range), refresh (poll interval)
+   * @param {URLSearchParams} params
+   */
+  function applyMetricsUrlParams(params) {
+    if (!params || params.toString() === '') return;
+
+    const since = params.get('since');
+    if (since && TIME_RANGES[since]) {
+      activeRange = since;
+    }
+
+    const refresh = params.get('refresh');
+    if (refresh) {
+      const interval = Number.parseInt(refresh, 10);
+      // Cap between 1-300 seconds to prevent excessive or unreasonable polling
+      if (interval > 0) {
+        const capped = Math.min(Math.max(interval, 1), 300);
+        if (pollTimer) clearInterval(pollTimer);
+        pollTimer = setInterval(fetchLatest, capped * 1000);
+      } else if (interval === 0 && pollTimer) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+      }
+    }
+  }
+
   function destroyMetrics() {
     if (pollTimer) {
       clearInterval(pollTimer);

package/dist/web/public/setup.css

@@ -646,3 +646,82 @@
     flex-direction: column;
   }
 }
+
+/* ── Completion banner ────────────────────────────────────────────────── */
+
+.setup-completion-banner {
+  margin: 1.5rem 0 2rem;
+  padding: 1.5rem 2rem;
+  border-radius: 12px;
+  background: color-mix(in srgb, #22c55e 8%, var(--surface-1));
+  border: 2px solid color-mix(in srgb, #22c55e 40%, var(--line));
+  text-align: center;
+  animation: completionFadeIn 0.4s ease-out;
+}
+
+@keyframes completionFadeIn {
+  from { opacity: 0; transform: translateY(-10px); }
+  to   { opacity: 1; transform: translateY(0); }
+}
+
+.setup-completion-icon {
+  font-size: 2.5rem;
+  color: #22c55e;
+  line-height: 1;
+  margin-bottom: 0.5rem;
+}
+
+.setup-completion-banner h3 {
+  margin: 0 0 0.5rem;
+  font-size: 1.3rem;
+  color: var(--text-1);
+}
+
+.setup-completion-banner > p {
+  margin: 0 0 1rem;
+  color: var(--text-2);
+}
+
+.setup-completion-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  max-width: 28rem;
+  margin: 1.25rem auto;
+  text-align: left;
+}
+
+.setup-completion-step {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  color: var(--text-1);
+}
+
+.setup-completion-step-num {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.6rem;
+  height: 1.6rem;
+  border-radius: 50%;
+  background: color-mix(in srgb, #22c55e 20%, var(--surface-1));
+  border: 1px solid color-mix(in srgb, #22c55e 40%, var(--line));
+  font-size: 0.8rem;
+  font-weight: 700;
+  color: #22c55e;
+  flex-shrink: 0;
+}
+
+.setup-completion-terminal-hint {
+  margin-top: 1.25rem;
+  font-size: 0.85rem;
+  color: var(--text-3);
+}
+
+.setup-completion-terminal-hint code {
+  background: var(--surface-2);
+  padding: 0.15rem 0.4rem;
+  border-radius: 4px;
+  font-size: 0.8rem;
+}

package/dist/web/public/setup.js

@@ -358,6 +358,9 @@
           : 'Restart the application to activate.';
         status.classList.add('is-success');
       }
+
+      // Show the completion banner after any successful install
+      showCompletionBanner(client);
     } catch (err) {
       btn.textContent = originalText;
       btn.disabled = false;
@@ -369,6 +372,93 @@
     }
   };
 
+  // ── Completion banner ────────────────────────────────────────────────
+
+  /** Friendly display names for install clients */
+  const CLIENT_DISPLAY_NAMES = {
+    'claude-desktop': 'Claude Desktop',
+    'claude-code': 'Claude Code',
+    'cursor': 'Cursor',
+    'vscode': 'VS Code',
+    'codex': 'Codex',
+    'gemini-cli': 'Gemini CLI',
+    'windsurf': 'Windsurf',
+    'cline': 'Cline',
+    'lmstudio': 'LM Studio',
+  };
+
+  /** Track which clients have been successfully installed this session */
+  const installedClients = [];
+
+  /**
+   * Show or update the completion banner after successful install.
+   * Tracks all installed clients and updates the banner text to reflect
+   * every client that was configured in this session.
+   */
+  const showCompletionBanner = (client) => {
+    const clientName = CLIENT_DISPLAY_NAMES[client] || client;
+
+    // Track this client (avoid duplicates from re-installs)
+    if (!installedClients.includes(clientName)) {
+      installedClients.push(clientName);
+    }
+
+    const clientList = installedClients.length === 1
+      ? `<strong>${installedClients[0]}</strong>`
+      : installedClients.slice(0, -1).map(c => `<strong>${c}</strong>`).join(', ')
+        + ` and <strong>${installedClients.at(-1)}</strong>`;
+
+    const restartList = installedClients.length === 1
+      ? `Restart <strong>${installedClients[0]}</strong> to activate DollhouseMCP`
+      : `Restart any of your configured clients to activate DollhouseMCP`;
+
+    const configuredWord = installedClients.length === 1 ? 'has' : 'have';
+
+    const bannerHTML = `
+      <div class="setup-completion-icon">&#10003;</div>
+      <h3>You're all set!</h3>
+      <p>${clientList} ${configuredWord} been configured with DollhouseMCP.</p>
+      <div class="setup-completion-steps">
+        <div class="setup-completion-step">
+          <span class="setup-completion-step-num">1</span>
+          <span>Close this browser tab</span>
+        </div>
+        <div class="setup-completion-step">
+          <span class="setup-completion-step-num">2</span>
+          <span>${restartList}</span>
+        </div>
+        <div class="setup-completion-step">
+          <span class="setup-completion-step-num">3</span>
+          <span>Start a conversation and ask: <em>"What DollhouseMCP tools do you have?"</em></span>
+        </div>
+      </div>
+      <p class="setup-completion-terminal-hint">In the terminal, type <code>q</code> to exit the installer.</p>
+    `;
+
+    const existing = document.getElementById('setup-completion-banner');
+    if (existing) {
+      // Update the existing banner with the new client list
+      existing.innerHTML = bannerHTML;
+      return;
+    }
+
+    // First install — create and insert the banner
+    const banner = document.createElement('div');
+    banner.id = 'setup-completion-banner';
+    banner.className = 'setup-completion-banner';
+    banner.innerHTML = bannerHTML;
+
+    const setupContent = document.querySelector('.setup-content');
+    const heroSection = setupContent?.querySelector('.setup-hero');
+    if (setupContent && heroSection) {
+      heroSection.after(banner);
+    } else if (setupContent) {
+      setupContent.prepend(banner);
+    }
+
+    banner.scrollIntoView({ behavior: 'smooth', block: 'start' });
+  };
+
   const initInstallButtons = () => {
     document.querySelectorAll('.setup-install-btn').forEach((btn) => {
       btn.addEventListener('click', () => handleInstallClick(btn));

package/dist/web/public/styles.css

@@ -166,7 +166,9 @@ p, li { max-width: 69ch; }
   pointer-events: none;
 }
 
-.header-brand { display: flex; flex-direction: column; gap: 0.05rem; }
+.header-brand { display: flex; flex-direction: row; align-items: center; gap: 0.6rem; }
+.header-brand-text { display: flex; flex-direction: column; gap: 0.05rem; }
+.header-logo { width: 32px; height: 32px; flex-shrink: 0; }
 
 .site-title {
   font-family: var(--font-heading);

package/dist/web/server.d.ts

@@ -89,5 +89,5 @@ export declare function startWebServer(options: WebServerOptions): Promise<WebSe
  * @param port - Port to bind to (default: 3939)
  * @returns Result with URL, server status, and browser open status
  */
-export declare function openPortfolioBrowser(portfolioDir: string, port?: number, mcpAqlHandler?: MCPAQLHandler, tab?: string): Promise<BrowserOpenResult>;
+export declare function openPortfolioBrowser(portfolioDir: string, port?: number, mcpAqlHandler?: MCPAQLHandler, tab?: string, urlParams?: Record<string, string>): Promise<BrowserOpenResult>;
 //# sourceMappingURL=server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAa/E,qEAAqE;AACrE,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kFAAkF;IAClF,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,SAAS,EAAE,MAAM,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,GAAG,CAAC,EAAE,OAAO,SAAS,EAAE,OAAO,CAAC;IAChC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,qBAAqB,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9E,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,qBAAqB,EAAE,cAAc,KAAK,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsCD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkLxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBvJ"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAa/E,qEAAqE;AACrE,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kFAAkF;IAClF,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,SAAS,EAAE,MAAM,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,GAAG,CAAC,EAAE,OAAO,SAAS,EAAE,OAAO,CAAC;IAChC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,qBAAqB,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9E,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,qBAAqB,EAAE,cAAc,KAAK,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsCD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmLxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkC3L"}