@crowley/rag-mcp 1.0.0

package/dist/tools/session.js

@@ -0,0 +1,386 @@
+/**
+ * Session tools module - context summarization, session lifecycle management,
+ * change tracking, and usage pattern analysis.
+ */
+import { truncate } from "../formatters.js";
+/**
+ * Create the session tools module with project-specific descriptions.
+ * Accepts a mutable ctx reference to update activeSessionId on start/end.
+ */
+export function createSessionTools(projectName, sharedCtx) {
+    const tools = [
+        {
+            name: "summarize_context",
+            description: `Summarize the current working context for ${projectName}. Shows recently used tools, active features, recent queries, and suggested next steps.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sessionId: {
+                        type: "string",
+                        description: "Session ID to get context for. If omitted, returns the latest context.",
+                    },
+                },
+            },
+        },
+        {
+            name: "summarize_changes",
+            description: `Summarize changes made during a session for ${projectName}. Shows what was modified, tools used, and key actions taken.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sessionId: {
+                        type: "string",
+                        description: "Session ID to summarize changes for.",
+                    },
+                    includeCode: {
+                        type: "boolean",
+                        description: "Whether to include code snippets in the summary (default: false).",
+                        default: false,
+                    },
+                },
+                required: ["sessionId"],
+            },
+        },
+        {
+            name: "analyze_usage_patterns",
+            description: `Analyze tool usage patterns for ${projectName}. Shows common workflows, detected patterns, and recommendations for improving productivity.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    days: {
+                        type: "number",
+                        description: "Number of days to analyze (default: 7).",
+                        default: 7,
+                    },
+                },
+            },
+        },
+        {
+            name: "get_developer_profile",
+            description: `Get accumulated developer profile for ${projectName}: frequent files, preferred tools, peak hours, common patterns.`,
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
+        {
+            name: "start_session",
+            description: `Start a new working session for ${projectName}. Tracks tool usage, file changes, and learnings throughout the session.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sessionId: {
+                        type: "string",
+                        description: "Custom session ID. If omitted, one will be generated.",
+                    },
+                    initialContext: {
+                        type: "string",
+                        description: "Description of what this session is about (e.g., 'fixing auth bug', 'adding new API endpoint').",
+                    },
+                    resumeFrom: {
+                        type: "string",
+                        description: "Session ID to resume from. Carries over context from the previous session.",
+                    },
+                },
+            },
+        },
+        {
+            name: "get_session_context",
+            description: `Get the current context for an active session in ${projectName}. Shows files being worked on, tools used, and pending learnings.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sessionId: {
+                        type: "string",
+                        description: "Session ID to get context for.",
+                    },
+                },
+                required: ["sessionId"],
+            },
+        },
+        {
+            name: "end_session",
+            description: `End a working session for ${projectName}. Saves a summary and optionally extracts learnings for future sessions.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sessionId: {
+                        type: "string",
+                        description: "Session ID to end.",
+                    },
+                    summary: {
+                        type: "string",
+                        description: "Summary of what was accomplished during the session.",
+                    },
+                    autoSaveLearnings: {
+                        type: "boolean",
+                        description: "Automatically save detected learnings to memory (default: true).",
+                        default: true,
+                    },
+                    feedback: {
+                        type: "string",
+                        description: "Optional feedback about the session (e.g., 'productive', 'too many context switches').",
+                    },
+                },
+                required: ["sessionId"],
+            },
+        },
+    ];
+    const handlers = {
+        summarize_context: async (args, ctx) => {
+            const { sessionId } = args;
+            const params = sessionId ? `?sessionId=${sessionId}` : "";
+            const response = await ctx.api.get(`/api/context/${ctx.projectName}${params}`);
+            const data = response.data;
+            let result = `**Context Summary for ${ctx.projectName}**\n\n`;
+            if (data.recentTools && data.recentTools.length > 0) {
+                result += `**Recently Used Tools:**\n`;
+                result += data.recentTools
+                    .map((t) => `- ${t}`)
+                    .join("\n");
+                result += "\n\n";
+            }
+            if (data.activeFeatures && data.activeFeatures.length > 0) {
+                result += `**Active Features:**\n`;
+                result += data.activeFeatures
+                    .map((f) => `- ${f}`)
+                    .join("\n");
+                result += "\n\n";
+            }
+            if (data.recentQueries && data.recentQueries.length > 0) {
+                const queries = data.recentQueries.slice(0, 5);
+                result += `**Recent Queries:**\n`;
+                result += queries
+                    .map((q) => `- ${truncate(q, 80)}`)
+                    .join("\n");
+                result += "\n\n";
+            }
+            if (data.suggestedNextSteps && data.suggestedNextSteps.length > 0) {
+                result += `**Suggested Next Steps:**\n`;
+                result += data.suggestedNextSteps
+                    .map((s, i) => `${i + 1}. ${s}`)
+                    .join("\n");
+                result += "\n";
+            }
+            return result;
+        },
+        summarize_changes: async (args, ctx) => {
+            const { sessionId, includeCode } = args;
+            const params = includeCode ? "?includeCode=true" : "";
+            const response = await ctx.api.get(`/api/changes/${ctx.projectName}/${sessionId}${params}`);
+            const data = response.data;
+            let result = `**Changes Summary for Session ${sessionId}**\n\n`;
+            if (data.summary) {
+                result += `${data.summary}\n\n`;
+            }
+            if (data.duration !== undefined) {
+                result += `**Duration:** ${data.duration} minutes\n`;
+            }
+            if (data.toolsUsed && data.toolsUsed.length > 0) {
+                result += `**Tools Used:** ${data.toolsUsed.join(", ")}\n`;
+            }
+            if (data.filesAffected && data.filesAffected.length > 0) {
+                const files = data.filesAffected.slice(0, 10);
+                result += `\n**Files Affected:**\n`;
+                result += files.map((f) => `- ${f}`).join("\n");
+                if (data.filesAffected.length > 10) {
+                    result += `\n- ... and ${data.filesAffected.length - 10} more`;
+                }
+                result += "\n";
+            }
+            if (data.keyActions && data.keyActions.length > 0) {
+                result += `\n**Key Actions:**\n`;
+                result += data.keyActions
+                    .map((a, i) => `${i + 1}. ${a}`)
+                    .join("\n");
+                result += "\n";
+            }
+            return result;
+        },
+        get_developer_profile: async (_args, ctx) => {
+            const response = await ctx.api.get(`/api/developer-profile`, { headers: { "X-Project-Name": ctx.projectName } });
+            const p = response.data;
+            if (!p.totalToolCalls) {
+                return "No usage data yet. Use tools to build your developer profile.";
+            }
+            let result = `**Developer Profile** (${p.totalSessions} sessions, ${p.totalToolCalls} tool calls)\n\n`;
+            if (p.frequentFiles.length > 0) {
+                result += "**Frequent Files:**\n";
+                result += p.frequentFiles.slice(0, 10).map((f) => `- ${f.file} (${f.count}x)`).join("\n");
+                result += "\n\n";
+            }
+            if (p.preferredTools.length > 0) {
+                result += "**Preferred Tools:**\n";
+                result += p.preferredTools.slice(0, 8).map((t) => `- ${t.tool}: ${t.count}x (avg ${Math.round(t.avgDurationMs)}ms)`).join("\n");
+                result += "\n\n";
+            }
+            if (p.peakHours.length > 0) {
+                result += "**Peak Hours:** ";
+                result += p.peakHours.map((h) => `${h.hour}:00 (${h.count})`).join(", ");
+                result += "\n\n";
+            }
+            if (p.commonPatterns.length > 0) {
+                result += "**Common Patterns:**\n";
+                result += p.commonPatterns.slice(0, 5).map((q) => `- "${truncate(q, 60)}"`).join("\n");
+                result += "\n";
+            }
+            return result;
+        },
+        analyze_usage_patterns: async (args, ctx) => {
+            const { days = 7 } = args;
+            const response = await ctx.api.get(`/api/patterns/${ctx.projectName}?days=${days}`);
+            const data = response.data;
+            let result = `**Usage Patterns for ${ctx.projectName}** (last ${days} days)\n\n`;
+            if (data.insights && data.insights.length > 0) {
+                result += `**Insights:**\n`;
+                result += data.insights
+                    .map((insight) => `- ${insight}`)
+                    .join("\n");
+                result += "\n\n";
+            }
+            if (data.commonWorkflows && data.commonWorkflows.length > 0) {
+                result += `**Common Workflows:**\n`;
+                result += data.commonWorkflows
+                    .map((w) => `- ${w.tools.join(" -> ")} (${w.count}x, ${(w.successRate * 100).toFixed(0)}% success)`)
+                    .join("\n");
+                result += "\n\n";
+            }
+            if (data.detectedPatterns && data.detectedPatterns.length > 0) {
+                result += `**Detected Patterns:**\n`;
+                result += data.detectedPatterns
+                    .map((p) => `- **${p.name}:** ${p.description}\n  *Suggestion:* ${p.suggestion}`)
+                    .join("\n");
+                result += "\n\n";
+            }
+            if (data.recommendations && data.recommendations.length > 0) {
+                result += `**Recommendations:**\n`;
+                result += data.recommendations
+                    .map((r, i) => `${i + 1}. ${r}`)
+                    .join("\n");
+                result += "\n";
+            }
+            return result;
+        },
+        start_session: async (args, ctx) => {
+            const { sessionId, initialContext, resumeFrom } = args;
+            const response = await ctx.api.post("/api/session/start", {
+                projectName: ctx.projectName,
+                sessionId,
+                initialContext,
+                resumeFrom,
+            });
+            const data = response.data;
+            // Update shared context with active session ID
+            if (sharedCtx && data.sessionId) {
+                sharedCtx.activeSessionId = data.sessionId;
+            }
+            let result = `**Session Started**\n\n`;
+            result += `- **Session ID:** ${data.sessionId}\n`;
+            result += `- **Started:** ${data.started}\n`;
+            if (data.resumedFrom) {
+                result += `- **Resumed From:** ${data.resumedFrom}\n`;
+            }
+            if (data.initialFiles && data.initialFiles.length > 0) {
+                result += `\n**Initial Files:**\n`;
+                result += data.initialFiles
+                    .map((f) => `- ${f}`)
+                    .join("\n");
+                result += "\n";
+            }
+            // Include prefetch stats if available
+            if (data.session?.metadata?.prefetchStats) {
+                const pf = data.session.metadata.prefetchStats;
+                result += `\n**Predictive Prefetch:** ${pf.prefetchedCount ?? 0} resources prefetched\n`;
+            }
+            // Include briefing if available (Sprint E)
+            if (data.briefing) {
+                result += `\n**Session Briefing:**\n${data.briefing}\n`;
+            }
+            return result;
+        },
+        get_session_context: async (args, ctx) => {
+            const { sessionId } = args;
+            const response = await ctx.api.get(`/api/session/${sessionId}`);
+            const data = response.data;
+            let result = `**Session Context**\n\n`;
+            result += `- **Session ID:** ${data.sessionId}\n`;
+            result += `- **Status:** ${data.status}\n`;
+            result += `- **Started At:** ${data.startedAt}\n`;
+            result += `- **Last Activity:** ${data.lastActivity}\n`;
+            if (data.currentFiles && data.currentFiles.length > 0) {
+                const files = data.currentFiles.slice(0, 10);
+                result += `\n**Current Files:**\n`;
+                result += files.map((f) => `- ${f}`).join("\n");
+                if (data.currentFiles.length > 10) {
+                    result += `\n- ... and ${data.currentFiles.length - 10} more`;
+                }
+                result += "\n";
+            }
+            if (data.toolsUsed && data.toolsUsed.length > 0) {
+                result += `\n**Tools Used:** ${data.toolsUsed.join(", ")}\n`;
+            }
+            if (data.activeFeatures && data.activeFeatures.length > 0) {
+                result += `\n**Active Features:**\n`;
+                result += data.activeFeatures
+                    .map((f) => `- ${f}`)
+                    .join("\n");
+                result += "\n";
+            }
+            if (data.pendingLearnings && data.pendingLearnings.length > 0) {
+                const learnings = data.pendingLearnings.slice(0, 5);
+                result += `\n**Pending Learnings:**\n`;
+                result += learnings
+                    .map((l) => `- ${truncate(l, 80)}`)
+                    .join("\n");
+                if (data.pendingLearnings.length > 5) {
+                    result += `\n- ... and ${data.pendingLearnings.length - 5} more`;
+                }
+                result += "\n";
+            }
+            return result;
+        },
+        end_session: async (args, ctx) => {
+            const { sessionId, summary, autoSaveLearnings, feedback } = args;
+            const response = await ctx.api.post(`/api/session/${sessionId}/end`, {
+                summary,
+                autoSaveLearnings: autoSaveLearnings !== undefined ? autoSaveLearnings : true,
+                feedback,
+            });
+            const data = response.data;
+            // Clear active session ID
+            if (sharedCtx) {
+                sharedCtx.activeSessionId = undefined;
+            }
+            let result = `**Session Ended**\n\n`;
+            if (data.summary) {
+                result += `**Summary:** ${data.summary}\n\n`;
+            }
+            if (data.duration !== undefined) {
+                result += `- **Duration:** ${data.duration} minutes\n`;
+            }
+            if (data.toolsUsedCount !== undefined) {
+                result += `- **Tools Used:** ${data.toolsUsedCount}\n`;
+            }
+            if (data.filesAffectedCount !== undefined) {
+                result += `- **Files Affected:** ${data.filesAffectedCount}\n`;
+            }
+            if (data.queriesCount !== undefined) {
+                result += `- **Queries:** ${data.queriesCount}\n`;
+            }
+            if (data.learningsSaved !== undefined) {
+                result += `- **Learnings Saved:** ${data.learningsSaved}\n`;
+            }
+            if (data.filesAffected && data.filesAffected.length > 0) {
+                const files = data.filesAffected.slice(0, 10);
+                result += `\n**Files Affected:**\n`;
+                result += files.map((f) => `- ${f}`).join("\n");
+                if (data.filesAffected.length > 10) {
+                    result += `\n- ... and ${data.filesAffected.length - 10} more`;
+                }
+                result += "\n";
+            }
+            return result;
+        },
+    };
+    return { tools, handlers };
+}

package/dist/tools/suggestions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Suggestions tools module - contextual suggestions, related code,
+ * implementation suggestions, test suggestions, and code context.
+ */
+import type { ToolModule } from "../types.js";
+/**
+ * Create the suggestions tools module with project-specific descriptions.
+ */
+export declare function createSuggestionTools(projectName: string): ToolModule;