@contextstream/mcp-server 0.4.48 → 0.4.50

package/dist/index.js

@@ -591,7 +591,7 @@ function buildHooksConfig(options) {
     ],
     UserPromptSubmit: userPromptHooks
   };
-  if (options?.includePreCompact) {
+  if (options?.includePreCompact !== false) {
     config.PreCompact = [
       {
         // Match both manual (/compact) and automatic compaction
@@ -643,7 +643,7 @@ async function installHookScripts(options) {
     preToolUse: "npx @contextstream/mcp-server hook pre-tool-use",
     userPrompt: "npx @contextstream/mcp-server hook user-prompt-submit"
   };
-  if (options?.includePreCompact) {
+  if (options?.includePreCompact !== false) {
     result.preCompact = "npx @contextstream/mcp-server hook pre-compact";
   }
   if (options?.includeMediaAware !== false) {
@@ -689,7 +689,7 @@ async function installClaudeCodeHooks(options) {
     "npx @contextstream/mcp-server hook pre-tool-use",
     "npx @contextstream/mcp-server hook user-prompt-submit"
   );
-  if (options.includePreCompact) {
+  if (options.includePreCompact !== false) {
     result.scripts.push("npx @contextstream/mcp-server hook pre-compact");
   }
   if (options.includeMediaAware !== false) {
@@ -756,12 +756,11 @@ When Media-Aware hook detects media patterns, it injects context about:
 - How to get clips for Remotion (with frame-based props)
 - How to index new media files
 
-### PreCompact Hook (Optional)
+### PreCompact Hook
 - **Command:** \`npx @contextstream/mcp-server hook pre-compact\`
 - **Purpose:** Saves conversation state before context compaction
 - **Triggers:** Both manual (/compact) and automatic compaction
-- **Disable:** Set \`CONTEXTSTREAM_PRECOMPACT_ENABLED=false\` environment variable
-- **Note:** Enable with \`generate_rules(include_pre_compact=true)\` to activate
+- **Installed:** By default (disable with \`CONTEXTSTREAM_HOOK_ENABLED=false\`)
 
 When PreCompact runs, it:
 1. Parses the transcript for active files and tool calls
@@ -2633,11 +2632,16 @@ var init_user_prompt_submit = __esm({
   "src/hooks/user-prompt-submit.ts"() {
     "use strict";
     ENABLED3 = process.env.CONTEXTSTREAM_REMINDER_ENABLED !== "false";
-    REMINDER = `[CONTEXTSTREAM RULES]
-1. BEFORE Glob/Grep/Read/Search: mcp__contextstream__search(mode="hybrid") FIRST
-2. Call context_smart at start of EVERY response
-3. Local tools ONLY if ContextStream returns 0 results
-[END RULES]`;
+    REMINDER = `[CONTEXTSTREAM - DO THIS FIRST]
+mcp__contextstream__context(user_message="<user's message>") - CALL THIS BEFORE ANY OTHER TOOL
+
+Why: Delivers task-specific rules, lessons from past mistakes, and relevant context.
+Skip it = repeat past mistakes, miss relevant decisions, fly blind.
+
+BEFORE Glob/Grep/Read/Search/Explore:
+mcp__contextstream__search(mode="hybrid", query="...") FIRST
+Local tools ONLY if search returns 0 results.
+[END]`;
     isDirectRun3 = process.argv[1]?.includes("user-prompt-submit") || process.argv[2] === "user-prompt-submit";
     if (isDirectRun3) {
       runUserPromptSubmitHook().catch(() => process.exit(0));
@@ -2821,6 +2825,9 @@ function parseTranscript(transcriptPath) {
   const activeFiles = /* @__PURE__ */ new Set();
   const recentMessages = [];
   const toolCalls = [];
+  const messages = [];
+  let startedAt = (/* @__PURE__ */ new Date()).toISOString();
+  let firstTimestamp = true;
   try {
     const content = fs10.readFileSync(transcriptPath, "utf-8");
     const lines = content.split("\n");
@@ -2829,6 +2836,11 @@ function parseTranscript(transcriptPath) {
       try {
         const entry = JSON.parse(line);
         const msgType = entry.type || "";
+        const timestamp = entry.timestamp || (/* @__PURE__ */ new Date()).toISOString();
+        if (firstTimestamp && entry.timestamp) {
+          startedAt = entry.timestamp;
+          firstTimestamp = false;
+        }
         if (msgType === "tool_use") {
           const toolName = entry.name || "";
           const toolInput = entry.input || {};
@@ -2844,11 +2856,40 @@ function parseTranscript(transcriptPath) {
               activeFiles.add(`[glob:${pattern}]`);
             }
           }
-        }
-        if (msgType === "assistant" && entry.content) {
-          const content2 = entry.content;
-          if (typeof content2 === "string" && content2.length > 50) {
-            recentMessages.push(content2.slice(0, 500));
+          messages.push({
+            role: "assistant",
+            content: `[Tool: ${toolName}]`,
+            timestamp,
+            tool_calls: { name: toolName, input: toolInput }
+          });
+        } else if (msgType === "tool_result") {
+          const resultContent = typeof entry.content === "string" ? entry.content.slice(0, 2e3) : JSON.stringify(entry.content || {}).slice(0, 2e3);
+          messages.push({
+            role: "tool",
+            content: resultContent,
+            timestamp,
+            tool_results: { name: entry.name }
+          });
+        } else if (msgType === "user" || entry.role === "user") {
+          const userContent = typeof entry.content === "string" ? entry.content : "";
+          if (userContent) {
+            messages.push({
+              role: "user",
+              content: userContent,
+              timestamp
+            });
+          }
+        } else if (msgType === "assistant" || entry.role === "assistant") {
+          const assistantContent = typeof entry.content === "string" ? entry.content : "";
+          if (assistantContent) {
+            messages.push({
+              role: "assistant",
+              content: assistantContent,
+              timestamp
+            });
+            if (assistantContent.length > 50) {
+              recentMessages.push(assistantContent.slice(0, 500));
+            }
           }
         }
       } catch {
@@ -2861,10 +2902,56 @@ function parseTranscript(transcriptPath) {
     activeFiles: Array.from(activeFiles).slice(-20),
     // Last 20 files
     toolCallCount: toolCalls.length,
-    messageCount: recentMessages.length,
-    lastTools: toolCalls.slice(-10).map((t) => t.name)
+    messageCount: messages.length,
+    lastTools: toolCalls.slice(-10).map((t) => t.name),
     // Last 10 tool names
+    messages,
+    startedAt
+  };
+}
+async function saveFullTranscript(sessionId, transcriptData, trigger) {
+  if (!API_KEY2) {
+    return { success: false, message: "No API key configured" };
+  }
+  if (transcriptData.messages.length === 0) {
+    return { success: false, message: "No messages to save" };
+  }
+  const payload = {
+    session_id: sessionId,
+    messages: transcriptData.messages,
+    started_at: transcriptData.startedAt,
+    source_type: "pre_compact",
+    title: `Pre-compaction save (${trigger})`,
+    metadata: {
+      trigger,
+      active_files: transcriptData.activeFiles,
+      tool_call_count: transcriptData.toolCallCount
+    },
+    tags: ["pre_compaction", trigger]
   };
+  if (WORKSPACE_ID) {
+    payload.workspace_id = WORKSPACE_ID;
+  }
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 1e4);
+    const response = await fetch(`${API_URL2}/api/v1/transcripts`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": API_KEY2
+      },
+      body: JSON.stringify(payload),
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    if (response.ok) {
+      return { success: true, message: `Transcript saved (${transcriptData.messages.length} messages)` };
+    }
+    return { success: false, message: `API error: ${response.status}` };
+  } catch (error) {
+    return { success: false, message: String(error) };
+  }
 }
 async function saveSnapshot(sessionId, transcriptData, trigger) {
   if (!API_KEY2) {
@@ -2946,13 +3033,19 @@ async function runPreCompactHook() {
   }
   let autoSaveStatus = "";
   if (AUTO_SAVE && API_KEY2) {
-    const { success, message } = await saveSnapshot(sessionId, transcriptData, trigger);
-    if (success) {
+    const transcriptResult = await saveFullTranscript(sessionId, transcriptData, trigger);
+    if (transcriptResult.success) {
       autoSaveStatus = `
-[ContextStream: Auto-saved snapshot with ${transcriptData.activeFiles.length} active files]`;
+[ContextStream: ${transcriptResult.message}]`;
     } else {
-      autoSaveStatus = `
+      const { success, message } = await saveSnapshot(sessionId, transcriptData, trigger);
+      if (success) {
+        autoSaveStatus = `
+[ContextStream: Auto-saved snapshot with ${transcriptData.activeFiles.length} active files (transcript save failed: ${transcriptResult.message})]`;
+      } else {
+        autoSaveStatus = `
 [ContextStream: Auto-save failed - ${message}]`;
+      }
     }
   }
   const filesList = transcriptData.activeFiles.slice(0, 5).join(", ") || "none detected";
@@ -9931,6 +10024,35 @@ var ContextStreamClient = class {
       }
     });
   }
+  /**
+   * Capture a memory event with a direct event_type.
+   * Used for auto-save session snapshots and other system events.
+   */
+  async captureMemoryEvent(params) {
+    const withDefaults = this.withDefaults(params);
+    const metadata = {
+      ...params.metadata || {}
+    };
+    if (params.tags && params.tags.length > 0) {
+      metadata.tags = params.tags;
+    }
+    if (!metadata.captured_at) {
+      metadata.captured_at = (/* @__PURE__ */ new Date()).toISOString();
+    }
+    if (!metadata.source) {
+      metadata.source = "mcp_auto_capture";
+    }
+    return this.createMemoryEvent({
+      workspace_id: withDefaults.workspace_id,
+      project_id: withDefaults.project_id,
+      event_type: params.event_type,
+      title: params.title,
+      content: params.content,
+      provenance: params.provenance,
+      code_refs: params.code_refs,
+      metadata
+    });
+  }
   submitContextFeedback(body) {
     return request(this.config, "/context/smart/feedback", { body: this.withDefaults(body) });
   }
@@ -10498,7 +10620,11 @@ var ContextStreamClient = class {
           notice_inline: false,
           // Session token tracking for context pressure
           ...params.session_tokens !== void 0 && { session_tokens: params.session_tokens },
-          ...params.context_threshold !== void 0 && { context_threshold: params.context_threshold }
+          ...params.context_threshold !== void 0 && { context_threshold: params.context_threshold },
+          // Transcript save parameters
+          ...params.save_exchange !== void 0 && { save_exchange: params.save_exchange },
+          ...params.session_id !== void 0 && { session_id: params.session_id },
+          ...params.client_name !== void 0 && { client_name: params.client_name }
         }
       });
       const data = unwrapApiResponse(apiResult);
@@ -12060,6 +12186,95 @@ ${context}`;
     uuidSchema.parse(params.doc_id);
     return request(this.config, `/docs/${params.doc_id}`, { method: "DELETE" });
   }
+  // -------------------------------------------------------------------------
+  // Transcript methods (conversation session storage)
+  // -------------------------------------------------------------------------
+  /**
+   * List transcripts for a workspace/project
+   */
+  async listTranscripts(params) {
+    const withDefaults = this.withDefaults(params || {});
+    const query = new URLSearchParams();
+    if (withDefaults.workspace_id) query.set("workspace_id", withDefaults.workspace_id);
+    if (withDefaults.project_id) query.set("project_id", withDefaults.project_id);
+    if (params?.session_id) query.set("session_id", params.session_id);
+    if (params?.client_name) query.set("client_name", params.client_name);
+    if (params?.started_after) query.set("started_after", params.started_after);
+    if (params?.started_before) query.set("started_before", params.started_before);
+    if (params?.limit) query.set("per_page", String(params.limit));
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.per_page) query.set("per_page", String(params.per_page));
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return request(this.config, `/transcripts${suffix}`, { method: "GET" });
+  }
+  /**
+   * Get a specific transcript by ID
+   */
+  async getTranscript(transcript_id) {
+    uuidSchema.parse(transcript_id);
+    return request(this.config, `/transcripts/${transcript_id}`, { method: "GET" });
+  }
+  /**
+   * Search transcripts by content
+   */
+  async searchTranscripts(params) {
+    const withDefaults = this.withDefaults(params);
+    const queryParams = new URLSearchParams();
+    if (withDefaults.workspace_id) queryParams.set("workspace_id", withDefaults.workspace_id);
+    queryParams.set("query", params.query);
+    if (params.limit) queryParams.set("limit", String(params.limit));
+    return request(this.config, `/transcripts/search?${queryParams.toString()}`, { method: "GET" });
+  }
+  /**
+   * Delete a transcript
+   */
+  async deleteTranscript(transcript_id) {
+    uuidSchema.parse(transcript_id);
+    return request(this.config, `/transcripts/${transcript_id}`, { method: "DELETE" });
+  }
+  // -------------------------------------------------------------------------
+  // Suggested Rules methods (ML-generated rule suggestions)
+  // -------------------------------------------------------------------------
+  /**
+   * List suggested rules
+   */
+  async listSuggestedRules(params) {
+    const withDefaults = this.withDefaults(params || {});
+    const queryParams = new URLSearchParams();
+    if (withDefaults.workspace_id) queryParams.set("workspace_id", withDefaults.workspace_id);
+    if (params?.status) queryParams.set("status", params.status);
+    if (params?.source_type) queryParams.set("source_type", params.source_type);
+    if (params?.min_confidence) queryParams.set("min_confidence", String(params.min_confidence));
+    if (params?.limit) queryParams.set("limit", String(params.limit));
+    if (params?.offset) queryParams.set("offset", String(params.offset));
+    return request(this.config, `/suggested-rules?${queryParams.toString()}`, { method: "GET" });
+  }
+  /**
+   * Get pending suggested rules count
+   */
+  async getSuggestedRulesPendingCount(params) {
+    const withDefaults = this.withDefaults(params || {});
+    const queryParams = new URLSearchParams();
+    if (withDefaults.workspace_id) queryParams.set("workspace_id", withDefaults.workspace_id);
+    return request(this.config, `/suggested-rules/pending-count?${queryParams.toString()}`, { method: "GET" });
+  }
+  /**
+   * Get suggested rules feedback stats
+   */
+  async getSuggestedRulesStats(params) {
+    const withDefaults = this.withDefaults(params || {});
+    const queryParams = new URLSearchParams();
+    if (withDefaults.workspace_id) queryParams.set("workspace_id", withDefaults.workspace_id);
+    return request(this.config, `/suggested-rules/stats?${queryParams.toString()}`, { method: "GET" });
+  }
+  /**
+   * Perform action on suggested rule (accept/reject/modify)
+   */
+  async suggestedRuleAction(params) {
+    uuidSchema.parse(params.rule_id);
+    const { rule_id, ...body } = params;
+    return request(this.config, `/suggested-rules/${rule_id}/action`, { method: "POST", body });
+  }
 };
 
 // src/tools.ts
@@ -12103,62 +12318,103 @@ function applyMcpToolPrefix(markdown, toolPrefix) {
   const toolRegex = new RegExp(`(?<!__)\\b(${toolPattern})\\b(?=\\s*\\()`, "g");
   return markdown.replace(toolRegex, `${toolPrefix}$1`);
 }
-var CONTEXTSTREAM_RULES_DYNAMIC = `
-# ContextStream Rules (MANDATORY)
+var CONTEXTSTREAM_RULES_BOOTSTRAP = `
+<contextstream_rules>
+| Message | Required |
+|---------|----------|
+| **1st message** | \`init()\` \u2192 \`context(user_message="...")\` |
+| **Every message** | \`context(user_message="...")\` FIRST |
+| **Before file search** | \`search(mode="hybrid")\` BEFORE Glob/Grep/Read |
+</contextstream_rules>
 
-## \u{1F6A8} CRITICAL: Call These Tools or Fail \u{1F6A8}
+**Why?** \`context()\` delivers task-specific rules, lessons from past mistakes, and relevant decisions. Skip it = fly blind.
 
-<contextstream_protocol>
-**EVERY response MUST start with:**
-1. \`init()\` (1st message only) \u2192 then \`context(user_message="<msg>")\`
-2. \`context(user_message="<msg>")\` (EVERY subsequent message)
+**Hooks:** \`<system-reminder>\` tags contain injected instructions \u2014 follow them exactly.
 
-**BEFORE Glob/Grep/Read/Search/Explore:**
-\u2192 \`search(mode="hybrid", query="...")\` FIRST \u2014 local tools ONLY if 0 results
+**Notices:** [LESSONS_WARNING] \u2192 tell user first | [RULES_NOTICE] \u2192 run \`generate_rules()\` | [VERSION_NOTICE] \u2192 tell user to update
 
-**HOOKS: Follow \`<system-reminder>\` instructions \u2014 they ARE the rules**
-</contextstream_protocol>
+v${RULES_VERSION}
+`.trim();
+var CONTEXTSTREAM_RULES_DYNAMIC = CONTEXTSTREAM_RULES_BOOTSTRAP;
+var CONTEXTSTREAM_RULES_FULL = `
+## \u{1F6A8} MANDATORY: CALL CONTEXT EVERY MESSAGE \u{1F6A8}
 
-### Why This Matters
+<contextstream_rules>
+**EVERY response MUST start with \`context(user_message="...")\`**
 
-- **\`context()\`** = Your rules, lessons, and relevant memories delivered dynamically
-- **\`search()\`** = Indexed search (1 call) vs Grep\u2192Read\u2192Read (4+ calls)
-- **Hooks inject \`<system-reminder>\` tags** = Follow these instructions, they enforce ContextStream-first
-- **Skipping these = missing context, repeated mistakes, slow searches**
+| Message | What to Call |
+|---------|--------------|
+| 1st message | \`init()\` \u2192 \`context(user_message="<msg>")\` |
+| **EVERY message after** | \`context(user_message="<msg>")\` **FIRST** |
 
-### Protocol
+**BEFORE Glob/Grep/Read/Search:** \u2192 \`search(mode="hybrid")\` FIRST
+</contextstream_rules>
 
-| When | Do This |
-|------|---------|
-| 1st message | \`init()\` \u2192 \`context(user_message="...")\` |
-| Every message after | \`context(user_message="...")\` |
-| Before ANY file search | \`search(mode="hybrid")\` first |
-| On \`<system-reminder>\` | **Follow the instructions inside** |
-| Save decisions | \`session(action="capture", ...)\` |
+**This block MUST appear at the start of EVERY response.** Failing to call \`context()\` means missing rules, lessons, and relevant context.
+
+---
+
+## Why \`context()\` is MANDATORY Every Message
+
+\u274C **WRONG:** "I already called init, I don't need context"
+\u2705 **CORRECT:** \`context()\` is required EVERY message, not just the first
+
+**What you lose without \`context()\`:**
+- Dynamic rules matched to your current task
+- Lessons from past mistakes (you WILL repeat them)
+- Semantically relevant decisions and context
+- Warnings about risky operations
+
+**\`init()\` gives recent items by TIME. \`context()\` finds items RELEVANT to THIS message.**
+
+---
 
-### Handle Notices from context()
+## Handle Notices from context()
 
 - **[LESSONS_WARNING]** \u2192 Tell user about past mistakes BEFORE proceeding
 - **[RULES_NOTICE]** \u2192 Run \`generate_rules()\` to update
 - **[VERSION_NOTICE]** \u2192 Tell user to update MCP
 
-### Fast Path (Skip context only for these)
+---
 
-Simple utility commands: "list workspaces", "show version", "list reminders"
-\u2192 Just execute directly: \`workspace(action="list")\`, \`help(action="version")\`
+## \u{1F6A8} HOOKS - AUTOMATIC RULE ENFORCEMENT \u{1F6A8}
 
-Rules Version: ${RULES_VERSION}
-`.trim();
-var CONTEXTSTREAM_RULES_FULL = `
-## ContextStream Rules
+**ContextStream installs hooks that automatically enforce rules.** You MUST follow hook output.
 
-<contextstream_rules>
-1. **SIMPLE UTILITY?** (list/show/version) \u2192 Just execute, skip context calls
-2. **CODING TASK?** \u2192 init \u2192 context \u2192 work \u2192 capture
-3. **SEARCH FIRST:** Before Glob/Grep/Read \u2192 \`search(mode="hybrid")\` FIRST
-</contextstream_rules>
+### Installed Hooks
 
-**Display this block at the start of responses to keep rules in context.**
+| Hook | What It Does | Output |
+|------|--------------|--------|
+| **UserPromptSubmit** | Injects rules reminder on EVERY message | \`<system-reminder>\` with rules block |
+| **PreToolUse** | Blocks Glob/Grep/Search/Explore when ContextStream is available | Error message redirecting to \`search()\` |
+| **PostToolUse** | Auto-indexes files after Edit/Write operations | Background indexing |
+| **PreCompact** | Saves session state before context compaction | Snapshot creation |
+
+### How Hooks Work
+
+1. **\`<system-reminder>\` tags** - Injected by UserPromptSubmit hook on every message
+   - These tags contain the current rules
+   - **FOLLOW THE INSTRUCTIONS INSIDE** - they ARE the rules
+   - Example: \`[CONTEXTSTREAM RULES] 1. BEFORE Glob/Grep... [END RULES]\`
+
+2. **PreToolUse blocking** - If you try to use Glob/Grep/Search/Explore:
+   - Hook returns error: \`STOP: Use mcp__contextstream__search(mode="hybrid") instead\`
+   - **You MUST use the suggested ContextStream tool instead**
+   - Local tools are only allowed if project is not indexed or ContextStream returns 0 results
+
+3. **PostToolUse indexing** - After Edit/Write operations:
+   - Changed files are automatically re-indexed
+   - No action required from you
+
+4. **PreCompact snapshots** - Before context compaction:
+   - Hook reminds you to save important state
+   - Call \`session(action="capture", event_type="session_snapshot", ...)\` when warned
+
+### Disabling Hooks
+
+Set environment variable: \`CONTEXTSTREAM_HOOK_ENABLED=false\`
+
+**Note:** Disabling hooks removes rule enforcement. Only disable for debugging.
 
 ---
 
@@ -12244,27 +12500,27 @@ You have access to ContextStream MCP tools for persistent memory and context.
 v0.4.x uses **~11 consolidated domain tools** for ~75% token reduction vs previous versions.
 Rules Version: ${RULES_VERSION}
 
-## TL;DR - WHEN TO USE CONTEXT
+## TL;DR - CONTEXT EVERY MESSAGE
 
-| Request Type | What to Do |
-|--------------|------------|
-| **\u{1F680} Simple utility** (list workspaces, show version) | **Just execute directly** - skip init, context, capture |
-| **\u{1F4BB} Coding task** (edit, create, refactor) | Full context: init \u2192 context \u2192 work \u2192 capture |
-| **\u{1F50D} Code search/discovery** | init \u2192 context \u2192 search() |
-| **\u26A0\uFE0F Risky work** (deploy, migrate, refactor) | Check lessons first: \`session(action="get_lessons")\` |
-| **User frustration/correction** | Capture lesson: \`session(action="capture_lesson", ...)\` |
+| Message | Required |
+|---------|----------|
+| **1st message** | \`init()\` \u2192 \`context(user_message="<msg>")\` |
+| **EVERY message after** | \`context(user_message="<msg>")\` **FIRST** |
+| **Before file search** | \`search(mode="hybrid")\` FIRST |
+| **After significant work** | \`session(action="capture", event_type="decision", ...)\` |
+| **User correction** | \`session(action="capture_lesson", ...)\` |
 
-### Simple Utility Operations - FAST PATH
+### Why EVERY Message?
 
-**For simple queries, just execute and respond:**
-- "list workspaces" \u2192 \`workspace(action="list")\` \u2192 done
-- "list projects" \u2192 \`project(action="list")\` \u2192 done
-- "show version" \u2192 \`help(action="version")\` \u2192 done
-- "what reminders do I have" \u2192 \`reminder(action="list")\` \u2192 done
+\`context()\` delivers:
+- **Dynamic rules** matched to your current task
+- **Lessons** from past mistakes (prevents repeating errors)
+- **Relevant decisions** and context (semantic search)
+- **Warnings** about risky operations
 
-**No init. No context. No capture.** These add noise, not value.
+**Without \`context()\`, you are blind to relevant context and will repeat past mistakes.**
 
-### Coding Tasks - FULL CONTEXT
+### Protocol
 
 | Step | What to Call |
 |------|--------------|
@@ -12275,12 +12531,7 @@ Rules Version: ${RULES_VERSION}
 | **User correction** | \`session(action="capture_lesson", ...)\` |
 | **\u26A0\uFE0F When warnings received** | **STOP**, acknowledge, explain mitigation, then proceed |
 
-**How to detect simple utility operations:**
-- Single-word commands: "list", "show", "version", "help"
-- Data retrieval with no context dependency: "list my workspaces", "what projects do I have"
-- Status checks: "am I authenticated?", "what's the server version?"
-
-**First message rule (for coding tasks):** After \`init\`:
+**First message rule:** After \`init\`:
 1. Check for \`lessons\` in response - if present, READ and SUMMARIZE them to user
 2. Then call \`context\` before any other tool or response
 
@@ -12380,8 +12631,8 @@ ContextStream tracks context pressure to help you stay ahead of conversation com
    - \`prepare_save\`: Start thinking about saving important state
    - \`save_now\`: Immediately call \`session(action="capture", event_type="session_snapshot")\` to preserve state
 
-**PreCompact Hook (Optional):** If enabled, Claude Code will inject a reminder to save state before compaction.
-Enable with: \`generate_rules(install_hooks=true, include_pre_compact=true)\`
+**PreCompact Hook:** Automatically saves session state before context compaction.
+Installed by default. Disable with: \`CONTEXTSTREAM_HOOK_ENABLED=false\`
 
 **Before compaction happens (when warned):**
 \`\`\`
@@ -12678,7 +12929,7 @@ Everything else = full protocol (init \u2192 context \u2192 search \u2192 work)
 ### Context Pressure & Compaction
 
 - If \`context\` returns high/critical \`context_pressure\`: call \`session(action="capture", ...)\` to save state
-- PreCompact hooks automatically save snapshots before compaction (if installed)
+- PreCompact hooks automatically save snapshots before compaction
 
 ### Enhanced Context (Warnings)
 
@@ -12793,8 +13044,8 @@ function getTemplate(editor) {
 function generateRuleContent(editor, options) {
   const template = getTemplate(editor);
   if (!template) return null;
-  const mode = options?.mode || "dynamic";
-  const rules = mode === "full" ? CONTEXTSTREAM_RULES_FULL : mode === "minimal" ? CONTEXTSTREAM_RULES_MINIMAL : CONTEXTSTREAM_RULES_DYNAMIC;
+  const mode = options?.mode || "bootstrap";
+  const rules = mode === "full" ? CONTEXTSTREAM_RULES_FULL : mode === "minimal" ? CONTEXTSTREAM_RULES_MINIMAL : mode === "bootstrap" ? CONTEXTSTREAM_RULES_BOOTSTRAP : CONTEXTSTREAM_RULES_DYNAMIC;
   let content = template.build(rules);
   if (options?.workspaceName || options?.projectName) {
     const header = `
@@ -13070,6 +13321,85 @@ function trackToolTokenSavings(client, tool, contextText, params, extraMetadata)
   }
 }
 
+// src/microcopy.ts
+function getSessionInitTip(sessionId) {
+  return `Session ${sessionId.slice(0, 8)}... initialized. Use context(user_message="...") to get relevant context.`;
+}
+function getCaptureHint(eventType) {
+  switch (eventType) {
+    case "decision":
+      return "Decision captured. It will surface in future context() calls when relevant.";
+    case "preference":
+      return "Preference saved. Future sessions will respect this preference.";
+    case "insight":
+      return "Insight captured. Use recall() to retrieve it later.";
+    case "task":
+      return "Task captured. Use list_tasks() to view all tasks.";
+    case "lesson":
+      return "Lesson saved. It will warn you before similar mistakes.";
+    case "session_snapshot":
+      return "Session state saved. Use restore_context() after compaction.";
+    default:
+      return "Event captured. Use recall() to retrieve related events.";
+  }
+}
+function getEmptyStateHint(operation) {
+  switch (operation) {
+    case "get_lessons":
+      return "No lessons found. Lessons are captured when mistakes occur.";
+    case "recall":
+      return "No memories found. Use capture() or remember() to save context.";
+    case "list_plans":
+      return "No plans found. Use capture_plan() to create an implementation plan.";
+    case "list_events":
+      return "No events found. Events are captured as you work.";
+    case "list_tasks":
+      return "No tasks found. Use create_task() to add tasks.";
+    case "list_todos":
+      return "No todos found. Use create_todo() to add quick todos.";
+    case "list_diagrams":
+      return "No diagrams found. Use create_diagram() to save a Mermaid diagram.";
+    case "list_docs":
+      return "No docs found. Use create_doc() to save documentation.";
+    default:
+      return "No results found.";
+  }
+}
+function getPlanStatusHint(status) {
+  switch (status) {
+    case "draft":
+      return "Plan saved as draft. Update status to 'active' when ready.";
+    case "active":
+      return "Plan is now active. Create tasks to track implementation.";
+    case "completed":
+      return "Plan completed. Great work!";
+    case "archived":
+      return "Plan archived. It will still appear in searches.";
+    case "abandoned":
+      return "Plan abandoned. Consider capturing lessons learned.";
+    default:
+      return "Plan updated. Changes are preserved.";
+  }
+}
+var POST_COMPACT_HINTS = {
+  restored: "Context restored from pre-compaction snapshot.",
+  restored_with_session: (sessionId) => `Context restored from session ${sessionId.slice(0, 8)}... snapshot.`,
+  no_snapshot: "No snapshot found. Session state may be incomplete.",
+  failed: "Failed to restore context. Try recall() to find relevant memories."
+};
+var INTEGRATION_HINTS = {
+  connected: "Integration connected and syncing.",
+  not_connected: "Integration not connected. Connect at:",
+  sync_in_progress: "Sync in progress. Results may be incomplete.",
+  sync_complete: "Sync complete. All data is current."
+};
+var TASK_HINTS = {
+  created: "Task created. Use update_task() to change status.",
+  completed: "Task completed. Well done!",
+  blocked: "Task blocked. Add blocked_reason for context.",
+  linked_to_plan: "Task linked to plan. Progress will be tracked."
+};
+
 // src/tools.ts
 var LOG_LEVEL = (process.env.CONTEXTSTREAM_LOG_LEVEL || "normal").toLowerCase();
 var LOG_QUIET = LOG_LEVEL === "quiet";
@@ -13135,6 +13465,7 @@ var lastAutoSavePressureLevel = "";
 var contextCallsSinceLastSave = 0;
 var SEARCH_RULES_REMINDER_ENABLED = process.env.CONTEXTSTREAM_SEARCH_REMINDER?.toLowerCase() !== "false";
 var SEARCH_RULES_REMINDER = `[SEARCH] Use search(mode="hybrid") before Glob/Grep/Read. Local tools only if 0 results.`;
+var CONTEXT_CALL_REMINDER = `[CONTEXT] Call context(user_message="...") at start of EVERY response. This is MANDATORY.`;
 var LESSONS_REMINDER_PREFIX = `
 \u{1F6A8} [LESSONS_WARNING] Past Mistakes Found - READ BEFORE PROCEEDING!
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
@@ -14733,7 +15064,10 @@ function registerTools(server, client, sessionManager) {
     "notion_stats",
     "notion_activity",
     "notion_knowledge",
-    "notion_summary"
+    "notion_summary",
+    // Media operations (credit-metered)
+    "media_index",
+    "media_search"
   ]);
   const proTools = (() => {
     const raw = process.env.CONTEXTSTREAM_PRO_TOOLS;
@@ -16821,6 +17155,8 @@ This does semantic search on the first message. You only need context on subsequ
         ideRoots
       );
       result.tools_hint = getCoreToolsHint();
+      const sessionId = typeof result.session_id === "string" ? result.session_id : void 0;
+      result.educational_tip = getSessionInitTip(sessionId);
       const shouldRestoreContext = input.is_post_compact ?? RESTORE_CONTEXT_DEFAULT;
       if (shouldRestoreContext) {
         result.is_post_compact = true;
@@ -16890,15 +17226,15 @@ This does semantic search on the first message. You only need context on subsequ
                 ...snapshotData
               };
               result.is_post_compact = true;
-              result.post_compact_hint = prevSessionId ? `Session restored from session ${prevSessionId}. Review 'restored_context' to continue where you left off.` : "Session restored from pre-compaction snapshot. Review the 'restored_context' to continue where you left off.";
+              result.post_compact_hint = prevSessionId ? POST_COMPACT_HINTS.restored_with_session(prevSessionId) : POST_COMPACT_HINTS.restored;
             } else {
               result.is_post_compact = true;
-              result.post_compact_hint = "Post-compaction session started, but no snapshots found. Use context_smart to retrieve relevant context.";
+              result.post_compact_hint = POST_COMPACT_HINTS.no_snapshot;
             }
           } catch (err) {
             logDebug(`Failed to restore post-compact context: ${err}`);
             result.is_post_compact = true;
-            result.post_compact_hint = "Post-compaction session started. Snapshot restoration failed, use context_smart for context.";
+            result.post_compact_hint = POST_COMPACT_HINTS.failed;
           }
         }
       }
@@ -16934,7 +17270,7 @@ This does semantic search on the first message. You only need context on subsequ
             slack_connected: intStatus.slack,
             github_connected: intStatus.github,
             auto_hide_enabled: true,
-            hint: intStatus.slack || intStatus.github ? "Integration tools are now available in the tool list." : "Connect integrations at https://contextstream.io/settings/integrations to enable Slack/GitHub tools."
+            hint: intStatus.slack || intStatus.github ? "Integration tools are now available in the tool list." : INTEGRATION_HINTS.not_connected + " https://contextstream.io/settings/integrations"
           };
         } catch (error) {
           logDebug(`Failed to check integration status: ${error}`);
@@ -17946,11 +18282,11 @@ Supported editors: ${getAvailableEditors().join(", ")}`,
         workspace_id: external_exports.string().uuid().optional().describe("Workspace ID to include in rules"),
         project_name: external_exports.string().optional().describe("Project name to include in rules"),
         additional_rules: external_exports.string().optional().describe("Additional project-specific rules to append"),
-        mode: external_exports.enum(["minimal", "full"]).optional().describe("Rule verbosity mode (default: minimal)"),
-        overwrite_existing: external_exports.boolean().optional().describe("Allow overwriting existing rule files (ContextStream block only)"),
+        mode: external_exports.enum(["minimal", "full", "bootstrap"]).optional().default("bootstrap").describe("Rule verbosity: bootstrap (~15 lines, recommended), minimal (~80 lines), full (~600 lines)"),
+        overwrite_existing: external_exports.boolean().optional().default(true).describe("Overwrite ContextStream block in existing rule files (default: true). User content outside the block is preserved."),
         apply_global: external_exports.boolean().optional().describe("Also write global rule files for supported editors"),
         install_hooks: external_exports.boolean().optional().describe("Install Claude Code hooks to enforce ContextStream-first search. Defaults to true for Claude users. Set to false to skip."),
-        include_pre_compact: external_exports.boolean().optional().describe("Include PreCompact hook for automatic state saving before context compaction. Defaults to false."),
+        include_pre_compact: external_exports.boolean().optional().describe("Include PreCompact hook for automatic state saving before context compaction. Defaults to true."),
         dry_run: external_exports.boolean().optional().describe("If true, return content without writing files")
       })
     },
@@ -18041,7 +18377,7 @@ Supported editors: ${getAvailableEditors().join(", ")}`,
                   { editor, file: "~/.claude/hooks/contextstream-reminder.py", status: "dry run - would create" },
                   { editor, file: "~/.claude/settings.json", status: "dry run - would update" }
                 );
-                if (input.include_pre_compact) {
+                if (input.include_pre_compact !== false) {
                   hooksResults.push({ editor, file: "~/.claude/hooks/contextstream-precompact.py", status: "dry run - would create" });
                 }
               } else if (editor === "cline") {
@@ -18072,7 +18408,7 @@ Supported editors: ${getAvailableEditors().join(", ")}`,
             const allHookResults = await installAllEditorHooks({
               scope: "global",
               editors: hookSupportedEditors,
-              includePreCompact: input.include_pre_compact
+              includePreCompact: input.include_pre_compact !== false
             });
             for (const result of allHookResults) {
               for (const file of result.installed) {
@@ -18428,7 +18764,10 @@ This saves ~80% tokens compared to including full chat history.`,
         mode: external_exports.enum(["standard", "pack"]).optional().describe("Context pack mode (default: pack when enabled)"),
         distill: external_exports.boolean().optional().describe("Use distillation for context pack (default: true)"),
         session_tokens: external_exports.number().optional().describe("Cumulative session token count for context pressure calculation"),
-        context_threshold: external_exports.number().optional().describe("Custom context window threshold (defaults to 70k)")
+        context_threshold: external_exports.number().optional().describe("Custom context window threshold (defaults to 70k)"),
+        save_exchange: external_exports.boolean().optional().describe("Save this exchange to the transcript for later search (background task)"),
+        session_id: external_exports.string().optional().describe("Session ID for transcript association (required if save_exchange is true)"),
+        client_name: external_exports.string().optional().describe("Client name for transcript metadata (e.g., 'claude', 'cursor')")
       })
     },
     async (input) => {
@@ -18504,6 +18843,14 @@ This saves ~80% tokens compared to including full chat history.`,
           logDebug(`Failed to restore post-compact context: ${err}`);
         }
       }
+      let sessionId = input.session_id;
+      if (!sessionId && sessionManager && input.save_exchange) {
+        sessionId = sessionManager.getSessionId();
+      }
+      let clientName = input.client_name;
+      if (!clientName && detectedClientInfo) {
+        clientName = detectedClientInfo.name;
+      }
       const result = await client.getSmartContext({
         user_message: input.user_message,
         workspace_id: workspaceId,
@@ -18513,7 +18860,10 @@ This saves ~80% tokens compared to including full chat history.`,
         mode: input.mode,
         distill: input.distill,
         session_tokens: sessionTokens,
-        context_threshold: contextThreshold
+        context_threshold: contextThreshold,
+        save_exchange: input.save_exchange,
+        session_id: sessionId,
+        client_name: clientName
       });
       if (sessionManager && result.token_estimate) {
         sessionManager.addTokens(result.token_estimate);
@@ -18659,6 +19009,9 @@ Action: ${cp.suggested_action === "prepare_save" ? "Consider saving important de
       const instructionsLine = result.instructions ? `
 
 [INSTRUCTIONS] ${result.instructions}` : "";
+      const contextRulesLine = `
+
+${CONTEXT_CALL_REMINDER}`;
       const allWarnings = [
         serverWarningsLine || lessonsWarningLine,
         // Server warnings OR client-side lesson detection
@@ -18671,6 +19024,8 @@ ${versionWarningLine}` : "",
         contextPressureWarning,
         semanticHints,
         instructionsLine,
+        contextRulesLine,
+        // Reinforce context() must be called every message
         searchRulesLine
       ].filter(Boolean).join("");
       const finalContext = postCompactContext + result.context;
@@ -19805,7 +20160,7 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
       "session",
       {
         title: "Session",
-        description: `Session management operations. Actions: capture (save decision/insight), capture_lesson (save lesson from mistake), get_lessons (retrieve lessons), recall (natural language recall), remember (quick save), user_context (get preferences), summary (workspace summary), compress (compress chat), delta (changes since timestamp), smart_search (context-enriched search), decision_trace (trace decision provenance), restore_context (restore state after compaction). Plan actions: capture_plan (save implementation plan), get_plan (retrieve plan with tasks), update_plan (modify plan), list_plans (list all plans). Team actions (team plans only): team_decisions (team-wide decisions), team_lessons (team-wide lessons), team_plans (plans across team workspaces).`,
+        description: `Session management operations. Actions: capture (save decision/insight), capture_lesson (save lesson from mistake), get_lessons (retrieve lessons), recall (natural language recall), remember (quick save), user_context (get preferences), summary (workspace summary), compress (compress chat), delta (changes since timestamp), smart_search (context-enriched search), decision_trace (trace decision provenance), restore_context (restore state after compaction). Plan actions: capture_plan (save implementation plan), get_plan (retrieve plan with tasks), update_plan (modify plan), list_plans (list all plans). Suggested rules actions: list_suggested_rules (view ML-generated rule suggestions), suggested_rule_action (accept/reject/modify a suggestion), suggested_rules_stats (view ML accuracy stats). Team actions (team plans only): team_decisions (team-wide decisions), team_lessons (team-wide lessons), team_plans (plans across team workspaces).`,
         inputSchema: external_exports.object({
           action: external_exports.enum([
             "capture",
@@ -19829,7 +20184,11 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
             // Team actions (team plans only)
             "team_decisions",
             "team_lessons",
-            "team_plans"
+            "team_plans",
+            // Suggested rules actions (ML-generated)
+            "list_suggested_rules",
+            "suggested_rule_action",
+            "suggested_rules_stats"
           ]).describe("Action to perform"),
           workspace_id: external_exports.string().uuid().optional(),
           project_id: external_exports.string().uuid().optional(),
@@ -19906,7 +20265,13 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
           is_personal: external_exports.boolean().optional().describe("Mark plan as personal (only visible to creator). For capture_plan/list_plans."),
           // Restore context params
           snapshot_id: external_exports.string().uuid().optional().describe("Specific snapshot ID to restore (defaults to most recent)"),
-          max_snapshots: external_exports.number().optional().default(1).describe("Number of recent snapshots to consider (default: 1)")
+          max_snapshots: external_exports.number().optional().default(1).describe("Number of recent snapshots to consider (default: 1)"),
+          // Suggested rules params
+          rule_id: external_exports.string().uuid().optional().describe("Suggested rule ID for actions"),
+          rule_action: external_exports.enum(["accept", "reject", "modify"]).optional().describe("Action to perform on suggested rule"),
+          modified_keywords: external_exports.array(external_exports.string()).optional().describe("Modified keywords when action is modify"),
+          modified_instruction: external_exports.string().optional().describe("Modified instruction when action is modify"),
+          min_confidence: external_exports.number().optional().describe("Minimum confidence threshold for listing rules")
         })
       },
       async (input) => {
@@ -19929,8 +20294,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               code_refs: input.code_refs,
               provenance: input.provenance
             });
+            const captureHint = getCaptureHint(input.event_type);
+            const resultWithHint = { ...result, hint: captureHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "capture_lesson": {
@@ -19986,8 +20353,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               importance: input.severity === "critical" ? "critical" : input.severity === "high" ? "high" : "medium",
               tags: input.keywords || []
             });
+            const lessonHint = getCaptureHint("lesson");
+            const resultWithHint = { ...result, hint: lessonHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "get_lessons": {
@@ -20000,8 +20369,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               context_hint: input.query,
               limit: input.limit
             });
+            const lessons = result?.data?.lessons || result?.lessons || [];
+            const resultWithHint = Array.isArray(lessons) && lessons.length === 0 ? { ...result, hint: getEmptyStateHint("get_lessons") } : result;
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "recall": {
@@ -20015,7 +20386,9 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               include_related: input.include_related,
               include_decisions: input.include_decisions
             });
-            const outputText = formatContent(result);
+            const recallResults = result?.data?.results || result?.results || [];
+            const recallWithHint = Array.isArray(recallResults) && recallResults.length === 0 ? { ...result, hint: getEmptyStateHint("recall") } : result;
+            const outputText = formatContent(recallWithHint);
             trackToolTokenSavings(client, "session_recall", outputText, {
               workspace_id: workspaceId,
               project_id: projectId
@@ -20035,8 +20408,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               content: input.content,
               importance
             });
+            const rememberHint = getCaptureHint("preference");
+            const resultWithHint = { ...result, hint: rememberHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "user_context": {
@@ -20149,8 +20524,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               source_tool: input.source_tool || "mcp",
               is_personal: input.is_personal
             });
+            const planHint = getPlanStatusHint(input.status || "draft");
+            const resultWithHint = { ...result, hint: planHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "get_plan": {
@@ -20180,8 +20557,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               tags: input.tags,
               due_at: input.due_at
             });
+            const planUpdateHint = input.status ? getPlanStatusHint(input.status) : "Plan updated. Changes are preserved.";
+            const resultWithHint = { ...result, hint: planUpdateHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "list_plans": {
@@ -20195,8 +20574,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               limit: input.limit,
               is_personal: input.is_personal
             });
+            const plans = result?.data?.plans || result?.plans || result?.data?.items || result?.items || [];
+            const resultWithHint = plans.length === 0 ? { ...result, hint: getEmptyStateHint("list_plans") } : result;
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "restore_context": {
@@ -20466,6 +20847,81 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               ]
             };
           }
+          case "list_suggested_rules": {
+            const result = await client.listSuggestedRules({
+              workspace_id: workspaceId,
+              status: input.status,
+              min_confidence: input.min_confidence,
+              limit: input.limit
+            });
+            const rules = result?.data?.items || result?.items || [];
+            if (rules.length === 0) {
+              return {
+                content: [
+                  {
+                    type: "text",
+                    text: formatContent({
+                      suggested_rules: [],
+                      hint: "No pending rule suggestions. The ML system learns from your lessons and will suggest rules when patterns are detected."
+                    })
+                  }
+                ]
+              };
+            }
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: formatContent({
+                    suggested_rules: rules,
+                    total: result?.data?.total || rules.length,
+                    hint: "Use suggested_rule_action to accept, reject, or modify these suggestions."
+                  })
+                }
+              ]
+            };
+          }
+          case "suggested_rule_action": {
+            if (!input.rule_id || !input.rule_action) {
+              return errorResult("suggested_rule_action requires: rule_id, rule_action (accept/reject/modify)");
+            }
+            const result = await client.suggestedRuleAction({
+              rule_id: input.rule_id,
+              action: input.rule_action,
+              modified_keywords: input.modified_keywords,
+              modified_instruction: input.modified_instruction
+            });
+            const actionVerb = input.rule_action === "accept" ? "accepted" : input.rule_action === "reject" ? "rejected" : "modified";
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: formatContent({
+                    success: true,
+                    message: `Rule ${actionVerb} successfully`,
+                    rule: result?.data || result,
+                    hint: input.rule_action === "accept" ? "This rule will now be applied to future context() calls." : input.rule_action === "reject" ? "This pattern will have reduced confidence for future suggestions." : "The modified rule will be applied to future context() calls."
+                  })
+                }
+              ]
+            };
+          }
+          case "suggested_rules_stats": {
+            const result = await client.getSuggestedRulesStats({
+              workspace_id: workspaceId
+            });
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: formatContent({
+                    stats: result?.data || result,
+                    hint: "These stats show ML vs Grok accuracy. The blend weight auto-adjusts based on these metrics."
+                  })
+                }
+              ]
+            };
+          }
           default:
             return errorResult(`Unknown action: ${input.action}`);
         }
@@ -20475,7 +20931,7 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
       "memory",
       {
         title: "Memory",
-        description: `Memory operations for events and nodes. Event actions: create_event, get_event, update_event, delete_event, list_events, distill_event, import_batch (bulk import array of events). Node actions: create_node, get_node, update_node, delete_node, list_nodes, supersede_node. Query actions: search, decisions, timeline, summary. Task actions: create_task (create task, optionally linked to plan), get_task, update_task (can link/unlink task to plan via plan_id), delete_task, list_tasks, reorder_tasks. Todo actions: create_todo, list_todos, get_todo, update_todo, delete_todo, complete_todo. Diagram actions: create_diagram, list_diagrams, get_diagram, update_diagram, delete_diagram. Doc actions: create_doc, list_docs, get_doc, update_doc, delete_doc, create_roadmap. Team actions (team plans only): team_tasks, team_todos, team_diagrams, team_docs.`,
+        description: `Memory operations for events and nodes. Event actions: create_event, get_event, update_event, delete_event, list_events, distill_event, import_batch (bulk import array of events). Node actions: create_node, get_node, update_node, delete_node, list_nodes, supersede_node. Query actions: search, decisions, timeline, summary. Task actions: create_task (create task, optionally linked to plan), get_task, update_task (can link/unlink task to plan via plan_id), delete_task, list_tasks, reorder_tasks. Todo actions: create_todo, list_todos, get_todo, update_todo, delete_todo, complete_todo. Diagram actions: create_diagram, list_diagrams, get_diagram, update_diagram, delete_diagram. Doc actions: create_doc, list_docs, get_doc, update_doc, delete_doc, create_roadmap. Transcript actions: list_transcripts (list saved conversations), get_transcript (get full transcript by ID), search_transcripts (semantic search across conversations), delete_transcript. Team actions (team plans only): team_tasks, team_todos, team_diagrams, team_docs.`,
         inputSchema: external_exports.object({
           action: external_exports.enum([
             "create_event",
@@ -20523,6 +20979,11 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
             "update_doc",
             "delete_doc",
             "create_roadmap",
+            // Transcript actions
+            "list_transcripts",
+            "get_transcript",
+            "search_transcripts",
+            "delete_transcript",
             // Team actions
             "team_tasks",
             "team_todos",
@@ -20628,7 +21089,13 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
             })
           ).optional().describe("Milestones for create_roadmap action"),
           // Personal items param
-          is_personal: external_exports.boolean().optional().describe("Mark as personal (only visible to creator). For create/list actions on todos, diagrams, docs.")
+          is_personal: external_exports.boolean().optional().describe("Mark as personal (only visible to creator). For create/list actions on todos, diagrams, docs."),
+          // Transcript params
+          transcript_id: external_exports.string().uuid().optional().describe("Transcript ID for get_transcript/delete_transcript"),
+          session_id: external_exports.string().optional().describe("Session ID filter for list_transcripts"),
+          client_name: external_exports.string().optional().describe("Client name filter for list_transcripts (e.g., 'claude', 'cursor')"),
+          started_after: external_exports.string().optional().describe("ISO timestamp - filter transcripts started after this time"),
+          started_before: external_exports.string().optional().describe("ISO timestamp - filter transcripts started before this time")
         })
       },
       async (input) => {
@@ -20690,8 +21157,10 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               project_id: projectId,
               limit: input.limit
             });
+            const events = result?.data?.items || result?.items || result?.data || [];
+            const resultWithHint = Array.isArray(events) && events.length === 0 ? { ...result, hint: getEmptyStateHint("list_events") } : result;
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "import_batch": {
@@ -20884,8 +21353,10 @@ ${formatContent(result)}`
               tags: input.tags,
               is_personal: input.is_personal
             });
+            const taskCreateHint = TASK_HINTS.created;
+            const resultWithHint = { ...result, hint: taskCreateHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "get_task": {
@@ -20917,8 +21388,17 @@ ${formatContent(result)}`
               tags: input.tags,
               blocked_reason: input.blocked_reason
             });
+            let taskUpdateHint = "Task updated.";
+            if (input.task_status === "completed") {
+              taskUpdateHint = TASK_HINTS.completed;
+            } else if (input.task_status === "blocked") {
+              taskUpdateHint = TASK_HINTS.blocked;
+            } else if (input.task_status === "cancelled") {
+              taskUpdateHint = TASK_HINTS.cancelled;
+            }
+            const resultWithHint = { ...result, hint: taskUpdateHint };
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "delete_task": {
@@ -20945,8 +21425,10 @@ ${formatContent(result)}`
               limit: input.limit,
               is_personal: input.is_personal
             });
+            const tasks = result?.data?.tasks || result?.tasks || result?.data?.items || result?.items || [];
+            const resultWithHint = Array.isArray(tasks) && tasks.length === 0 ? { ...result, hint: getEmptyStateHint("list_tasks") } : result;
             return {
-              content: [{ type: "text", text: formatContent(result) }]
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
           }
           case "reorder_tasks": {
@@ -20998,8 +21480,10 @@ ${formatContent(result)}`
               priority: input.todo_priority,
               is_personal: input.is_personal
             });
+            const todos = todosResult?.data?.todos || todosResult?.todos || todosResult?.data?.items || todosResult?.items || [];
+            const todosWithHint = Array.isArray(todos) && todos.length === 0 ? { ...todosResult, hint: getEmptyStateHint("list_todos") } : todosResult;
             return {
-              content: [{ type: "text", text: formatContent(todosResult) }]
+              content: [{ type: "text", text: formatContent(todosWithHint) }]
             };
           }
           case "get_todo": {
@@ -21075,8 +21559,10 @@ ${formatContent(result)}`
               diagram_type: input.diagram_type,
               is_personal: input.is_personal
             });
+            const diagrams = diagramsResult?.data?.diagrams || diagramsResult?.diagrams || diagramsResult?.data?.items || diagramsResult?.items || [];
+            const diagramsWithHint = Array.isArray(diagrams) && diagrams.length === 0 ? { ...diagramsResult, hint: getEmptyStateHint("list_diagrams") } : diagramsResult;
             return {
-              content: [{ type: "text", text: formatContent(diagramsResult) }]
+              content: [{ type: "text", text: formatContent(diagramsWithHint) }]
             };
           }
           case "get_diagram": {
@@ -21149,8 +21635,10 @@ ${formatContent(result)}`
               doc_type: input.doc_type,
               is_personal: input.is_personal
             });
+            const docs = docsResult?.data?.docs || docsResult?.docs || docsResult?.data?.items || docsResult?.items || [];
+            const docsWithHint = Array.isArray(docs) && docs.length === 0 ? { ...docsResult, hint: getEmptyStateHint("list_docs") } : docsResult;
             return {
-              content: [{ type: "text", text: formatContent(docsResult) }]
+              content: [{ type: "text", text: formatContent(docsWithHint) }]
             };
           }
           case "get_doc": {
@@ -21381,6 +21869,54 @@ ${formatContent(result)}`
               ]
             };
           }
+          // Transcript actions
+          case "list_transcripts": {
+            const result = await client.listTranscripts({
+              workspace_id: workspaceId,
+              project_id: projectId,
+              session_id: input.session_id,
+              client_name: input.client_name,
+              started_after: input.started_after,
+              started_before: input.started_before,
+              limit: input.limit
+            });
+            const transcripts = result?.data?.items || result?.items || result?.data || [];
+            const resultWithHint = Array.isArray(transcripts) && transcripts.length === 0 ? { ...result, hint: "No transcripts found. Enable save_exchange in context() calls to save conversations." } : result;
+            return {
+              content: [{ type: "text", text: formatContent(resultWithHint) }]
+            };
+          }
+          case "get_transcript": {
+            if (!input.transcript_id) {
+              return errorResult("get_transcript requires: transcript_id");
+            }
+            const result = await client.getTranscript(input.transcript_id);
+            return {
+              content: [{ type: "text", text: formatContent(result) }]
+            };
+          }
+          case "search_transcripts": {
+            if (!input.query) {
+              return errorResult("search_transcripts requires: query");
+            }
+            const result = await client.searchTranscripts({
+              workspace_id: workspaceId,
+              query: input.query,
+              limit: input.limit
+            });
+            return {
+              content: [{ type: "text", text: formatContent(result) }]
+            };
+          }
+          case "delete_transcript": {
+            if (!input.transcript_id) {
+              return errorResult("delete_transcript requires: transcript_id");
+            }
+            const result = await client.deleteTranscript(input.transcript_id);
+            return {
+              content: [{ type: "text", text: formatContent(result) }]
+            };
+          }
           default:
             return errorResult(`Unknown action: ${input.action}`);
         }
@@ -22669,6 +23205,8 @@ Example workflow:
         const projectId = resolveProjectId(input.project_id);
         switch (input.action) {
           case "index": {
+            const indexGate = await gateIfProTool("media_index");
+            if (indexGate) return indexGate;
             if (!input.file_path && !input.external_url) {
               return errorResult("index requires: file_path or external_url");
             }
@@ -22833,6 +23371,8 @@ Created: ${content.created_at}`
             }
           }
           case "search": {
+            const searchGate = await gateIfProTool("media_search");
+            if (searchGate) return searchGate;
             if (!input.query) {
               return errorResult("search requires: query");
             }
@@ -23048,14 +23588,14 @@ Content ID: ${input.content_id}`
           // For editor_rules
           folder_path: external_exports.string().optional(),
           editors: external_exports.array(external_exports.string()).optional(),
-          mode: external_exports.enum(["minimal", "full"]).optional(),
+          mode: external_exports.enum(["minimal", "full", "bootstrap"]).optional(),
           dry_run: external_exports.boolean().optional(),
           workspace_id: external_exports.string().uuid().optional(),
           workspace_name: external_exports.string().optional(),
           project_name: external_exports.string().optional(),
           additional_rules: external_exports.string().optional(),
           install_hooks: external_exports.boolean().optional().describe("Install Claude Code hooks (PreToolUse, UserPromptSubmit, PostToolUse). Default: true for Claude users."),
-          include_pre_compact: external_exports.boolean().optional().describe("Include PreCompact hook for auto-saving state before compaction. Default: false."),
+          include_pre_compact: external_exports.boolean().optional().describe("Include PreCompact hook for auto-saving state before compaction. Default: true."),
           include_post_write: external_exports.boolean().optional().describe("Include PostToolUse hook for real-time file indexing after Edit/Write operations. Default: true."),
           // For enable_bundle
           bundle: external_exports.enum([
@@ -23112,7 +23652,7 @@ Each domain tool has an 'action' parameter for specific operations.` : "";
                   scope: input.folder_path ? "both" : "user",
                   projectPath: input.folder_path,
                   dryRun: input.dry_run,
-                  includePreCompact: input.include_pre_compact,
+                  includePreCompact: input.include_pre_compact !== false,
                   includePostWrite: input.include_post_write
                 });
               } catch (err) {
@@ -24053,6 +24593,7 @@ function registerPrompts(server) {
 }
 
 // src/session-manager.ts
+import { randomUUID as randomUUID2 } from "crypto";
 var SessionManager = class _SessionManager {
   constructor(server, client) {
     this.server = server;
@@ -24084,12 +24625,20 @@ var SessionManager = class _SessionManager {
     this.lastHighPressureAt = null;
     this.lastHighPressureTokens = 0;
     this.postCompactRestoreCompleted = false;
+    this.sessionId = `mcp-${randomUUID2()}`;
   }
   static {
     // Each conversation turn typically includes: user message (~500), AI response (~1500),
     // system prompt overhead (~500), and reasoning (~1500). Conservative estimate: 3000/turn
     this.TOKENS_PER_TURN_ESTIMATE = 3e3;
   }
+  /**
+   * Get the unique session ID for this MCP connection.
+   * Used for transcript saving and session association.
+   */
+  getSessionId() {
+    return this.sessionId;
+  }
   /**
    * Check if session has been auto-initialized
    */
@@ -24624,7 +25173,7 @@ var SessionManager = class _SessionManager {
 
 // src/http-gateway.ts
 import { createServer } from "node:http";
-import { randomUUID as randomUUID2 } from "node:crypto";
+import { randomUUID as randomUUID3 } from "node:crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 var HOST = process.env.MCP_HTTP_HOST || "0.0.0.0";
@@ -24801,7 +25350,7 @@ async function createSession() {
     registerPrompts(server);
   }
   const transport = new StreamableHTTPServerTransport({
-    sessionIdGenerator: () => randomUUID2(),
+    sessionIdGenerator: () => randomUUID3(),
     enableJsonResponse: ENABLE_JSON_RESPONSE,
     onsessionclosed: (sessionId) => {
       sessions.delete(sessionId);
@@ -25845,7 +26394,7 @@ Code: ${device.user_code}`);
         }
       }
     }
-    const mode = "dynamic";
+    const mode = "full";
     const detectedPlanName = await client.getPlanName();
     const detectedGraphTier = await client.getGraphTier();
     const graphTierLabel = detectedGraphTier === "full" ? "full graph" : detectedGraphTier === "lite" ? "graph-lite" : "none";