@contextstream/mcp-server 0.4.73 → 0.4.74

package/dist/index.js

@@ -16121,13 +16121,15 @@ var ContextStreamClient = class _ContextStreamClient {
         for (const item of memory.items) {
           const createdAt = item.created_at || "";
           if (createdAt > params.since) {
-            const type = item.metadata?.original_type || "memory";
+            const isDecision = isDecisionResult(item);
+            const isLesson = isLessonResult(item);
+            const type = isDecision ? "decision" : isLesson ? "lesson" : extractEffectiveEventType(item);
             items.push({
               type,
               title: item.title || "Untitled",
               created_at: createdAt
             });
-            if (type === "decision") newDecisions++;
+            if (isDecision) newDecisions++;
             else newMemory++;
           }
         }
@@ -16573,10 +16575,33 @@ ${context}`;
   }
   /**
    * Get high-priority lessons that should be surfaced proactively.
-   * Returns critical and high severity lessons for warnings.
+   * Returns lessons found via semantic search, with event listing fallback.
    */
   async getHighPriorityLessons(params) {
     const limit = params.limit || 5;
+    const mapLesson = (item) => {
+      const tags = extractEventTags(item);
+      const severityTag = tags.find((t) => t.startsWith("severity:"));
+      const severity = severityTag?.split(":")[1] || item.metadata?.importance || "medium";
+      const category = tags.find(
+        (t) => [
+          "workflow",
+          "code_quality",
+          "verification",
+          "communication",
+          "project_specific"
+        ].includes(t)
+      ) || "unknown";
+      const content = item.content || "";
+      const preventionMatch = content.match(/### Prevention\n([\s\S]*?)(?:\n\n|\n\*\*|$)/);
+      const prevention = preventionMatch?.[1]?.trim() || content.slice(0, 1e3);
+      return {
+        title: item.title || "Lesson",
+        severity,
+        category,
+        prevention
+      };
+    };
     try {
       const searchQuery = params.context_hint ? `${params.context_hint} lesson warning prevention mistake` : "lesson warning prevention mistake critical high";
       const searchResult = await this.memorySearch({
@@ -16584,39 +16609,20 @@ ${context}`;
         workspace_id: params.workspace_id,
         project_id: params.project_id,
         limit: limit * 2
-        // Fetch more to filter
       });
-      if (!searchResult?.results) return [];
-      const lessons = searchResult.results.filter((item) => {
-        if (!isLessonResult(item)) return false;
-        const tags = extractEventTags(item);
-        const severityTag = tags.find((t) => t.startsWith("severity:"));
-        const severity = severityTag?.split(":")[1] || item.metadata?.importance || "medium";
-        return severity === "critical" || severity === "high";
-      }).slice(0, limit).map((item) => {
-        const tags = extractEventTags(item);
-        const severityTag = tags.find((t) => t.startsWith("severity:"));
-        const severity = severityTag?.split(":")[1] || item.metadata?.importance || "medium";
-        const category = tags.find(
-          (t) => [
-            "workflow",
-            "code_quality",
-            "verification",
-            "communication",
-            "project_specific"
-          ].includes(t)
-        ) || "unknown";
-        const content = item.content || "";
-        const preventionMatch = content.match(/### Prevention\n([\s\S]*?)(?:\n\n|\n\*\*|$)/);
-        const prevention = preventionMatch?.[1]?.trim() || content.slice(0, 1e3);
-        return {
-          title: item.title || "Lesson",
-          severity,
-          category,
-          prevention
-        };
+      if (searchResult?.results) {
+        const lessons = searchResult.results.filter((item) => isLessonResult(item)).slice(0, limit).map(mapLesson);
+        if (lessons.length > 0) return lessons;
+      }
+      const eventResult = await this.listMemoryEvents({
+        workspace_id: params.workspace_id,
+        event_type: "lesson",
+        limit: limit * 2
       });
-      return lessons;
+      if (eventResult?.items) {
+        return eventResult.items.filter((item) => isLessonResult(item)).slice(0, limit).map(mapLesson);
+      }
+      return [];
     } catch {
       return [];
     }
@@ -18731,6 +18737,24 @@ var HotPathStore = class {
 var globalHotPathStore = new HotPathStore();
 
 // src/tools.ts
+function stringOrArray(itemSchema) {
+  return external_exports.union([
+    external_exports.array(itemSchema),
+    external_exports.string().transform((val, ctx) => {
+      try {
+        const parsed = JSON.parse(val);
+        if (!Array.isArray(parsed)) {
+          ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "Expected array or JSON string of array" });
+          return external_exports.NEVER;
+        }
+        return parsed;
+      } catch {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "Invalid JSON string for array parameter" });
+        return external_exports.NEVER;
+      }
+    })
+  ]);
+}
 var execFileAsync = promisify2(execFile);
 function parseBoolEnvDefault(raw, fallback) {
   if (raw === void 0) return fallback;
@@ -22100,7 +22124,7 @@ ${formatContent(result)}`
     ).optional().describe("Entries to push (for push)"),
     increment_turn: external_exports.boolean().optional().describe("Increment turn counter (for push)"),
     force_version_bump: external_exports.boolean().optional().describe("Force version bump even with no new entries (for push)"),
-    ids: external_exports.array(external_exports.string()).optional().describe("Entry IDs to acknowledge (for ack)"),
+    ids: stringOrArray(external_exports.string()).optional().describe("Entry IDs to acknowledge (for ack)"),
     expected_version: external_exports.number().optional().describe("Expected version for checkpoint verify")
   });
   const instructionToolDescription = "Session-scoped instruction cache operations. Actions: bootstrap, get, push, ack, clear, stats, checkpoint, verify.";
@@ -23074,9 +23098,9 @@ Actions:
         title: external_exports.string().optional().describe("Skill display title"),
         description: external_exports.string().optional().describe("Skill description"),
         instruction_body: external_exports.string().optional().describe("Markdown instruction text (the prompt)"),
-        trigger_patterns: external_exports.array(external_exports.string()).optional().describe("Keywords/phrases for auto-activation"),
+        trigger_patterns: stringOrArray(external_exports.string()).optional().describe("Keywords/phrases for auto-activation"),
         trigger_regex: external_exports.string().optional().describe("Optional regex for advanced trigger matching"),
-        categories: external_exports.array(external_exports.string()).optional().describe("Tags for discovery/filtering"),
+        categories: stringOrArray(external_exports.string()).optional().describe("Tags for discovery/filtering"),
         actions: external_exports.any().optional().describe("Action steps array [{type, tool, params, ...}]"),
         params: external_exports.any().optional().describe("Parameters passed to skill execution"),
         dry_run: external_exports.boolean().optional().describe("Preview execution without running"),
@@ -23089,7 +23113,7 @@ Actions:
         format: external_exports.enum(["auto", "json", "markdown", "skills_md", "cursorrules", "claude_md", "aider", "zip"]).optional().describe("Import/export format"),
         source_tool: external_exports.string().optional().describe("Source tool name (for import provenance)"),
         source_file: external_exports.string().optional().describe("Source filename (for import provenance)"),
-        skill_ids: external_exports.array(external_exports.string()).optional().describe("Skill IDs for export"),
+        skill_ids: stringOrArray(external_exports.string()).optional().describe("Skill IDs for export"),
         change_summary: external_exports.string().optional().describe("Summary of changes (for version history)"),
         workspace_id: external_exports.string().optional().describe("Workspace ID (UUID)"),
         project_id: external_exports.string().optional().describe("Project ID (UUID)"),
@@ -23250,7 +23274,7 @@ Actions:
         workspace_id: external_exports.string().uuid().optional(),
         project_id: external_exports.string().uuid().optional(),
         limit: external_exports.number().optional(),
-        tags: external_exports.array(external_exports.string()).optional().describe("Filter events that contain ALL of these tags"),
+        tags: stringOrArray(external_exports.string()).optional().describe("Filter events that contain ALL of these tags"),
         event_type: external_exports.string().optional().describe("Filter by event type (e.g. decision, lesson, manual_note)")
       })
     },
@@ -23322,7 +23346,7 @@ Actions:
         workspace_id: external_exports.string().uuid().optional(),
         project_id: external_exports.string().uuid().optional(),
         limit: external_exports.number().optional(),
-        tags: external_exports.array(external_exports.string()).optional().describe("Filter results that contain ALL of these tags")
+        tags: stringOrArray(external_exports.string()).optional().describe("Filter results that contain ALL of these tags")
       })
     },
     async (input) => {
@@ -24708,7 +24732,7 @@ Use this to persist decisions, insights, preferences, or important information.`
         ]).describe("Type of context being captured"),
         title: external_exports.string().describe("Brief title for the captured context"),
         content: external_exports.string().describe("Full content/details to capture"),
-        tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
+        tags: stringOrArray(external_exports.string()).optional().describe("Tags for categorization"),
         importance: external_exports.enum(["low", "medium", "high", "critical"]).optional().describe("Importance level"),
         provenance: external_exports.object({
           repo: external_exports.string().optional(),
@@ -25686,7 +25710,7 @@ After compression, the AI can use session_recall to retrieve this context in fut
         project_id: external_exports.string().uuid().optional(),
         title: external_exports.string(),
         description: external_exports.string().optional(),
-        goals: external_exports.array(external_exports.string()).optional(),
+        goals: stringOrArray(external_exports.string()).optional(),
         steps: external_exports.array(
           external_exports.object({
             id: external_exports.string(),
@@ -25697,7 +25721,7 @@ After compression, the AI can use session_recall to retrieve this context in fut
           })
         ).optional(),
         status: external_exports.enum(["draft", "active", "completed", "archived", "abandoned"]).optional(),
-        tags: external_exports.array(external_exports.string()).optional(),
+        tags: stringOrArray(external_exports.string()).optional(),
         due_at: external_exports.string().optional(),
         is_personal: external_exports.boolean().optional()
       })
@@ -25735,7 +25759,7 @@ After compression, the AI can use session_recall to retrieve this context in fut
         plan_id: external_exports.string().uuid(),
         title: external_exports.string().optional(),
         description: external_exports.string().optional(),
-        goals: external_exports.array(external_exports.string()).optional(),
+        goals: stringOrArray(external_exports.string()).optional(),
         status: external_exports.enum(["draft", "active", "completed", "archived", "abandoned"]).optional()
       })
     },
@@ -26975,7 +26999,7 @@ Example prompts:
         workspace_id: external_exports.string().uuid().optional(),
         query: external_exports.string().describe("Search query"),
         limit: external_exports.number().optional().describe("Maximum results (default: 20)"),
-        sources: external_exports.array(external_exports.string()).optional().describe("Filter by source: github, slack"),
+        sources: stringOrArray(external_exports.string()).optional().describe("Filter by source: github, slack"),
         days: external_exports.number().optional().describe("Filter to results within N days"),
         sort_by: external_exports.enum(["relevance", "recent", "engagement"]).optional().describe("Sort by: relevance, recent, or engagement")
       })
@@ -27049,7 +27073,7 @@ Example prompts:
         workspace_id: external_exports.string().uuid().optional(),
         knowledge_type: external_exports.enum(["decision", "lesson", "fact", "insight"]).optional().describe("Filter by knowledge type"),
         query: external_exports.string().optional().describe("Optional search query to filter knowledge"),
-        sources: external_exports.array(external_exports.string()).optional().describe("Filter by source: github, slack"),
+        sources: stringOrArray(external_exports.string()).optional().describe("Filter by source: github, slack"),
         limit: external_exports.number().optional().describe("Maximum items to return (default: 20)")
       })
     },
@@ -27214,7 +27238,7 @@ Example: Create a reminder to "Review PR #123" for tomorrow at 10am with high pr
         content: external_exports.string().describe("Reminder details/description"),
         remind_at: external_exports.string().describe('When to remind (ISO 8601 datetime, e.g., "2025-01-15T10:00:00Z")'),
         priority: external_exports.enum(["low", "normal", "high", "urgent"]).optional().describe("Priority level (default: normal)"),
-        keywords: external_exports.array(external_exports.string()).optional().describe("Keywords for contextual surfacing"),
+        keywords: stringOrArray(external_exports.string()).optional().describe("Keywords for contextual surfacing"),
         recurrence: external_exports.enum(["daily", "weekly", "monthly"]).optional().describe("Recurrence pattern")
       })
     },
@@ -28045,14 +28069,14 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
             "session_snapshot"
           ]).optional().describe("Event type for capture"),
           importance: external_exports.enum(["low", "medium", "high", "critical"]).optional(),
-          tags: external_exports.array(external_exports.string()).optional(),
+          tags: stringOrArray(external_exports.string()).optional(),
           // Lesson-specific
           category: external_exports.enum(["workflow", "code_quality", "verification", "communication", "project_specific"]).optional(),
           trigger: external_exports.string().optional().describe("What caused the problem"),
           impact: external_exports.string().optional().describe("What went wrong"),
           prevention: external_exports.string().optional().describe("How to prevent in future"),
           severity: external_exports.enum(["low", "medium", "high", "critical"]).optional(),
-          keywords: external_exports.array(external_exports.string()).optional(),
+          keywords: stringOrArray(external_exports.string()).optional(),
           // Other params
           since: external_exports.string().optional().describe("ISO timestamp for delta"),
           limit: external_exports.number().optional(),
@@ -28079,7 +28103,7 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
           // Plan-specific params
           plan_id: external_exports.string().uuid().optional().describe("Plan ID for get_plan/update_plan"),
           description: external_exports.string().optional().describe("Description for capture_plan"),
-          goals: external_exports.array(external_exports.string()).optional().describe("Goals for capture_plan"),
+          goals: stringOrArray(external_exports.string()).optional().describe("Goals for capture_plan"),
           steps: external_exports.array(
             external_exports.object({
               id: external_exports.string(),
@@ -28100,7 +28124,7 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
           // 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_keywords: stringOrArray(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")
         })
@@ -28201,7 +28225,7 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
               context_hint: input.query,
               limit: input.limit
             });
-            let lessons = result?.data?.lessons || result?.lessons || [];
+            let lessons = Array.isArray(result) ? result : result?.data?.lessons || result?.lessons || [];
             if (Array.isArray(lessons) && lessons.length > 1) {
               const seen = /* @__PURE__ */ new Set();
               lessons = lessons.filter((lesson) => {
@@ -28210,10 +28234,8 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
                 seen.add(key);
                 return true;
               });
-              if (result?.data?.lessons) result.data.lessons = lessons;
-              else if (result?.lessons) result.lessons = lessons;
             }
-            const resultWithHint = Array.isArray(lessons) && lessons.length === 0 ? { ...result, hint: getEmptyStateHint("get_lessons") } : result;
+            const resultWithHint = Array.isArray(lessons) && lessons.length === 0 ? { lessons: [], hint: getEmptyStateHint("get_lessons") } : { lessons };
             return {
               content: [{ type: "text", text: formatContent(resultWithHint) }]
             };
@@ -28364,6 +28386,20 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
             if (!input.query) {
               return errorResult("decision_trace requires: query");
             }
+            const doFallback = async () => {
+              const events = await client.listMemoryEvents({
+                workspace_id: workspaceId,
+                project_id: projectId,
+                limit: 50
+              }).catch(() => ({ items: [] }));
+              const decisions = (events?.items || []).filter((item) => isDecisionResult(item));
+              const queryLower = (input.query || "").toLowerCase();
+              const matched = decisions.filter((d) => {
+                const text = `${d.title || ""} ${d.content || ""}`.toLowerCase();
+                return queryLower.split(/\s+/).some((w) => w.length > 2 && text.includes(w));
+              }).slice(0, input.limit || 10);
+              return matched;
+            };
             try {
               const result = await client.decisionTrace({
                 workspace_id: workspaceId,
@@ -28372,23 +28408,30 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
                 include_impact: input.include_impact,
                 limit: input.limit
               });
+              const resultDecisions = result?.decisions || result?.data?.decisions || [];
+              if (Array.isArray(resultDecisions) && resultDecisions.length === 0) {
+                const fallbackDecisions = await doFallback();
+                if (fallbackDecisions.length > 0) {
+                  return {
+                    content: [{
+                      type: "text",
+                      text: formatContent({
+                        decisions: fallbackDecisions,
+                        total: fallbackDecisions.length,
+                        fallback_reason: "api_empty_result",
+                        hint: "Decision trace used event listing fallback because the API returned no results."
+                      })
+                    }]
+                  };
+                }
+              }
               return {
                 content: [{ type: "text", text: formatContent(result) }]
               };
             } catch (err) {
               const isTimeout = err?.message?.toLowerCase().includes("timeout") || err?.message?.toLowerCase().includes("embedding timed out");
               if (!isTimeout) throw err;
-              const events = await client.listMemoryEvents({
-                workspace_id: workspaceId,
-                project_id: projectId,
-                limit: 50
-              }).catch(() => ({ items: [] }));
-              const decisions = (events?.items || []).filter((item) => isDecisionResult(item));
-              const queryLower = input.query.toLowerCase();
-              const matched = decisions.filter((d) => {
-                const text = `${d.title || ""} ${d.content || ""}`.toLowerCase();
-                return queryLower.split(/\s+/).some((w) => w.length > 2 && text.includes(w));
-              }).slice(0, input.limit || 10);
+              const matched = await doFallback();
               return {
                 content: [{
                   type: "text",
@@ -28946,9 +28989,9 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
           status: external_exports.enum(["pending", "in_progress", "completed", "blocked", "cancelled"]).optional().describe("Backward-compatible alias for task_status in task actions"),
           priority: external_exports.enum(["low", "medium", "high", "urgent"]).optional().describe("Task priority"),
           order: external_exports.number().optional().describe("Task order within plan"),
-          task_ids: external_exports.array(external_exports.string().uuid()).optional().describe("Task IDs for reorder_tasks"),
+          task_ids: stringOrArray(external_exports.string().uuid()).optional().describe("Task IDs for reorder_tasks"),
           blocked_reason: external_exports.string().optional().describe("Reason when task is blocked"),
-          tags: external_exports.array(external_exports.string()).optional().describe("Tags for event or task categorization"),
+          tags: stringOrArray(external_exports.string()).optional().describe("Tags for event or task categorization"),
           // Batch import params
           events: external_exports.array(
             external_exports.object({
@@ -28971,7 +29014,7 @@ Output formats: full (default, includes content), paths (file paths only - 80% t
                   symbol_name: external_exports.string().optional()
                 })
               ).optional(),
-              tags: external_exports.array(external_exports.string()).optional(),
+              tags: stringOrArray(external_exports.string()).optional(),
               occurred_at: external_exports.string().optional().describe("ISO timestamp for when the event occurred")
             })
           ).optional().describe("Array of events for import_batch action"),
@@ -30685,7 +30728,7 @@ Uncommitted changes: ${changes.diff_stat.summary}
           // Index settings params (for update)
           branch_policy: external_exports.enum(["default_branch_wins", "newest_wins", "feature_branch_wins"]).optional().describe("Which branch takes priority: default_branch_wins (default), newest_wins, feature_branch_wins"),
           conflict_resolution: external_exports.enum(["newest_timestamp", "default_branch", "manual"]).optional().describe("How to resolve conflicts: newest_timestamp (default), default_branch, manual"),
-          allowed_machines: external_exports.array(external_exports.string()).optional().describe("List of allowed machine IDs (empty = all allowed)"),
+          allowed_machines: stringOrArray(external_exports.string()).optional().describe("List of allowed machine IDs (empty = all allowed)"),
           auto_sync_enabled: external_exports.boolean().optional().describe("Whether to auto-sync from all machines (default: true)"),
           max_machines: external_exports.number().optional().describe("Maximum machines allowed to index (0 = unlimited)"),
           // Pagination
@@ -30864,7 +30907,7 @@ Uncommitted changes: ${changes.diff_stat.summary}
           remind_at: external_exports.string().optional().describe("ISO 8601 datetime"),
           priority: external_exports.enum(["low", "normal", "high", "urgent"]).optional(),
           recurrence: external_exports.enum(["daily", "weekly", "monthly"]).optional(),
-          keywords: external_exports.array(external_exports.string()).optional(),
+          keywords: stringOrArray(external_exports.string()).optional(),
           // Snooze params
           until: external_exports.string().optional().describe("ISO 8601 datetime"),
           // Filter params
@@ -31608,7 +31651,7 @@ Example workflow:
           ),
           fps: external_exports.number().optional().describe("Frames per second for remotion format (default: 30)"),
           // Common params
-          tags: external_exports.array(external_exports.string()).optional().describe("Tags to associate with media"),
+          tags: stringOrArray(external_exports.string()).optional().describe("Tags to associate with media"),
           limit: external_exports.number().optional().describe("Maximum results to return")
         })
       },
@@ -32007,7 +32050,7 @@ Content ID: ${input.content_id}`
           category: external_exports.string().optional(),
           // For editor_rules
           folder_path: external_exports.string().optional(),
-          editors: external_exports.array(external_exports.string()).optional(),
+          editors: stringOrArray(external_exports.string()).optional(),
           mode: external_exports.enum(["minimal", "full", "bootstrap"]).optional(),
           dry_run: external_exports.boolean().optional(),
           workspace_id: external_exports.string().uuid().optional(),
@@ -32182,7 +32225,7 @@ Remote API actions: list_repos, get_repo, sync_repo, list_pulls, get_pull, get_p
         title: external_exports.string().optional().describe("Title for create_issue"),
         body: external_exports.string().optional().describe("Body content"),
         state: external_exports.string().optional().describe("State filter (open/closed)"),
-        labels: external_exports.array(external_exports.string()).optional().describe("Labels for issues"),
+        labels: stringOrArray(external_exports.string()).optional().describe("Labels for issues"),
         per_page: external_exports.number().optional().describe("Results per page"),
         page: external_exports.number().optional().describe("Page number"),
         event: external_exports.string().optional().describe("Review event (APPROVE/REQUEST_CHANGES/COMMENT)"),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.73",
+  "version": "0.4.74",
   "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
   "type": "module",
   "license": "MIT",