@contextstream/mcp-server 0.3.18 → 0.3.19

package/dist/index.js

@@ -5431,6 +5431,17 @@ var ContextStreamClient = class {
   // ============================================
   // Token-Saving Context Tools
   // ============================================
+  /**
+   * Record a token savings event for user-facing dashboard analytics.
+   * Best-effort: callers should not await this in latency-sensitive paths.
+   */
+  trackTokenSavings(body) {
+    const payload = this.withDefaults({
+      source: "mcp",
+      ...body
+    });
+    return request(this.config, "/analytics/token-savings", { body: payload });
+  }
   /**
    * Get a compact, token-efficient summary of workspace context.
    * Designed to be included in every AI prompt without consuming many tokens.
@@ -5519,7 +5530,31 @@ var ContextStreamClient = class {
     }
     parts.push("");
     parts.push('\u{1F4A1} Use session_recall("topic") for specific context');
-    const summary = parts.join("\n");
+    const candidateSummary = parts.join("\n");
+    const maxChars = maxTokens * 4;
+    const candidateLines = candidateSummary.split("\n");
+    const finalLines = [];
+    let used = 0;
+    for (const line of candidateLines) {
+      const next = (finalLines.length ? "\n" : "") + line;
+      if (used + next.length > maxChars) break;
+      finalLines.push(line);
+      used += next.length;
+    }
+    const summary = finalLines.join("\n");
+    this.trackTokenSavings({
+      tool: "session_summary",
+      workspace_id: withDefaults.workspace_id,
+      project_id: withDefaults.project_id,
+      candidate_chars: candidateSummary.length,
+      context_chars: summary.length,
+      max_tokens: maxTokens,
+      metadata: {
+        decision_count: decisionCount,
+        memory_count: memoryCount
+      }
+    }).catch(() => {
+    });
     return {
       summary,
       workspace_name: workspaceName,
@@ -5654,6 +5689,7 @@ var ContextStreamClient = class {
     const charsPerToken = 4;
     const maxChars = maxTokens * charsPerToken;
     const parts = [];
+    const candidateParts = [];
     const sources = [];
     let currentChars = 0;
     if (params.include_decisions !== false && withDefaults.workspace_id) {
@@ -5665,14 +5701,22 @@ var ContextStreamClient = class {
         });
         if (decisions.items) {
           parts.push("## Relevant Decisions\n");
+          candidateParts.push("## Relevant Decisions\n");
           currentChars += 25;
-          for (const d of decisions.items) {
-            const entry = `\u2022 ${d.title || "Decision"}
-`;
-            if (currentChars + entry.length > maxChars * 0.4) break;
-            parts.push(entry);
-            currentChars += entry.length;
-            sources.push({ type: "decision", title: d.title || "Decision" });
+          const decisionEntries = decisions.items.map((d) => {
+            const title = d.title || "Decision";
+            return { title, entry: `\u2022 ${title}
+` };
+          });
+          for (const d of decisionEntries) {
+            candidateParts.push(d.entry);
+          }
+          candidateParts.push("\n");
+          for (const d of decisionEntries) {
+            if (currentChars + d.entry.length > maxChars * 0.4) break;
+            parts.push(d.entry);
+            currentChars += d.entry.length;
+            sources.push({ type: "decision", title: d.title });
           }
           parts.push("\n");
         }
@@ -5689,16 +5733,23 @@ var ContextStreamClient = class {
         });
         if (memory.results) {
           parts.push("## Related Context\n");
+          candidateParts.push("## Related Context\n");
           currentChars += 20;
-          for (const m of memory.results) {
+          const memoryEntries = memory.results.map((m) => {
             const title = m.title || "Context";
             const content = m.content?.slice(0, 200) || "";
-            const entry = `\u2022 ${title}: ${content}...
-`;
-            if (currentChars + entry.length > maxChars * 0.7) break;
-            parts.push(entry);
-            currentChars += entry.length;
-            sources.push({ type: "memory", title });
+            return { title, entry: `\u2022 ${title}: ${content}...
+` };
+          });
+          for (const m of memoryEntries) {
+            candidateParts.push(m.entry);
+          }
+          candidateParts.push("\n");
+          for (const m of memoryEntries) {
+            if (currentChars + m.entry.length > maxChars * 0.7) break;
+            parts.push(m.entry);
+            currentChars += m.entry.length;
+            sources.push({ type: "memory", title: m.title });
           }
           parts.push("\n");
         }
@@ -5715,23 +5766,45 @@ var ContextStreamClient = class {
         });
         if (code.results) {
           parts.push("## Relevant Code\n");
+          candidateParts.push("## Relevant Code\n");
           currentChars += 18;
-          for (const c of code.results) {
+          const codeEntries = code.results.map((c) => {
             const path3 = c.file_path || "file";
             const content = c.content?.slice(0, 150) || "";
-            const entry = `\u2022 ${path3}: ${content}...
-`;
-            if (currentChars + entry.length > maxChars) break;
-            parts.push(entry);
-            currentChars += entry.length;
-            sources.push({ type: "code", title: path3 });
+            return { path: path3, entry: `\u2022 ${path3}: ${content}...
+` };
+          });
+          for (const c of codeEntries) {
+            candidateParts.push(c.entry);
+          }
+          for (const c of codeEntries) {
+            if (currentChars + c.entry.length > maxChars) break;
+            parts.push(c.entry);
+            currentChars += c.entry.length;
+            sources.push({ type: "code", title: c.path });
           }
         }
       } catch {
       }
     }
     const context = parts.join("");
+    const candidateContext = candidateParts.join("");
     const tokenEstimate = Math.ceil(context.length / charsPerToken);
+    this.trackTokenSavings({
+      tool: "ai_context_budget",
+      workspace_id: withDefaults.workspace_id,
+      project_id: withDefaults.project_id,
+      candidate_chars: candidateContext.length,
+      context_chars: context.length,
+      max_tokens: maxTokens,
+      metadata: {
+        include_decisions: params.include_decisions !== false,
+        include_memory: params.include_memory !== false,
+        include_code: !!params.include_code,
+        sources: sources.length
+      }
+    }).catch(() => {
+    });
     return {
       context,
       token_estimate: tokenEstimate,
@@ -5908,6 +5981,7 @@ var ContextStreamClient = class {
     let context;
     let charsUsed = 0;
     const maxChars = maxTokens * 4;
+    let candidateContext;
     if (format === "minified") {
       const parts = [];
       for (const item of items) {
@@ -5917,6 +5991,7 @@ var ContextStreamClient = class {
         charsUsed += entry.length + 1;
       }
       context = parts.join("|");
+      candidateContext = items.map((i) => `${i.type}:${i.value}`).join("|");
     } else if (format === "structured") {
       const grouped = {};
       for (const item of items) {
@@ -5926,6 +6001,12 @@ var ContextStreamClient = class {
         charsUsed += item.value.length + 5;
       }
       context = JSON.stringify(grouped);
+      const candidateGrouped = {};
+      for (const item of items) {
+        if (!candidateGrouped[item.type]) candidateGrouped[item.type] = [];
+        candidateGrouped[item.type].push(item.value);
+      }
+      candidateContext = JSON.stringify(candidateGrouped);
     } else {
       const lines = ["[CTX]"];
       for (const item of items) {
@@ -5936,6 +6017,12 @@ var ContextStreamClient = class {
       }
       lines.push("[/CTX]");
       context = lines.join("\n");
+      const candidateLines = ["[CTX]"];
+      for (const item of items) {
+        candidateLines.push(`${item.type}:${item.value}`);
+      }
+      candidateLines.push("[/CTX]");
+      candidateContext = candidateLines.join("\n");
     }
     if (context.length === 0 && withDefaults.workspace_id) {
       const wsHint = items.find((i) => i.type === "W")?.value || withDefaults.workspace_id.slice(0, 8);
@@ -5943,7 +6030,23 @@ var ContextStreamClient = class {
 W:${wsHint}
 [NO_MATCHES]
 [/CTX]`;
+      candidateContext = context;
     }
+    this.trackTokenSavings({
+      tool: "context_smart",
+      workspace_id: withDefaults.workspace_id,
+      project_id: withDefaults.project_id,
+      candidate_chars: candidateContext.length,
+      context_chars: context.length,
+      max_tokens: maxTokens,
+      metadata: {
+        format,
+        items: items.length,
+        keywords: keywords.slice(0, 10),
+        errors: errors.length
+      }
+    }).catch(() => {
+    });
     return {
       context,
       token_estimate: Math.ceil(context.length / 4),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.3.18",
+  "version": "0.3.19",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",