memhouse 0.4.4 → 0.7.0

package/mcp-server.js

@@ -1,294 +0,0 @@
-const { McpServer } = require('@modelcontextprotocol/sdk/server/mcp.js');
-const { SSEServerTransport } = require('@modelcontextprotocol/sdk/server/sse.js');
-const { StreamableHTTPServerTransport } = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-const { z } = require('zod');
-const crypto = require('crypto');
-
-/**
- * Creates an MCP server instance wired to the relay database.
- * Returns { mcpServer, transports } — caller wires SSE endpoints into Express.
- */
-function createMcpServer(getDb) {
-  const mcpServer = new McpServer({
-    name: 'agentlytics-relay',
-    version: '1.0.0',
-  });
-
-  // ── Tool: list_users ──
-  mcpServer.tool(
-    'list_users',
-    'List all connected users and their shared projects',
-    {},
-    async () => {
-      const db = getDb();
-      if (!db) return { content: [{ type: 'text', text: 'Relay database not initialized' }] };
-      const users = db.prepare('SELECT username, last_seen, projects FROM users ORDER BY last_seen DESC').all();
-      const result = users.map(u => ({
-        username: u.username,
-        lastSeen: new Date(u.last_seen).toISOString(),
-        projects: JSON.parse(u.projects || '[]'),
-      }));
-      return {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-      };
-    }
-  );
-
-  // ── Tool: search_sessions ──
-  mcpServer.tool(
-    'search_sessions',
-    'Search across all users\' chat messages by keyword. Use this to find what someone worked on, or find discussions about a specific file or topic.',
-    {
-      query: z.string().describe('Search query — keyword, file name, or topic'),
-      username: z.string().optional().describe('Filter by specific username'),
-      project: z.string().optional().describe('Filter by project folder path (partial match)'),
-      limit: z.number().optional().describe('Max results (default 20)'),
-    },
-    async ({ query, username, project, limit }) => {
-      const db = getDb();
-      if (!db) return { content: [{ type: 'text', text: 'Relay database not initialized' }] };
-
-      let sql = `
-        SELECT rm.chat_id, rm.username, rm.role, rm.content, rm.model, rm.seq,
-               rc.name as chat_name, rc.source, rc.folder, rc.last_updated_at
-        FROM relay_messages rm
-        JOIN relay_chats rc ON rm.chat_id = rc.id AND rm.username = rc.username
-        WHERE rm.content LIKE ?`;
-      const params = [`%${query}%`];
-
-      if (username) { sql += ' AND rm.username = ?'; params.push(username); }
-      if (project) { sql += ' AND rc.folder LIKE ?'; params.push(`%${project}%`); }
-      sql += ' ORDER BY rc.last_updated_at DESC LIMIT ?';
-      params.push(limit || 20);
-
-      const rows = db.prepare(sql).all(...params);
-
-      if (rows.length === 0) {
-        return { content: [{ type: 'text', text: `No results found for "${query}"` }] };
-      }
-
-      const results = rows.map(r => ({
-        chatId: r.chat_id,
-        chatName: r.chat_name,
-        username: r.username,
-        role: r.role,
-        source: r.source,
-        folder: r.folder,
-        lastUpdated: r.last_updated_at ? new Date(r.last_updated_at).toISOString() : null,
-        model: r.model,
-        content: r.content.length > 300 ? r.content.substring(0, 300) + '...' : r.content,
-      }));
-
-      return {
-        content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
-      };
-    }
-  );
-
-  // ── Tool: get_user_activity ──
-  mcpServer.tool(
-    'get_user_activity',
-    'Get recent activity for a specific user — their recent sessions, what they worked on, which editors and models they used.',
-    {
-      username: z.string().describe('Username to look up'),
-      project: z.string().optional().describe('Filter by project folder (partial match)'),
-      file_path: z.string().optional().describe('Filter by file path mentioned in messages'),
-      limit: z.number().optional().describe('Max sessions to return (default 20)'),
-    },
-    async ({ username, project, file_path, limit }) => {
-      const db = getDb();
-      if (!db) return { content: [{ type: 'text', text: 'Relay database not initialized' }] };
-
-      // First get sessions
-      let sql = `
-        SELECT rc.*, rcs.total_messages, rcs.models, rcs.tool_calls,
-               rcs.total_input_tokens, rcs.total_output_tokens
-        FROM relay_chats rc
-        LEFT JOIN relay_chat_stats rcs ON rc.id = rcs.chat_id AND rc.username = rcs.username
-        WHERE rc.username = ?`;
-      const params = [username];
-
-      if (project) { sql += ' AND rc.folder LIKE ?'; params.push(`%${project}%`); }
-      sql += ' ORDER BY rc.last_updated_at DESC LIMIT ?';
-      params.push(limit || 20);
-
-      let sessions = db.prepare(sql).all(...params);
-
-      // If file_path filter, narrow down to sessions mentioning that file
-      if (file_path && sessions.length > 0) {
-        const chatIds = sessions.map(s => s.id);
-        const placeholders = chatIds.map(() => '?').join(',');
-        const fileMatches = db.prepare(`
-          SELECT DISTINCT chat_id FROM relay_messages
-          WHERE chat_id IN (${placeholders}) AND username = ? AND content LIKE ?
-        `).all(...chatIds, username, `%${file_path}%`);
-        const matchingIds = new Set(fileMatches.map(m => m.chat_id));
-        sessions = sessions.filter(s => matchingIds.has(s.id));
-      }
-
-      if (sessions.length === 0) {
-        return { content: [{ type: 'text', text: `No activity found for user "${username}"` }] };
-      }
-
-      const result = sessions.map(s => ({
-        id: s.id,
-        name: s.name,
-        source: s.source,
-        mode: s.mode,
-        folder: s.folder,
-        lastUpdated: s.last_updated_at ? new Date(s.last_updated_at).toISOString() : null,
-        totalMessages: s.total_messages,
-        models: s.models ? [...new Set(JSON.parse(s.models))].slice(0, 5) : [],
-        toolCalls: s.tool_calls ? JSON.parse(s.tool_calls).length : 0,
-        totalInputTokens: s.total_input_tokens,
-        totalOutputTokens: s.total_output_tokens,
-      }));
-
-      return {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-      };
-    }
-  );
-
-  // ── Tool: get_session_detail ──
-  mcpServer.tool(
-    'get_session_detail',
-    'Get the full conversation messages for a specific session. Use the session ID from search_sessions or get_user_activity results.',
-    {
-      session_id: z.string().describe('The chat/session ID'),
-      username: z.string().optional().describe('Username who owns the session (optional, auto-detected if unique)'),
-    },
-    async ({ session_id, username }) => {
-      const db = getDb();
-      if (!db) return { content: [{ type: 'text', text: 'Relay database not initialized' }] };
-
-      let chatSql = 'SELECT * FROM relay_chats WHERE id = ?';
-      const chatParams = [session_id];
-      if (username) { chatSql += ' AND username = ?'; chatParams.push(username); }
-      chatSql += ' LIMIT 1';
-
-      const chat = db.prepare(chatSql).get(...chatParams);
-      if (!chat) {
-        return { content: [{ type: 'text', text: `Session "${session_id}" not found` }] };
-      }
-
-      const messages = db.prepare(
-        'SELECT seq, role, content, model FROM relay_messages WHERE chat_id = ? AND username = ? ORDER BY seq'
-      ).all(chat.id, chat.username);
-
-      const formatted = messages.map(m => {
-        const label = m.role === 'user' ? 'User' : m.role === 'assistant' ? 'Assistant' : m.role;
-        const modelTag = m.model ? ` (${m.model})` : '';
-        const content = m.content.length > 2000 ? m.content.substring(0, 2000) + '\n... [truncated]' : m.content;
-        return `## ${label}${modelTag}\n\n${content}`;
-      }).join('\n\n---\n\n');
-
-      const header = `# ${chat.name || 'Untitled Session'}\n**User:** ${chat.username} | **Editor:** ${chat.source} | **Project:** ${chat.folder || 'N/A'}\n\n---\n\n`;
-
-      return {
-        content: [{ type: 'text', text: header + formatted }],
-      };
-    }
-  );
-
-  return mcpServer;
-}
-
-/**
- * Wire MCP SSE transport into an Express app.
- * GET /mcp → establishes SSE connection
- * POST /mcp → receives messages from MCP client
- */
-function wireMcpToExpress(app, getDb) {
-  const sseTransports = {};
-  const httpTransports = {};
-
-  // Same auth gate as the relay's /relay/* routes (same token derivation as
-  // createRelayApp): when RELAY_PASSWORD is set, /mcp must not expose
-  // search_sessions / get_session_detail to unauthenticated clients.
-  const RELAY_PASSWORD = process.env.RELAY_PASSWORD || null;
-  const AUTH_TOKEN = RELAY_PASSWORD
-    ? require('crypto').createHmac('sha256', 'agentlytics-relay').update(RELAY_PASSWORD).digest('hex')
-    : null;
-  function requireAuth(req, res, next) {
-    if (!AUTH_TOKEN) return next();
-    const header = req.headers.authorization || '';
-    const token = header.startsWith('Bearer ') ? header.slice(7) : null;
-    if (token === AUTH_TOKEN) return next();
-    res.status(401).json({ error: 'Unauthorized' });
-  }
-
-  // SSE: GET /mcp establishes SSE stream
-  app.get('/mcp', requireAuth, async (req, res) => {
-    const sessionId = req.headers['mcp-session-id'];
-
-    // Streamable HTTP GET for SSE stream resumption
-    if (sessionId && httpTransports[sessionId]) {
-      const transport = httpTransports[sessionId];
-      await transport.handleRequest(req, res);
-      return;
-    }
-
-    // Legacy SSE transport
-    const transport = new SSEServerTransport('/mcp', res);
-    sseTransports[transport.sessionId] = transport;
-
-    const mcpServer = createMcpServer(getDb);
-
-    res.on('close', () => {
-      delete sseTransports[transport.sessionId];
-      mcpServer.close().catch(() => {});
-    });
-
-    await mcpServer.connect(transport);
-  });
-
-  // POST /mcp handles both SSE messages and Streamable HTTP
-  app.post('/mcp', requireAuth, async (req, res) => {
-    // Check for SSE session first
-    const sseSessionId = req.query.sessionId;
-    if (sseSessionId && sseTransports[sseSessionId]) {
-      await sseTransports[sseSessionId].handlePostMessage(req, res);
-      return;
-    }
-
-    // Streamable HTTP: check for existing session
-    const sessionId = req.headers['mcp-session-id'];
-    if (sessionId && httpTransports[sessionId]) {
-      await httpTransports[sessionId].handleRequest(req, res, req.body);
-      return;
-    }
-
-    // New Streamable HTTP session (initialization request)
-    const transport = new StreamableHTTPServerTransport({
-      sessionIdGenerator: () => crypto.randomUUID(),
-      onsessioninitialized: (id) => {
-        httpTransports[id] = transport;
-      },
-    });
-
-    transport.onclose = () => {
-      if (transport.sessionId) {
-        delete httpTransports[transport.sessionId];
-      }
-    };
-
-    const mcpServer = createMcpServer(getDb);
-    await mcpServer.connect(transport);
-    await transport.handleRequest(req, res, req.body);
-  });
-
-  // DELETE /mcp for session cleanup
-  app.delete('/mcp', requireAuth, async (req, res) => {
-    const sessionId = req.headers['mcp-session-id'];
-    if (sessionId && httpTransports[sessionId]) {
-      await httpTransports[sessionId].handleRequest(req, res);
-      return;
-    }
-    res.status(404).end();
-  });
-
-  return { sseTransports, httpTransports };
-}
-
-module.exports = { createMcpServer, wireMcpToExpress };

package/mem-house/delivery/install.sh

@@ -1,183 +0,0 @@
-#!/usr/bin/env bash
-# mem-house standalone installer.
-#
-# Checks node >= 20 and a reachable ClickHouse, writes ~/.memhouse/env
-# (MEMHOUSE_* vars), applies the house schema via the shipper
-# (`ship.js --ensure-schema` mints the caller's own rooms), runs a first ship, and prints how to start the
-# dashboard and set up continuous shipping (`--loop`).
-#
-# Usage:
-#   ./install.sh                                  # interactive (prompts for missing values)
-#   ./install.sh --url http://localhost:8123 --user memhouse_root --password 'pw' --db mem
-#   ./install.sh --yes                            # non-interactive, defaults / env / existing env file
-#
-# Flags:
-#   --url URL         ClickHouse HTTP(S) endpoint   (default http://localhost:8123)
-#   --user USER       ClickHouse user               (default memhouse_root; 'default' works for a local CH)
-#   --password PW     credential                    (default empty)
-#   --db DB           the house (database)          (default mem)
-#   --port PORT       dashboard/API port            (default 4640)
-#   --yes             never prompt; take flags > current env > ~/.memhouse/env > defaults
-#   --no-ship         stop after writing env + ensure-schema (skip the first ship)
-#
-# Defaults resolve in order: flag > MEMHOUSE_* already in the environment >
-# existing ~/.memhouse/env > built-in default. Runs from any cwd — the repo is
-# resolved from this script's own location (mem-house/delivery/ -> repo root).
-set -euo pipefail
-
-HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$HERE/../.." && pwd)"
-SHIP="$REPO_ROOT/mem-house/shipper/ship.js"
-SERVER="$REPO_ROOT/mem-house/server/server.js"
-ENV_DIR="$HOME/.memhouse"
-ENV_FILE="$ENV_DIR/env"
-
-die() { echo "install.sh: $*" >&2; exit 1; }
-info() { echo "== $*"; }
-
-# ---------- 0. defaults: existing env file, then environment ----------------
-if [ -f "$ENV_FILE" ]; then
-  # shellcheck disable=SC1090
-  set -a; . "$ENV_FILE"; set +a
-fi
-CH_URL="${MEMHOUSE_URL:-http://localhost:8123}"
-CH_USER="${MEMHOUSE_USER:-memhouse_root}"
-CH_PASSWORD="${MEMHOUSE_PASSWORD:-}"
-CH_DB="${MEMHOUSE_DB:-mem}"
-DASH_PORT="${MEMHOUSE_PORT:-4640}"
-
-ASSUME_YES=0
-NO_SHIP=0
-URL_SET=0; USER_SET=0; PASS_SET=0; DB_SET=0
-
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --url)      CH_URL="${2:?--url needs a value}"; URL_SET=1; shift 2;;
-    --user)     CH_USER="${2:?--user needs a value}"; USER_SET=1; shift 2;;
-    --password) CH_PASSWORD="${2:?--password needs a value}"; PASS_SET=1; shift 2;;
-    --db)       CH_DB="${2:?--db needs a value}"; DB_SET=1; shift 2;;
-    --port)     DASH_PORT="${2:?--port needs a value}"; shift 2;;
-    --yes|-y)   ASSUME_YES=1; shift;;
-    --no-ship)  NO_SHIP=1; shift;;
-    -h|--help)  sed -n '2,25p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; exit 0;;
-    *) die "unknown flag: $1 (try --help)";;
-  esac
-done
-
-# ---------- 1. node >= 20 ---------------------------------------------------
-command -v node >/dev/null 2>&1 || die "node not found (need node >= 20; https://nodejs.org)"
-NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]')"
-[ "$NODE_MAJOR" -ge 20 ] 2>/dev/null || die "node >= 20 required (found $(node -v))"
-info "node $(node -v) ok"
-
-[ -f "$SHIP" ] || die "shipper not found at $SHIP (incomplete checkout?)"
-
-# ---------- 2. repo dependencies -------------------------------------------
-if [ ! -d "$REPO_ROOT/node_modules" ]; then
-  info "installing npm dependencies (first run)"
-  (cd "$REPO_ROOT" && npm install --no-audit --no-fund)
-fi
-
-# ---------- 3. gather connection values -------------------------------------
-prompt() { # prompt <question> <current> -> stdout
-  local ans
-  read -r -p "$1 [$2]: " ans
-  echo "${ans:-$2}"
-}
-if [ "$ASSUME_YES" -eq 0 ] && [ -t 0 ]; then
-  [ "$URL_SET"  -eq 1 ] || CH_URL="$(prompt "ClickHouse URL" "$CH_URL")"
-  [ "$USER_SET" -eq 1 ] || CH_USER="$(prompt "ClickHouse user" "$CH_USER")"
-  if [ "$PASS_SET" -eq 0 ]; then
-    read -r -s -p "ClickHouse password [keep current/empty]: " ans; echo
-    [ -n "$ans" ] && CH_PASSWORD="$ans"
-  fi
-  [ "$DB_SET" -eq 1 ] || CH_DB="$(prompt "House (database)" "$CH_DB")"
-fi
-
-# ---------- 4. ClickHouse reachable? ----------------------------------------
-info "checking ClickHouse at $CH_URL (user $CH_USER)"
-ONE="$(curl -sS --connect-timeout 5 --fail-with-body \
-        --user "$CH_USER:$CH_PASSWORD" \
-        --data-binary "SELECT 1" "$CH_URL")" \
-  || die "ClickHouse not reachable at $CH_URL with those credentials"
-[ "$ONE" = "1" ] || die "unexpected reply from $CH_URL: $ONE"
-info "ClickHouse ok"
-
-# Ensure the house exists before ensure-schema (the room DDL is unqualified and the
-# shipper binds to MEMHOUSE_DB — on a virgin standalone server the database must
-# be created first). On a kernel realm the house is already provisioned; if the
-# user lacks CREATE DATABASE but the house is reachable, that's fine too.
-case "$CH_DB" in
-  (*[!A-Za-z0-9_]*|'') die "invalid database name '$CH_DB' — use letters, digits, underscore" ;;
-esac
-if ! curl -fsS --max-time 20 --user "$CH_USER:$CH_PASSWORD" \
-      --data-binary "CREATE DATABASE IF NOT EXISTS $CH_DB" "$CH_URL" >/dev/null 2>&1; then
-  curl -fsS --max-time 20 --user "$CH_USER:$CH_PASSWORD" \
-      --data-binary "SELECT 1" "$CH_URL/?database=$CH_DB" >/dev/null 2>&1 \
-    || die "house '$CH_DB' does not exist and cannot be created as $CH_USER"
-fi
-info "house '$CH_DB' ready"
-
-# ---------- 5. write ~/.memhouse/env ----------------------------------------
-mkdir -p "$ENV_DIR"; chmod 700 "$ENV_DIR"
-# Values are single-quoted (embedded ' escaped) — this file is sourced by shells
-# (docs/skills use `. ~/.memhouse/env`), so unquoted metacharacters in a password
-# would corrupt the value or execute on source.
-shq() { printf "%s" "$1" | sed "s/'/'\\\\''/g"; }
-cat > "$ENV_FILE" <<EOF
-# mem-house connection (written by install.sh $(date +%Y-%m-%d-%H_%M)). NEVER commit.
-MEMHOUSE_URL='$(shq "$CH_URL")'
-MEMHOUSE_USER='$(shq "$CH_USER")'
-MEMHOUSE_PASSWORD='$(shq "$CH_PASSWORD")'
-MEMHOUSE_DB='$(shq "$CH_DB")'
-MEMHOUSE_PORT='$(shq "$DASH_PORT")'
-EOF
-chmod 600 "$ENV_FILE"
-info "wrote $ENV_FILE"
-
-export MEMHOUSE_URL="$CH_URL" MEMHOUSE_USER="$CH_USER" \
-       MEMHOUSE_PASSWORD="$CH_PASSWORD" MEMHOUSE_DB="$CH_DB" \
-       MEMHOUSE_PORT="$DASH_PORT"
-
-# ---------- 6. schema + first ship ------------------------------------------
-info "applying house schema (ship.js --ensure-schema)"
-node "$SHIP" --ensure-schema \
-  || die "ensure-schema failed. If $CH_USER cannot CREATE DATABASE, create '$CH_DB' first (or, on a kernel realm, provision the agency: see delivery/kernel-install.md), then re-run."
-
-if [ "$NO_SHIP" -eq 0 ]; then
-  info "first ship (this parses local editor sessions and may take a while)"
-  node "$SHIP"
-else
-  info "skipping first ship (--no-ship)"
-fi
-
-# ---------- 7. next steps ----------------------------------------------------
-cat <<EOF
-
-mem-house installed.
-
-  env file     $ENV_FILE
-  house        $CH_DB @ $CH_URL
-
-Next steps:
-
-  # dashboard (agentlytics UI over the house) -> http://localhost:$DASH_PORT
-  node "$SERVER"
-
-  # keep shipping continuously (re-ships incrementally; Ctrl-C to stop)
-  node "$SHIP" --loop
-  # background it:
-  nohup node "$SHIP" --loop >> "$ENV_DIR/ship.log" 2>&1 &
-
-  # agent skills (search/sessions/sql from inside Claude Code):
-  node "$REPO_ROOT/bin/memhouse.js" plugins install claude
-  # -> installs memhouse-search / memhouse-sessions / memhouse-sql into
-  #    \${CLAUDE_CONFIG_DIR:-\$HOME/.claude}/skills (loads next session)
-
-Verify anytime (rooms are named for your ClickHouse user):
-  set -a; . "$ENV_FILE"; set +a
-  ME=\$(curl -sS --user "\$MEMHOUSE_USER:\$MEMHOUSE_PASSWORD" \\
-    --data-binary "SELECT currentUser() FORMAT TabSeparated" "\$MEMHOUSE_URL/")
-  curl -sS --user "\$MEMHOUSE_USER:\$MEMHOUSE_PASSWORD" --data-binary \\
-    "SELECT count() FROM sessions_\$ME" "\$MEMHOUSE_URL/?database=\$MEMHOUSE_DB&final=1"
-EOF

package/mem-house/delivery/skills/memhouse-sessions/SKILL.md

@@ -1,125 +0,0 @@
----
-name: memhouse-sessions
-description: List recent agent sessions from memhouse conversation memory — names, projects, editors, hosts, times, message and token counts across all 17 supported editors. Use for "what was I working on", "show my recent sessions", "sessions from last week", "what did I do in project X", "list my cursor sessions", or to orient before drilling into one session.
-user-invocable: true
-argument-hint: "[N] [project <name>] [from <editor>] [today|week|month]"
-allowed-tools: Bash(set -a*), Bash(. *), Bash(curl*)
----
-
-# memhouse-sessions — browse session history
-
-List/filter sessions from the session rollup — a saved query over your own rooms, not an
-object; `memhouse sessions-query` prints it (session metadata +
-message aggregates) in the memhouse house.
-
-## When to use
-
-- The user wants an overview of recent activity rather than a specific quote.
-- As a first step before digging into one session, when they don't have an
-  id/name yet.
-
-## Connection
-
-Credentials from `~/.memhouse/env` (or exported `MEMHOUSE_*`). Always read with
-`final=1` (collapses ReplacingMergeTree duplicates to latest-wins) and
-`join_use_nulls=1` (see below — the session rollup needs it):
-
-```bash
-set -a; [ -f ~/.memhouse/env ] && . ~/.memhouse/env; set +a
-curl -sS --fail-with-body --user "${MEMHOUSE_USER:-memhouse_root}:${MEMHOUSE_PASSWORD:-}" \
-  --data-binary @- "${MEMHOUSE_URL:-http://localhost:8123}/?database=${MEMHOUSE_DB:-mem}&final=1&join_use_nulls=1" <<'SQL'
-<the query>
-FORMAT PrettyCompact
-SQL
-```
-
-## Room names — always suffixed
-
-Every member owns their own rooms, named for their ClickHouse user:
-`messages_<you>`, `sessions_<you>`, `tool_calls_<you>`. There are no unsuffixed rooms;
-the bare names fail with `UNKNOWN_TABLE` rather than returning nothing. You hold no grant
-on anyone else's rooms, so isolation is not something a query can work around.
-
-Resolve your own name once and substitute it into every table name below:
-
-```bash
-MEM_ME="$(curl -sS --fail-with-body --user "$MEMHOUSE_USER:$MEMHOUSE_PASSWORD" \
-  --data-binary "SELECT currentUser() FORMAT TabSeparated" \
-  "${MEMHOUSE_URL:-http://localhost:8123}/" | tr -d '\r\n')"
-# rooms: messages_$MEM_ME, sessions_$MEM_ME, tool_calls_$MEM_ME
-```
-
-**There is no `sessions_v` object.** The session rollup is a saved query over those same
-rooms — `memhouse sessions-query` prints it for whoever you are connected as, ready to
-paste into a `FROM (...) AS c` position.
-
-**Read the rollup with `join_use_nulls=1`.** The connection recipe above sets it. Without
-it, ClickHouse gives an unmatched `m.seq` a default instead of NULL, so a session with no
-messages reports `total_msgs = 1` rather than 0 — measured, not theoretical. A subquery
-has no `SETTINGS` clause of its own, so the setting has to come from the caller.
-
-If you hold `SELECT` on them, `all_messages` / `all_sessions` / `all_tool_calls` read
-across every member at once, narrowed to whatever grants you actually have — a Merge room
-reduces to the rooms the caller can read, so it fails closed rather than denying outright.
-
-## Default listing
-
-```sql
-SELECT session_id, name, source, host, project,
-       started, ended, total_msgs, user_msgs, assistant_msgs,
-       output_tokens,
-       substring(first_prompt, 1, 80) AS first_prompt
-FROM (the rollup from `memhouse sessions-query`)
-ORDER BY ended DESC
-LIMIT 20
-FORMAT PrettyCompact
-```
-
-- Default `LIMIT 20`; `[N]` overrides.
-- `today` / `week` / `month` → `WHERE ended > now() - INTERVAL 1 DAY`
-  (`7 DAY` / `30 DAY`).
-- `project <name>` → `WHERE project ILIKE '%<name>%'`.
-- `from <editor>` → `WHERE source = '<id>'` (`claude-code`, `codex`, `cursor`,
-  `vscode`, `zed`, `opencode`, `gemini-cli`, `windsurf`, …).
-- Unnamed sessions (`name = ''`): fall back to `first_prompt` as the label.
-
-## More cuts
-
-Per-editor rollup ("where has my work been happening?"):
-
-```sql
-SELECT source, count() AS sessions, sum(total_msgs) AS msgs,
-       sum(output_tokens) AS out_tokens, max(ended) AS last_activity
-FROM (the rollup from `memhouse sessions-query`)
-GROUP BY source
-ORDER BY sessions DESC
-FORMAT PrettyCompact
-```
-
-Busiest projects this month:
-
-```sql
-SELECT project, count() AS sessions, sum(assistant_msgs) AS assistant_msgs
-FROM (the rollup from `memhouse sessions-query`)
-WHERE ended > now() - INTERVAL 30 DAY AND project != ''
-GROUP BY project
-ORDER BY sessions DESC
-LIMIT 15
-FORMAT PrettyCompact
-```
-
-## Examples
-
-| User says | What you do |
-|---|---|
-| "what was I working on yesterday?" | `WHERE ended > now() - INTERVAL 1 DAY` |
-| "show my last 10 sessions in agentlytics" | `LIMIT 10 … WHERE project ILIKE '%agentlytics%'` |
-| "list my cursor sessions this month" | `WHERE source = 'cursor' AND ended > now() - INTERVAL 30 DAY` |
-| "which machine did I do the schema work on?" | search via memhouse-search, or filter `host` here |
-
-## Output
-
-A compact table: when, name (or first prompt), source, host, project, msgs,
-tokens. Offer to pull a full transcript next
-(`SELECT role, text FROM messages_<you> WHERE session_id = '…' ORDER BY seq`) or to
-run memhouse-search for a specific quote.