feat: Add Financial Chart Tools and MongoDB integration

- Introduced new financial chart tools including Chart Supervisor, Chart Generator, Chart Data Processor, and Chart Type Advisor.
- Implemented MongoDB configuration for vector storage and retrieval, enabling advanced semantic search capabilities.
- Updated sample dataset to improve formatting and consistency in output.
- Enhanced the index.ts file to include new financial chart agents in the Mastra framework.
- Documented new tools in AGENTS.md with descriptions, statuses, and dependencies.
- Added MongoDB vector query and memory management functionalities to support RAG applications.
- Improved error handling and logging for chart generation and data processing tools.

Author: ssdeanx

package-lock.json

@@ -50,6 +50,7 @@
     "@mastra/arize": "^0.1.1",
     "@mastra/auth-supabase": "^0.10.9",
     "@mastra/client-js": "^0.16.15",
+    "@mastra/cloudflare-d1": "^0.13.9",
     "@mastra/core": "^0.24.6",
     "@mastra/deployer": "^0.24.6",
     "@mastra/evals": "^0.14.4",
@@ -63,6 +64,7 @@
     "@mastra/pg": "^0.17.9",
     "@mastra/rag": "^1.3.6",
     "@mastra/upstash": "^0.15.9",
+    "@mastra/vectorize": "^0.11.17",
     "@mastra/voice-google": "^0.11.12",
     "@mastra/voice-openai": "^0.11.12",
     "@mcpc-tech/acp-ai-provider": "^0.1.25",
@@ -163,4 +165,4 @@
     "body-parser": "^2.2.1",
     "@mastra/core": "^0.24.6"
   }
-}
+}

package.json

@@ -10,7 +10,7 @@ Agent Developer — objective: Implement higher-level behaviors by composing too
 
 This directory contains 22+ agent definitions that map use-case intents to sequences of tool invocations, policies, and memory usage.
 
-## Current Agents (22 files)
+## Current Agents (26 files)
 
 | File                         | Export                     | Agent ID                   | Purpose                                                          | Dependencies                      |
 | ---------------------------- | -------------------------- | -------------------------- | ---------------------------------------------------------------- | --------------------------------- |
@@ -28,6 +28,10 @@ This directory contains 22+ agent definitions that map use-case intents to seque
 | `contentStrategistAgent.ts`  | `contentStrategistAgent`   | `contentStrategistAgent`   | Develops content strategies and plans                            | Research Tools                    |
 | `scriptWriterAgent.ts`       | `scriptWriterAgent`        | `scriptWriterAgent`        | Writes scripts for video and audio content                       | NLP, Script Formatting            |
 | `stockAnalysisAgent.ts`      | `stockAnalysisAgent`       | `stockAnalysisAgent`       | Analyzes stock market data with technical/fundamental analysis   | Polygon, Finnhub, AlphaVantage    |
+| `recharts.ts`                | `chartTypeAdvisorAgent`    | `chart-type-advisor`       | Recommends optimal Recharts chart types for financial data       | Recharts                          |
+| `recharts.ts`                | `chartDataProcessorAgent`  | `chart-data-processor`     | Transforms financial API data into Recharts format               | Polygon, Finnhub, AlphaVantage    |
+| `recharts.ts`                | `chartGeneratorAgent`      | `chart-generator`          | Generates Recharts React component code                          | Recharts                          |
+| `recharts.ts`                | `chartSupervisorAgent`     | `chart-supervisor`         | Orchestrates the chart creation pipeline                         | Polygon, Finnhub, AlphaVantage    |
 | `dataExportAgent.ts`         | `dataExportAgent`          | `dataExportAgent`          | JSON → CSV conversion, file writing, backup, validation          | CSV/JSON Tools, File System       |
 | `dataIngestionAgent.ts`      | `dataIngestionAgent`       | `dataIngestionAgent`       | CSV parsing, file reading, structure validation                  | CSV/JSON Tools, File System       |
 | `dataTransformationAgent.ts` | `dataTransformationAgent`  | `dataTransformationAgent`  | CSV↔JSON↔XML transformations and restructuring                   | Data Processing Tools             |
@@ -110,6 +114,7 @@ npm test src/mastra/__tests__/agents/your-agent.test.ts
 
 | Version | Date (UTC) | Changes                                                                                                                              |
 | ------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| 2.1.0   | 2025-11-28 | Added 4 Financial Chart agents: chartTypeAdvisorAgent, chartDataProcessorAgent, chartGeneratorAgent, chartSupervisorAgent.          |
 | 2.0.0   | 2025-11-26 | Major update: 22 agents documented. Added data pipeline, research paper, document processing, knowledge indexing agents.             |
 | 1.2.0   | 2025-11-19 | Added content creation and stock analysis agents.                                                                                    |
 | 1.1.0   | 2025-11-16 | Complete reorganization of agents documentation. Added detailed sections for each agent, development guidelines, and best practices. |

src/mastra/agents/AGENTS.md

@@ -4,6 +4,7 @@ import { pgMemory } from '../config/pg-storage';
 import { webScraperTool } from '../tools/web-scraper-tool';
 import { InternalSpans } from '@mastra/core/ai-tracing';
 import { structureScorer, creativityScorer } from '../scorers';
+import { chartSupervisorTool } from '../tools/financial-chart-tools';
 
 export const contentStrategistAgent = new Agent({
   id: 'content-strategist',
@@ -89,6 +90,7 @@ Output:
   memory: pgMemory,
   tools: {
     webScraperTool,
+    chartSupervisorTool
   },
   scorers: {
     structure: {

src/mastra/agents/contentStrategistAgent.ts

@@ -12,6 +12,7 @@ import { pgMemory } from '../config/pg-storage'
 import { googleAI, googleAIFlashLite } from '../config/google'
 import { creativityScorer, responseQualityScorer, toneConsistencyScorer, structureScorer } from '../scorers'
 import { InternalSpans } from '@mastra/core/ai-tracing'
+import { chartSupervisorTool } from '../tools/financial-chart-tools'
 
 // Define runtime context for this agent
 export interface CopywriterAgentContext {
@@ -131,6 +132,7 @@ Provide the final content in a clear, well-structured format appropriate for the
         //    linkExtractorTool,
         htmlToMarkdownTool,
         contentCleanerTool,
+        chartSupervisorTool
     },
     scorers: {
         creativity: {

src/mastra/agents/copywriterAgent.ts

@@ -13,6 +13,7 @@ import {
     getDataFileInfoTool,
 } from '../tools/data-file-manager'
 import { readCSVDataTool } from '../tools/data-processing-tools'
+import { chartSupervisorTool } from '../tools/financial-chart-tools'
 
 export interface DataIngestionContext {
     userId?: string
@@ -97,6 +98,7 @@ export const dataIngestionAgent = new Agent({
         dataValidatorTool,
         listDataDirTool,
         getDataFileInfoTool,
+        chartSupervisorTool
     },
     options: { tracingPolicy: { internal: InternalSpans.AGENT } },
 })