@contextstream/mcp-server 0.4.48 → 0.4.50

package/README.md

@@ -157,6 +157,33 @@ claude mcp update contextstream -e CONTEXTSTREAM_API_KEY=your_key
 
 </details>
 
+<details>
+<summary><b>GitHub Copilot CLI</b></summary>
+
+Use the Copilot CLI to interactively add the MCP server:
+
+```bash
+/mcp add
+```
+
+Or add to `~/.copilot/mcp-config.json`:
+
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "npx",
+      "args": ["-y", "@contextstream/mcp-server"],
+      "env": { "CONTEXTSTREAM_API_KEY": "your_key" }
+    }
+  }
+}
+```
+
+For more information, see the [GitHub Copilot CLI documentation](https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli).
+
+</details>
+
 ---
 
 ## Links

package/dist/hooks/auto-rules.js

@@ -105,7 +105,7 @@ function buildHooksConfig(options) {
     ],
     UserPromptSubmit: userPromptHooks
   };
-  if (options?.includePreCompact) {
+  if (options?.includePreCompact !== false) {
     config.PreCompact = [
       {
         // Match both manual (/compact) and automatic compaction
@@ -157,7 +157,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) {
@@ -203,7 +203,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) {
@@ -270,12 +270,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

package/dist/hooks/pre-compact.js

@@ -68,6 +68,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 = fs.readFileSync(transcriptPath, "utf-8");
     const lines = content.split("\n");
@@ -76,6 +79,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 || {};
@@ -91,11 +99,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 {
@@ -108,11 +145,57 @@ 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_KEY) {
+    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_URL}/api/v1/transcripts`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": API_KEY
+      },
+      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_KEY) {
     return { success: false, message: "No API key configured" };
@@ -193,13 +276,19 @@ async function runPreCompactHook() {
   }
   let autoSaveStatus = "";
   if (AUTO_SAVE && API_KEY) {
-    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";

package/dist/hooks/user-prompt-submit.js

@@ -2,11 +2,16 @@
 
 // src/hooks/user-prompt-submit.ts
 var ENABLED = process.env.CONTEXTSTREAM_REMINDER_ENABLED !== "false";
-var 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]`;
+var 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]`;
 function detectEditorFormat(input) {
   if (input.hookName !== void 0) {
     return "cline";