MCP Contemplation

Instructions

Implementation Reference

• src/index.ts:176-217 (handler)

  Core implementation of getInsights: prunes old insights, aggregates similar ones, filters by type and threshold, sorts by significance/recency, marks used, and returns limited results.
  async getInsights(thoughtType?: string, limit: number = 10): Promise<Insight[]> { // First, clean up old/low-value insights this.pruneInsights(); // Aggregate similar insights this.aggregateSimilarInsights(); // Filter unused insights above threshold let filtered = this.insights.filter(i => !i.used && i.significance >= this.significanceThreshold ); if (thoughtType) { filtered = filtered.filter(i => i.thought_type === thoughtType); } // Sort by significance and recency filtered.sort((a, b) => { // Prioritize aggregated insights if (a.similar_count && b.similar_count) { const countDiff = (b.similar_count || 1) - (a.similar_count || 1); if (countDiff !== 0) return countDiff; } if (b.significance !== a.significance) { return b.significance - a.significance; } return new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime(); }); // Mark as used and clean from memory const results = filtered.slice(0, limit); results.forEach(insight => { insight.used = true; // Remove high-frequency patterns after use to prevent repetition if (insight.similar_count && insight.similar_count > 3) { this.removeInsight(insight.id); } }); return results; }
• src/index.ts:518-533 (handler)

  MCP CallToolRequest handler for 'get_insights': parses arguments, optionally sets significance threshold, calls ContemplationManager.getInsights, and returns insights as JSON text.
  case 'get_insights': { const { thought_type, limit, min_significance } = args as { thought_type?: string; limit?: number; min_significance?: number; }; if (min_significance) { contemplation.setThreshold(min_significance); } const insights = await contemplation.getInsights(thought_type, limit); return { content: [{ type: 'text', text: JSON.stringify(insights, null, 2) }], }; }
• src/index.ts:409-432 (registration)

  Tool registration in ListToolsResponse: defines name, description, and input schema for get_insights tool.
  { name: 'get_insights', description: 'Retrieve processed insights from contemplation', inputSchema: { type: 'object', properties: { thought_type: { type: 'string', enum: ['pattern', 'connection', 'question', 'general'], description: 'Filter by thought type' }, limit: { type: 'number', description: 'Maximum insights to return (default 10)' }, min_significance: { type: 'number', description: 'Minimum significance score 1-10 (default 5)', minimum: 1, maximum: 10 } }, }, },
• src/index.ts:88-97 (schema)

  TypeScript interface defining the structure of Insight objects returned by getInsights.
  interface Insight { id: string; thought_type: string; content: string; significance: number; timestamp: string; used: boolean; similar_count?: number; aggregated_ids?: string[]; }
• src/index.ts:219-236 (helper)

  Helper method called by getInsights to prune old, used, or low-significance insights from memory.
  private pruneInsights(): void { const now = Date.now(); const maxAge = 24 * 60 * 60 * 1000; // 24 hours // Remove old, used, or low-significance insights this.insights = this.insights.filter(insight => { const age = now - new Date(insight.timestamp).getTime(); // Keep if: recent AND (unused OR high significance) return age < maxAge && (!insight.used || insight.significance >= 8); }); // If still too many, keep only the most significant if (this.insights.length > this.maxInsightsInMemory) { this.insights.sort((a, b) => b.significance - a.significance); this.insights = this.insights.slice(0, this.maxInsightsInMemory); } }