@dollhousemcp/mcp-server 2.0.27 → 2.0.28

package/dist/web/console/sessionClientPlatform.js

@@ -0,0 +1,83 @@
+/**
+ * Best-effort MCP client platform detection for session metadata.
+ *
+ * This is intentionally conservative: when we cannot identify the host
+ * confidently, we return null rather than guessing from a session ID.
+ */
+const CLIENT_PLATFORM_LABELS = {
+    'claude-code': 'Claude Code',
+    'claude-desktop': 'Claude Desktop',
+    codex: 'Codex',
+    cursor: 'Cursor',
+    vscode: 'VS Code',
+    windsurf: 'Windsurf',
+    'gemini-cli': 'Gemini CLI',
+    cline: 'Cline',
+    lmstudio: 'LM Studio',
+    'web-console': 'Web Console',
+};
+function normalizeText(value) {
+    return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+function includesAny(value, needles) {
+    return needles.some((needle) => value.includes(needle));
+}
+function matchesAnySource(values, needles) {
+    return values.some((value) => includesAny(value, needles));
+}
+const TEXT_PLATFORM_MATCHERS = [
+    { platform: 'cursor', needles: ['cursor'] },
+    { platform: 'windsurf', needles: ['windsurf'] },
+    { platform: 'gemini-cli', needles: ['gemini'] },
+    { platform: 'cline', needles: ['cline'] },
+    { platform: 'lmstudio', needles: ['lmstudio', 'lm studio'] },
+    { platform: 'claude-desktop', needles: ['claude desktop'] },
+    { platform: 'claude-code', needles: ['claude code'] },
+    { platform: 'codex', needles: ['codex'] },
+];
+export function normalizeSessionClientPlatformId(value) {
+    const normalized = normalizeText(value ?? undefined);
+    if (!normalized) {
+        return null;
+    }
+    if (normalized === 'gemini') {
+        return 'gemini-cli';
+    }
+    if (normalized in CLIENT_PLATFORM_LABELS) {
+        return normalized;
+    }
+    return null;
+}
+export function getSessionClientPlatformLabel(platform) {
+    return platform ? CLIENT_PLATFORM_LABELS[platform] ?? '' : '';
+}
+export function detectSessionClientPlatformId(env = process.env, argv = process.argv, execPath = process.execPath, title = process.title) {
+    const termProgram = normalizeText(env.TERM_PROGRAM);
+    const argvText = normalizeText(argv.join(' '));
+    const execPathText = normalizeText(execPath);
+    const titleText = normalizeText(title);
+    const textSources = [argvText, execPathText, titleText];
+    if (env.CLAUDE_DESKTOP === 'true' || env.CLAUDE_DESKTOP_VERSION) {
+        return 'claude-desktop';
+    }
+    if (env.CLAUDE_CODE === 'true' || termProgram === 'claude-code') {
+        return 'claude-code';
+    }
+    if (env.VSCODE_CWD ||
+        env.VSCODE_PID ||
+        env.VSCODE_IPC_HOOK ||
+        env.VSCODE_NLS_CONFIG ||
+        termProgram === 'vscode') {
+        return 'vscode';
+    }
+    if (env.CODEX_HOME || termProgram === 'codex') {
+        return 'codex';
+    }
+    for (const matcher of TEXT_PLATFORM_MATCHERS) {
+        if (matchesAnySource(textSources, matcher.needles)) {
+            return matcher.platform;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2Vzc2lvbkNsaWVudFBsYXRmb3JtLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3dlYi9jb25zb2xlL3Nlc3Npb25DbGllbnRQbGF0Zm9ybS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7R0FLRztBQWNILE1BQU0sc0JBQXNCLEdBQTRDO0lBQ3RFLGFBQWEsRUFBRSxhQUFhO0lBQzVCLGdCQUFnQixFQUFFLGdCQUFnQjtJQUNsQyxLQUFLLEVBQUUsT0FBTztJQUNkLE1BQU0sRUFBRSxRQUFRO0lBQ2hCLE1BQU0sRUFBRSxTQUFTO0lBQ2pCLFFBQVEsRUFBRSxVQUFVO0lBQ3BCLFlBQVksRUFBRSxZQUFZO0lBQzFCLEtBQUssRUFBRSxPQUFPO0lBQ2QsUUFBUSxFQUFFLFdBQVc7SUFDckIsYUFBYSxFQUFFLGFBQWE7Q0FDN0IsQ0FBQztBQUVGLFNBQVMsYUFBYSxDQUFDLEtBQXlCO0lBQzlDLE9BQU8sT0FBTyxLQUFLLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNyRSxDQUFDO0FBRUQsU0FBUyxXQUFXLENBQUMsS0FBYSxFQUFFLE9BQTBCO0lBQzVELE9BQU8sT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDO0FBQzFELENBQUM7QUFFRCxTQUFTLGdCQUFnQixDQUFDLE1BQXlCLEVBQUUsT0FBMEI7SUFDN0UsT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7QUFDN0QsQ0FBQztBQUVELE1BQU0sc0JBQXNCLEdBR3ZCO0lBQ0gsRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLE9BQU8s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LHNCQUFzQixFQUFFLENBQUM7UUFDN0MsSUFBSSxnQkFBZ0IsQ0FBQyxXQUFXLEVBQUUsT0FBTyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDbkQsT0FBTyxPQUFPLENBQUMsUUFBUSxDQUFDO1FBQzFCLENBQUM7SUFDSCxDQUFDO0lBRUQsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBCZXN0LWVmZm9ydCBNQ1AgY2xpZW50IHBsYXRmb3JtIGRldGVjdGlvbiBmb3Igc2Vzc2lvbiBtZXRhZGF0YS5cbiAqXG4gKiBUaGlzIGlzIGludGVudGlvbmFsbHkgY29uc2VydmF0aXZlOiB3aGVuIHdlIGNhbm5vdCBpZGVudGlmeSB0aGUgaG9zdFxuICogY29uZmlkZW50bHksIHdlIHJldHVybiBudWxsIHJhdGhlciB0aGFuIGd1ZXNzaW5nIGZyb20gYSBzZXNzaW9uIElELlxuICovXG5cbmV4cG9ydCB0eXBlIFNlc3Npb25DbGllbnRQbGF0Zm9ybUlkID1cbiAgfCAnY2xhdWRlLWNvZGUnXG4gIHwgJ2NsYXVkZS1kZXNrdG9wJ1xuICB8ICdjb2RleCdcbiAgfCAnY3Vyc29yJ1xuICB8ICd2c2NvZGUnXG4gIHwgJ3dpbmRzdXJmJ1xuICB8ICdnZW1pbmktY2xpJ1xuICB8ICdjbGluZSdcbiAgfCAnbG1zdHVkaW8nXG4gIHwgJ3dlYi1jb25zb2xlJztcblxuY29uc3QgQ0xJRU5UX1BMQVRGT1JNX0xBQkVMUzogUmVjb3JkPFNlc3Npb25DbGllbnRQbGF0Zm9ybUlkLCBzdHJpbmc+ID0ge1xuICAnY2xhdWRlLWNvZGUnOiAnQ2xhdWRlIENvZGUnLFxuICAnY2xhdWRlLWRlc2t0b3AnOiAnQ2xhdWRlIERlc2t0b3AnLFxuICBjb2RleDogJ0NvZGV4JyxcbiAgY3Vyc29yOiAnQ3Vyc29yJyxcbiAgdnNjb2RlOiAnVlMgQ29kZScsXG4gIHdpbmRzdXJmOiAnV2luZHN1cmYnLFxuICAnZ2VtaW5pLWNsaSc6ICdHZW1pbmkgQ0xJJyxcbiAgY2xpbmU6ICdDbGluZScsXG4gIGxtc3R1ZGlvOiAnTE0gU3R1ZGlvJyxcbiAgJ3dlYi1jb25zb2xlJzogJ1dlYiBDb25zb2xlJyxcbn07XG5cbmZ1bmN0aW9uIG5vcm1hbGl6ZVRleHQodmFsdWU6IHN0cmluZyB8IHVuZGVmaW5lZCk6IHN0cmluZyB7XG4gIHJldHVybiB0eXBlb2YgdmFsdWUgPT09ICdzdHJpbmcnID8gdmFsdWUudHJpbSgpLnRvTG93ZXJDYXNlKCkgOiAnJztcbn1cblxuZnVuY3Rpb24gaW5jbHVkZXNBbnkodmFsdWU6IHN0cmluZywgbmVlZGxlczogcmVhZG9ubHkgc3RyaW5nW10pOiBib29sZWFuIHtcbiAgcmV0dXJuIG5lZWRsZXMuc29tZSgobmVlZGxlKSA9PiB2YWx1ZS5pbmNsdWRlcyhuZWVkbGUpKTtcbn1cblxuZnVuY3Rpb24gbWF0Y2hlc0FueVNvdXJjZSh2YWx1ZXM6IHJlYWRvbmx5IHN0cmluZ1tdLCBuZWVkbGVzOiByZWFkb25seSBzdHJpbmdbXSk6IGJvb2xlYW4ge1xuICByZXR1cm4gdmFsdWVzLnNvbWUoKHZhbHVlKSA9PiBpbmNsdWRlc0FueSh2YWx1ZSwgbmVlZGxlcykpO1xufVxuXG5jb25zdCBURVhUX1BMQVRGT1JNX01BVENIRVJTOiBSZWFkb25seUFycmF5PHtcbiAgcGxhdGZvcm06IFNlc3Npb25DbGllbnRQbGF0Zm9ybUlkO1xuICBuZWVkbGVzOiByZWFkb25seSBzdHJpbmdbXTtcbn0+ID0gW1xuICB7IHBsYXRmb3JtOiAnY3Vyc29yJywgbmVlZGxlczogWydjdXJzb3InXSB9LFxuICB7IHBsYXRmb3JtOiAnd2luZHN1cmYnLCBuZWVkbGVzOiBbJ3dpbmRzdXJmJ10gfSxcbiAgeyBwbGF0Zm9ybTogJ2dlbWluaS1jbGknLCBuZWVkbGVzOiBbJ2dlbWluaSddIH0sXG4gIHsgcGxhdGZvcm06ICdjbGluZScsIG5lZWRsZXM6IFsnY2xpbmUnXSB9LFxuICB7IHBsYXRmb3JtOiAnbG1zdHVkaW8nLCBuZWVkbGVzOiBbJ2xtc3R1ZGlvJywgJ2xtIHN0dWRpbyddIH0sXG4gIHsgcGxhdGZvcm06ICdjbGF1ZGUtZGVza3RvcCcsIG5lZWRsZXM6IFsnY2xhdWRlIGRlc2t0b3AnXSB9LFxuICB7IHBsYXRmb3JtOiAnY2xhdWRlLWNvZGUnLCBuZWVkbGVzOiBbJ2NsYXVkZSBjb2RlJ10gfSxcbiAgeyBwbGF0Zm9ybTogJ2NvZGV4JywgbmVlZGxlczogWydjb2RleCddIH0sXG5dO1xuXG5leHBvcnQgZnVuY3Rpb24gbm9ybWFsaXplU2Vzc2lvbkNsaWVudFBsYXRmb3JtSWQoXG4gIHZhbHVlOiBzdHJpbmcgfCBudWxsIHwgdW5kZWZpbmVkLFxuKTogU2Vzc2lvbkNsaWVudFBsYXRmb3JtSWQgfCBudWxsIHtcbiAgY29uc3Qgbm9ybWFsaXplZCA9IG5vcm1hbGl6ZVRleHQodmFsdWUgPz8gdW5kZWZpbmVkKTtcbiAgaWYgKCFub3JtYWxpemVkKSB7XG4gICAgcmV0dXJuIG51bGw7XG4gIH1cblxuICBpZiAobm9ybWFsaXplZCA9PT0gJ2dlbWluaScpIHtcbiAgICByZXR1cm4gJ2dlbWluaS1jbGknO1xuICB9XG5cbiAgaWYgKG5vcm1hbGl6ZWQgaW4gQ0xJRU5UX1BMQVRGT1JNX0xBQkVMUykge1xuICAgIHJldHVybiBub3JtYWxpemVkIGFzIFNlc3Npb25DbGllbnRQbGF0Zm9ybUlkO1xuICB9XG5cbiAgcmV0dXJuIG51bGw7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBnZXRTZXNzaW9uQ2xpZW50UGxhdGZvcm1MYWJlbChcbiAgcGxhdGZvcm06IFNlc3Npb25DbGllbnRQbGF0Zm9ybUlkIHwgbnVsbCB8IHVuZGVmaW5lZCxcbik6IHN0cmluZyB7XG4gIHJldHVybiBwbGF0Zm9ybSA/IENMSUVOVF9QTEFURk9STV9MQUJFTFNbcGxhdGZvcm1dID8/ICcnIDogJyc7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBkZXRlY3RTZXNzaW9uQ2xpZW50UGxhdGZvcm1JZChcbiAgZW52OiBOb2RlSlMuUHJvY2Vzc0VudiA9IHByb2Nlc3MuZW52LFxuICBhcmd2OiByZWFkb25seSBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndixcbiAgZXhlY1BhdGg6IHN0cmluZyA9IHByb2Nlc3MuZXhlY1BhdGgsXG4gIHRpdGxlOiBzdHJpbmcgPSBwcm9jZXNzLnRpdGxlLFxuKTogU2Vzc2lvbkNsaWVudFBsYXRmb3JtSWQgfCBudWxsIHtcbiAgY29uc3QgdGVybVByb2dyYW0gPSBub3JtYWxpemVUZXh0KGVudi5URVJNX1BST0dSQU0pO1xuICBjb25zdCBhcmd2VGV4dCA9IG5vcm1hbGl6ZVRleHQoYXJndi5qb2luKCcgJykpO1xuICBjb25zdCBleGVjUGF0aFRleHQgPSBub3JtYWxpemVUZXh0KGV4ZWNQYXRoKTtcbiAgY29uc3QgdGl0bGVUZXh0ID0gbm9ybWFsaXplVGV4dCh0aXRsZSk7XG4gIGNvbnN0IHRleHRTb3VyY2VzID0gW2FyZ3ZUZXh0LCBleGVjUGF0aFRleHQsIHRpdGxlVGV4dF07XG5cbiAgaWYgKGVudi5DTEFVREVfREVTS1RPUCA9PT0gJ3RydWUnIHx8IGVudi5DTEFVREVfREVTS1RPUF9WRVJTSU9OKSB7XG4gICAgcmV0dXJuICdjbGF1ZGUtZGVza3RvcCc7XG4gIH1cblxuICBpZiAoZW52LkNMQVVERV9DT0RFID09PSAndHJ1ZScgfHwgdGVybVByb2dyYW0gPT09ICdjbGF1ZGUtY29kZScpIHtcbiAgICByZXR1cm4gJ2NsYXVkZS1jb2RlJztcbiAgfVxuXG4gIGlmIChcbiAgICBlbnYuVlNDT0RFX0NXRCB8fFxuICAgIGVudi5WU0NPREVfUElEIHx8XG4gICAgZW52LlZTQ09ERV9JUENfSE9PSyB8fFxuICAgIGVudi5WU0NPREVfTkxTX0NPTkZJRyB8fFxuICAgIHRlcm1Qcm9ncmFtID09PSAndnNjb2RlJ1xuICApIHtcbiAgICByZXR1cm4gJ3ZzY29kZSc7XG4gIH1cblxuICBpZiAoZW52LkNPREVYX0hPTUUgfHwgdGVybVByb2dyYW0gPT09ICdjb2RleCcpIHtcbiAgICByZXR1cm4gJ2NvZGV4JztcbiAgfVxuXG4gIGZvciAoY29uc3QgbWF0Y2hlciBvZiBURVhUX1BMQVRGT1JNX01BVENIRVJTKSB7XG4gICAgaWYgKG1hdGNoZXNBbnlTb3VyY2UodGV4dFNvdXJjZXMsIG1hdGNoZXIubmVlZGxlcykpIHtcbiAgICAgIHJldHVybiBtYXRjaGVyLnBsYXRmb3JtO1xuICAgIH1cbiAgfVxuXG4gIHJldHVybiBudWxsO1xufVxuIl19

package/dist/web/public/sessions.css

@@ -66,7 +66,8 @@
   position: absolute;
   top: calc(100% + 0.4rem);
   right: 0;
-  min-width: 480px;
+  width: min(34rem, calc(100vw - 1rem));
+  box-sizing: border-box;
   background: var(--paper-strong, #fff);
   border: 1px solid var(--line, #c8d5e9);
   border-radius: var(--radius-md, 0.85rem);
@@ -184,10 +185,11 @@
 
 .session-dropdown-item {
   display: grid;
-  grid-template-columns: 1rem 8px 1fr 62px 72px 3.5rem 1.2rem;
+  grid-template-columns: 1rem 8px minmax(0, 1fr) 5.5rem 6.75rem 4.5rem 1.2rem;
   align-items: center;
-  gap: 0.4rem;
-  padding: 0.45rem 0.75rem;
+  column-gap: 0.7rem;
+  row-gap: 0.3rem;
+  padding: 0.55rem 0.9rem;
   font-size: var(--step--1, 0.82rem);
   cursor: pointer;
   transition: background 0.1s;
@@ -235,12 +237,51 @@
   white-space: nowrap;
 }
 
+.session-dropdown-primary {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.18rem;
+  align-self: center;
+}
+
+.session-dropdown-meta {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  min-width: 0;
+  flex-wrap: wrap;
+}
+
+.session-dropdown-version {
+  font-size: 0.7rem;
+  font-family: var(--font-mono, monospace);
+  color: var(--ink-500, #677893);
+  white-space: nowrap;
+}
+
+.session-dropdown-update {
+  display: inline-flex;
+  align-items: center;
+  padding: 1px 5px;
+  border-radius: 999px;
+  font-size: 0.62rem;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  background: #ecfdf5;
+  color: #166534;
+  border: 1px solid #86efac;
+  white-space: nowrap;
+}
+
 .session-dropdown-uptime {
   font-size: 0.7rem;
   font-family: var(--font-mono, monospace);
   color: var(--ink-500, #677893);
   white-space: nowrap;
   text-align: right;
+  min-width: 4.5rem;
+  justify-self: end;
 }
 
 .session-dropdown-role {
@@ -287,6 +328,16 @@
   color: var(--ink-900, #e0e8f0);
 }
 
+[data-theme="dark"] .session-dropdown-version {
+  color: var(--ink-500, #8899bb);
+}
+
+[data-theme="dark"] .session-dropdown-update {
+  background: #052e16;
+  color: #bbf7d0;
+  border-color: #166534;
+}
+
 [data-theme="dark"] .session-dropdown-toggle-label {
   color: var(--ink-500, #8899bb);
 }
@@ -363,15 +414,40 @@
  * - Color (blue=positive, orange=negative — colorblind-safe pair)
  */
 .session-status-badge {
-  display: inline-block;
-  padding: 1px 5px;
-  border-radius: 3px;
-  font-size: 9px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 2px 7px;
+  border-radius: 5px;
+  font-size: 10px;
   font-weight: 600;
   letter-spacing: 0.04em;
   white-space: nowrap;
   text-align: center;
-  min-width: 52px;
+  min-width: 4.75rem;
+  box-sizing: border-box;
+}
+
+.session-dropdown-item > .session-status-badge {
+  justify-self: center;
+}
+
+.session-dropdown-badge-stack {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-self: center;
+  gap: 0.24rem;
+  width: 100%;
+  max-width: 6.75rem;
+}
+
+.session-dropdown-client-label {
+  font-size: 0.62rem;
+  line-height: 1.15;
+  color: var(--ink-500, #677893);
+  text-align: center;
+  width: 100%;
 }
 
 .session-status-badge[data-status="positive"] {
@@ -398,6 +474,10 @@
   border-color: #9a3412;
 }
 
+[data-theme="dark"] .session-dropdown-client-label {
+  color: var(--ink-500, #8899bb);
+}
+
 /* Session filter in the log viewer */
 #log-session-filter {
   min-width: 120px;

package/dist/web/public/sessions.js

@@ -33,6 +33,18 @@
   var lastReloadTargetVersion = '';
   var pendingLeaderReloadTimer = null;
   var showPolicySessions = loadPolicyDebugVisibility();
+  var CLIENT_PLATFORM_LABELS = {
+    'claude-code': 'Claude Code',
+    'claude-desktop': 'Claude Desktop',
+    'codex': 'Codex',
+    'cursor': 'Cursor',
+    'vscode': 'VS Code',
+    'windsurf': 'Windsurf',
+    'gemini-cli': 'Gemini CLI',
+    'cline': 'Cline',
+    'lmstudio': 'LM Studio',
+    'web-console': 'Web Console'
+  };
 
   function loadPolicyDebugVisibility() {
     try {
@@ -176,6 +188,55 @@
   /** NFC-normalize a string safely */
   function nfc(s) { try { return s.normalize('NFC'); } catch(e) { return s; } }
 
+  function normalizeClientPlatform(platform) {
+    if (typeof platform !== 'string') return '';
+    var normalized = nfc(platform).trim().toLowerCase();
+    if (!normalized) return '';
+    if (normalized === 'gemini') return 'gemini-cli';
+    return Object.prototype.hasOwnProperty.call(CLIENT_PLATFORM_LABELS, normalized) ? normalized : '';
+  }
+
+  function displayPlatform(session) {
+    if (!session || typeof session !== 'object') return '';
+    if (typeof session.clientPlatformLabel === 'string' && session.clientPlatformLabel.trim()) {
+      return nfc(session.clientPlatformLabel.trim());
+    }
+    var platform = normalizeClientPlatform(session.clientPlatform);
+    return platform ? CLIENT_PLATFORM_LABELS[platform] || '' : '';
+  }
+
+  function displayVersion(session) {
+    if (!session || typeof session !== 'object') return '';
+    var normalized = normalizeSemver(session.serverVersion);
+    if (!normalized && typeof session.serverVersion === 'string') {
+      normalized = nfc(session.serverVersion).trim();
+    }
+    if (!normalized) return '';
+    return normalized.charAt(0) === 'v' ? normalized : ('v' + normalized);
+  }
+
+  function getNewestKnownSessionVersion(list) {
+    if (!Array.isArray(list)) return '';
+    var newest = '';
+    for (var i = 0; i < list.length; i++) {
+      var session = list[i];
+      if (!session || isPolicyOnlySession(session) || session.status !== 'active') continue;
+      var version = normalizeSemver(session.serverVersion);
+      if (!version) continue;
+      if (!newest || compareSemver(version, newest) > 0) {
+        newest = version;
+      }
+    }
+    return newest;
+  }
+
+  function sessionHasUpdateAvailable(session, newestVersion) {
+    if (!session || !newestVersion || isPolicyOnlySession(session)) return false;
+    var version = normalizeSemver(session.serverVersion);
+    if (!version) return false;
+    return compareSemver(version, newestVersion) < 0;
+  }
+
   function isPolicyOnlySession(session) {
     return !!(session && session.isPolicyOnly);
   }
@@ -231,6 +292,9 @@
         isLeader: false,
         authenticated: false,
         kind: 'policy',
+        serverVersion: '',
+        clientPlatform: '',
+        clientPlatformLabel: '',
         isPolicyOnly: true,
       });
     }
@@ -254,12 +318,63 @@
   // Build a key from current sessions to detect changes
   function sessionListKey(list) {
     return list.map(function(s) {
-      return s.sessionId + ':' + s.status + ':' + (isPolicyOnlySession(s) ? 'policy' : 'live');
+      return [
+        s.sessionId,
+        s.status,
+        s.displayName || '',
+        s.serverVersion || '',
+        s.clientPlatform || '',
+        s.clientPlatformLabel || '',
+        s.isLeader ? 'leader' : 'member',
+        s.authenticated ? 'auth' : 'noauth',
+        isPolicyOnlySession(s) ? 'policy' : 'live'
+      ].join(':');
     }).join(',')
       + '|policyDebug:' + (showPolicySessions ? 'on' : 'off')
       + '|knownPolicy:' + policySessions.map(function(session) { return session.sessionId; }).join(',');
   }
 
+  function normalizeLiveSessions(list) {
+    if (!Array.isArray(list)) return [];
+    var normalized = [];
+    var seen = new Set();
+
+    for (var i = 0; i < list.length; i++) {
+      var item = list[i];
+      if (!item || typeof item.sessionId !== 'string') continue;
+      var sessionId = nfc(item.sessionId).trim();
+      if (!sessionId || seen.has(sessionId)) continue;
+      seen.add(sessionId);
+
+      var clientPlatform = normalizeClientPlatform(item.clientPlatform);
+      var clientPlatformLabel = '';
+      if (typeof item.clientPlatformLabel === 'string' && item.clientPlatformLabel.trim()) {
+        clientPlatformLabel = nfc(item.clientPlatformLabel).trim();
+      } else if (clientPlatform) {
+        clientPlatformLabel = CLIENT_PLATFORM_LABELS[clientPlatform] || '';
+      }
+
+      normalized.push({
+        sessionId: sessionId,
+        displayName: nfc(typeof item.displayName === 'string' && item.displayName ? item.displayName : sessionId),
+        color: typeof item.color === 'string' ? item.color : '',
+        pid: typeof item.pid === 'number' ? item.pid : 0,
+        startedAt: typeof item.startedAt === 'string' ? item.startedAt : '',
+        lastHeartbeat: typeof item.lastHeartbeat === 'string' ? item.lastHeartbeat : '',
+        status: item.status === 'ended' ? 'ended' : 'active',
+        isLeader: !!item.isLeader,
+        authenticated: !!item.authenticated,
+        kind: typeof item.kind === 'string' ? item.kind : 'mcp',
+        serverVersion: normalizeSemver(item.serverVersion) || (typeof item.serverVersion === 'string' ? nfc(item.serverVersion).trim() : ''),
+        consoleProtocolVersion: typeof item.consoleProtocolVersion === 'number' ? item.consoleProtocolVersion : 0,
+        clientPlatform: clientPlatform,
+        clientPlatformLabel: clientPlatformLabel,
+      });
+    }
+
+    return normalized;
+  }
+
   function setPolicyDebugVisibility(nextVisible, keepDropdownOpen) {
     var normalized = !!nextVisible;
     if (showPolicySessions === normalized) return;
@@ -513,6 +628,7 @@
       if (!a.isLeader && b.isLeader) return 1;
       return 0;
     });
+    var newestKnownVersion = getNewestKnownSessionVersion(sorted);
 
     function appendSessionItem(s) {
       var item = document.createElement('div');
@@ -529,11 +645,37 @@
       if (s.color) dot.style.background = s.color;
       item.appendChild(dot);
 
+      var nameWrap = document.createElement('div');
+      nameWrap.className = 'session-dropdown-primary';
+
       var nameEl = document.createElement('span');
       nameEl.className = 'session-dropdown-name';
       nameEl.textContent = displayName(s);
       if (s.color) nameEl.style.color = s.color;
-      item.appendChild(nameEl);
+      nameWrap.appendChild(nameEl);
+
+      var versionText = displayVersion(s);
+      if (versionText) {
+        var metaRow = document.createElement('div');
+        metaRow.className = 'session-dropdown-meta';
+
+        var versionEl = document.createElement('span');
+        versionEl.className = 'session-dropdown-version';
+        versionEl.textContent = versionText;
+        metaRow.appendChild(versionEl);
+
+        if (sessionHasUpdateAvailable(s, newestKnownVersion)) {
+          var updateBadge = document.createElement('span');
+          updateBadge.className = 'session-dropdown-update';
+          updateBadge.textContent = 'Update available';
+          updateBadge.title = 'A newer local DollhouseMCP session version is active.';
+          metaRow.appendChild(updateBadge);
+        }
+
+        nameWrap.appendChild(metaRow);
+      }
+
+      item.appendChild(nameWrap);
 
       // Session status badges (#1805) — for persisted policy sessions we
       // switch from "live/authenticated" semantics to "saved/no client".
@@ -554,6 +696,9 @@
       }
       item.appendChild(authBadge);
 
+      var clientWrap = document.createElement('div');
+      clientWrap.className = 'session-dropdown-badge-stack';
+
       var clientBadge = document.createElement('span');
       clientBadge.className = 'session-status-badge';
       if (isPolicyOnlySession(s)) {
@@ -569,7 +714,17 @@
         clientBadge.dataset.status = 'negative';
         clientBadge.title = 'No MCP client attached';
       }
-      item.appendChild(clientBadge);
+      clientWrap.appendChild(clientBadge);
+
+      var platformLabel = displayPlatform(s);
+      if (platformLabel) {
+        var clientLabel = document.createElement('span');
+        clientLabel.className = 'session-dropdown-client-label';
+        clientLabel.textContent = platformLabel;
+        clientWrap.appendChild(clientLabel);
+      }
+
+      item.appendChild(clientWrap);
 
       var uptimeEl = document.createElement('span');
       uptimeEl.className = 'session-dropdown-uptime';
@@ -727,7 +882,7 @@
       return res.json();
     }).then(function(data) {
       if (data && data.sessions) {
-        sessions = data.sessions;
+        sessions = normalizeLiveSessions(data.sessions);
         maybeForceReloadForNewLeader(sessions);
         updateSessionIndicator();
         updateSessionFilterOptions();
@@ -743,6 +898,7 @@
   window.DollhouseSessions = {
     getFilterSessionId: function() { return filterSessionId; },
     displayName: displayName,
+    displayPlatform: displayPlatform,
     getSessions: function() { return sessions; },
     getLiveSessions: getLiveSessions,
     getSelectableSessions: getSelectableSessions,

package/dist/web/public/setup.js

@@ -13,6 +13,9 @@
   const PKG = '@dollhousemcp/mcp-server';
   const HOOKS_DIR = '~/.dollhouse/hooks';
   const HOOK_BASE_SCRIPT_PATH = `${HOOKS_DIR}/pretooluse-dollhouse.sh`;
+  const HOOK_CONTRACT_DOC_URL = 'https://github.com/DollhouseMCP/mcp-server/blob/main/docs/architecture/permission-hook-platform-contracts.md';
+  // Keep hook entrypoints and output expectations in sync with
+  // docs/architecture/permission-hook-platform-contracts.md.
 
   /** Platform registry — drives config generation AND panel rendering */
   const PLATFORMS = [
@@ -1591,6 +1594,7 @@ codex_hooks = true`;
     intro.innerHTML = `<div class="setup-permissions-note">
         <strong>Permissions &amp; Security</strong>
         <p>Use this mode to turn on permission enforcement for supported clients. Claude Code is fully guided in this release. Gemini CLI, Cursor, VS Code, Windsurf, and Codex have native partial support, while Cline and LM Studio stay in the MCP and fallback lane for now. Other clients will be marked as coming soon.</p>
+        <p class="setup-hint">Need the advanced client-by-client hook contract details? <a href="${HOOK_CONTRACT_DOC_URL}" target="_blank" rel="noopener noreferrer">Read the platform contract reference</a>.</p>
       </div>`;
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dollhousemcp/mcp-server",
-  "version": "2.0.27",
+  "version": "2.0.28",
   "description": "DollhouseMCP - A Model Context Protocol (MCP) server that enables dynamic AI persona management from markdown files, allowing Claude and other compatible AI assistants to activate and switch between different behavioral personas.",
   "type": "module",
   "main": "dist/index.js",

package/scripts/pretooluse-dollhouse.sh

@@ -20,11 +20,14 @@ RUN_DIR="$HOME/.dollhouse/run"
 PORT_FILE="$RUN_DIR/permission-server.port"
 AUTHORITY_FILE="$RUN_DIR/permission-authority.json"
 AUTHORITY_CACHE_TTL_SECONDS=2
-MAX_RETRIES=2
-INITIAL_TIMEOUT=5
+MAX_RETRIES="${DOLLHOUSE_HOOK_MAX_RETRIES:-2}"
+INITIAL_TIMEOUT="${DOLLHOUSE_HOOK_INITIAL_TIMEOUT:-5}"
 HOOK_PLATFORM="${DOLLHOUSE_HOOK_PLATFORM:-claude_code}"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
+[[ "$MAX_RETRIES" =~ ^[0-9]+$ ]] || MAX_RETRIES=2
+[[ "$INITIAL_TIMEOUT" =~ ^[0-9]+$ ]] || INITIAL_TIMEOUT=5
+
 # Debug logging helper — writes to stderr so it doesn't pollute stdout
 debug() {
   if [[ "${DOLLHOUSE_HOOK_DEBUG:-0}" == "1" ]]; then
@@ -114,6 +117,37 @@ normalize_response() {
         end
       ' 2>/dev/null
       ;;
+    codex)
+      echo "$response" | jq -c '
+        if type == "object" and (keys | length) == 0 then
+          {
+            hookSpecificOutput: {
+              hookEventName: "PreToolUse",
+              permissionDecision: "allow",
+              permissionDecisionReason: ""
+            }
+          }
+        elif (.hookSpecificOutput.permissionDecision? | type) == "string" then
+          {
+            hookSpecificOutput: {
+              hookEventName: "PreToolUse",
+              permissionDecision: (if .hookSpecificOutput.permissionDecision == "allow" then "allow" else "deny" end),
+              permissionDecisionReason: (.hookSpecificOutput.permissionDecisionReason // .hookSpecificOutput.reason // .reason // .message // "")
+            }
+          }
+        elif (.decision? | type) == "string" and (.decision | IN("allow", "deny", "ask")) then
+          {
+            hookSpecificOutput: {
+              hookEventName: "PreToolUse",
+              permissionDecision: (if .decision == "allow" then "allow" else "deny" end),
+              permissionDecisionReason: (.reason // .message // "")
+            }
+          }
+        else
+          empty
+        end
+      ' 2>/dev/null
+      ;;
     *)
       echo "$response"
       ;;

package/scripts/pretooluse-vscode.sh

@@ -7,11 +7,14 @@
 
 RUN_DIR="$HOME/.dollhouse/run"
 PORT_FILE="$RUN_DIR/permission-server.port"
-MAX_RETRIES=2
-INITIAL_TIMEOUT=5
+MAX_RETRIES="${DOLLHOUSE_HOOK_MAX_RETRIES:-2}"
+INITIAL_TIMEOUT="${DOLLHOUSE_HOOK_INITIAL_TIMEOUT:-5}"
 HOOK_PLATFORM="vscode"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
+[[ "$MAX_RETRIES" =~ ^[0-9]+$ ]] || MAX_RETRIES=2
+[[ "$INITIAL_TIMEOUT" =~ ^[0-9]+$ ]] || INITIAL_TIMEOUT=5
+
 debug() {
   if [[ "${DOLLHOUSE_HOOK_DEBUG:-0}" == "1" ]]; then
     echo "[pretooluse-vscode] $*" >&2

package/scripts/pretooluse-windsurf.sh

@@ -7,11 +7,14 @@
 
 RUN_DIR="$HOME/.dollhouse/run"
 PORT_FILE="$RUN_DIR/permission-server.port"
-MAX_RETRIES=2
-INITIAL_TIMEOUT=5
+MAX_RETRIES="${DOLLHOUSE_HOOK_MAX_RETRIES:-2}"
+INITIAL_TIMEOUT="${DOLLHOUSE_HOOK_INITIAL_TIMEOUT:-5}"
 HOOK_PLATFORM="windsurf"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
+[[ "$MAX_RETRIES" =~ ^[0-9]+$ ]] || MAX_RETRIES=2
+[[ "$INITIAL_TIMEOUT" =~ ^[0-9]+$ ]] || INITIAL_TIMEOUT=5
+
 debug() {
   if [[ "${DOLLHOUSE_HOOK_DEBUG:-0}" == "1" ]]; then
     echo "[pretooluse-windsurf] $*" >&2

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.DollhouseMCP/mcp-server",
   "title": "DollhouseMCP",
   "description": "OSS to create Personas, Skills, Templates, Agents, and Memories to customize your AI experience.",
-  "version": "2.0.27",
+  "version": "2.0.28",
   "homepage": "https://dollhousemcp.com",
   "repository": {
     "type": "git",
@@ -29,7 +29,7 @@
     {
       "registryType": "npm",
       "identifier": "@dollhousemcp/mcp-server",
-      "version": "2.0.27",
+      "version": "2.0.28",
       "transport": {
         "type": "stdio"
       }