Merge pull request #68 from ssdeanx/develop

feat: Add new networks and workflows for enhanced functionality

Author: ssdeanx

AGENTS.md

@@ -1,9 +1,10 @@
 <!-- AGENTS-META {"title":"Mastra Root","version":"2.3.0","applies_to":"/","last_updated":"2025-12-11T00:00:00Z","status":"stable"} -->
+
 # AGENTS
 
 ## Project Overview
 
-Mastra is a production-grade multi-agent framework for building agent-driven applications and RAG (retrieval-augmented generation) workflows. It provides **40+ enterprise tools**, **30+ specialized agents**, **14+ workflows**, **4 agent networks**, **A2A/MCP orchestration**, and a **complete UI component library** (64 components: 30 AI Elements + 34 base UI) for scalable AI systems. Key capabilities include **financial intelligence**, **RAG pipelines**, **observability**, **secure governance**, and **AI chat interfaces**.
+Mastra is a production-grade multi-agent framework for building agent-driven applications and RAG (retrieval-augmented generation) workflows. It provides **60+ enterprise tools**, **31+ specialized agents**, **15+ workflows**, **13 agent networks**, **A2A/MCP orchestration**, and a **complete UI component library** (65 components: 30 AI Elements + 35 base UI) for scalable AI systems. Key capabilities include **financial intelligence**, **RAG pipelines**, **observability**, **secure governance**, and **AI chat interfaces**.
 
 This repo is structured to keep tools, agents, workflows, networks, UI components, and configs separated, with strict Zod schemas for tool inputs/outputs and strong environment-based configuration in `src/mastra/config`.
 
@@ -90,10 +91,10 @@ NEXT_PUBLIC_MASTRA_API_URL=http://localhost:4111
 ## Architecture & conventions
 
 - **Frontend** (`app/`, `ui/`, `src/components/ai-elements/`): Next.js 16 App Router with React 19. AI Elements (30 components) for chat/reasoning/canvas UIs. shadcn/ui base (34 components) in `ui/`. Tailwind CSS 4 with oklch color variables.
-- **Tools** (`src/mastra/tools`): 40+ tools implementing `createTool({ id, inputSchema, outputSchema, execute })` with strict Zod schemas. Categories: Financial (Polygon, Finnhub, AlphaVantage), Research (SerpAPI, ArXiv), Data (CSV, JSON, PDF), RAG (chunking, embeddings), Code (search, analysis, chunking), Browser automation, Calendar, JWT auth, GitHub integration.
-- **Agents** (`src/mastra/agents`): 30+ agents composing tools into specialized behaviors (research, stock analysis, content creation, data processing, business/legal, charting, image processing, coding, calendar, document processing, knowledge indexing).
-- **Networks** (`src/mastra/networks`): 4 agent networks for routing and orchestration (agentNetwork, dataPipelineNetwork, reportGenerationNetwork, researchPipelineNetwork).
-- **Workflows** (`src/mastra/workflows`): 14+ multi-step workflows using Mastra DSL (weather, content, financial reports, document processing, research synthesis, governed RAG, learning extraction, repo ingestion, stock analysis, telephone game, spec generation).
+- **Tools** (`src/mastra/tools`): 60+ tools implementing `createTool({ id, inputSchema, outputSchema, execute })` with strict Zod schemas. Categories: Financial (Polygon, Finnhub, AlphaVantage), Research (SerpAPI, ArXiv), Data (CSV, JSON, PDF), RAG (chunking, embeddings), Code (search, analysis, chunking), Browser automation, Calendar, JWT auth, GitHub integration.
+- **Agents** (`src/mastra/agents`): 31+ agents composing tools into specialized behaviors (research, stock analysis, content creation, data processing, business/legal, charting, image processing, coding, calendar, document processing, knowledge indexing, social media, SEO, translation, customer support, project management).
+- **Networks** (`src/mastra/networks`): 13 agent networks for routing and orchestration (primary routing, data pipeline, report generation, research pipeline, content creation, financial intelligence, learning, marketing automation, DevOps, business intelligence, security).
+- **Workflows** (`src/mastra/workflows`): 15+ multi-step workflows using Mastra DSL (weather, content, financial reports, document processing, research synthesis, governed RAG, learning extraction, repo ingestion, stock analysis, telephone game, spec generation, marketing campaign).
 - **Config** (`src/mastra/config`): Centralized provider clients (Google, OpenAI, Anthropic, OpenRouter, Vertex), pg-storage with PgVector, and role hierarchy.
 - **Scorers** (`src/mastra/scorers`): Custom evaluation metrics for automated quality assessment.
 - **MCP/A2A** (`src/mastra/mcp`, `src/mastra/a2a`): Model Context Protocol server and Agent-to-Agent coordination.
@@ -142,12 +143,12 @@ NEXT_PUBLIC_MASTRA_API_URL=http://localhost:4111
 - `app/tools/AGENTS.md`: Tool documentation and execution
 - `app/workflows/AGENTS.md`: Interactive workflow visualization with AI Elements (Canvas, Node, Edge, Panel)
 - `lib/`: Shared utilities
-  - `hooks/`: React hooks for data fetching and state management
-    - `use-dashboard-queries.ts`: TanStack Query hooks for agents, workflows, tools, traces, threads, messages
-    - `use-mastra.ts`: Generic fetch hook with loading/error states for MastraClient data
-  - `types/`: TypeScript type definitions
-    - `mastra-api.ts`: Zod schemas and types for Agent, Workflow, Tool, MemoryThread, Message, VectorQueryResult
-  - Core utilities: `a2a.ts` (agent coordination), `auth.ts` (authentication), `client-stream-to-ai-sdk.ts` (streaming), `mastra-client.ts` (client), `utils.ts`
+    - `hooks/`: React hooks for data fetching and state management
+        - `use-dashboard-queries.ts`: TanStack Query hooks for agents, workflows, tools, traces, threads, messages
+        - `use-mastra.ts`: Generic fetch hook with loading/error states for MastraClient data
+    - `types/`: TypeScript type definitions
+        - `mastra-api.ts`: Zod schemas and types for Agent, Workflow, Tool, MemoryThread, Message, VectorQueryResult
+    - Core utilities: `a2a.ts` (agent coordination), `auth.ts` (authentication), `client-stream-to-ai-sdk.ts` (streaming), `mastra-client.ts` (client), `utils.ts`
 - `ui/AGENTS.md`: shadcn/ui base components (34 components)
 - `src/components/ai-elements/AGENTS.md`: AI Elements library (30 components)
 - `src/mastra/AGENTS.md`: top-level code-agent focused docs (this file is mirrored to subfolders)
@@ -173,21 +174,21 @@ graph TB
         LandingUI[app/ - Landing Pages]
         ComponentsUI[app/components/ - Public]
     end
-    
+
     subgraph AI["AI Components"]
         AIElements["AI Elements (30)"]
         ShadcnUI["shadcn/ui (34)"]
         SDK["@ai-sdk/react"]
     end
-    
+
     subgraph Core["Mastra Core"]
         Agents["Agents (30+)"]
         Tools["Tools (40+)"]
         Workflows["Workflows (14+)"]
         Networks["Networks (4)"]
         Scorers["Scorers"]
     end
-    
+
     subgraph Infrastructure["Infrastructure"]
         Config[Config]
         Storage[PostgreSQL + PgVector]
@@ -196,7 +197,7 @@ graph TB
         A2A[A2A Coordination]
         CLI[CLI Tools]
     end
-    
+
     Frontend --> AI
     AI --> Core
     Core --> Infrastructure
@@ -216,10 +217,10 @@ graph TB
 
 ### Core Components
 
-- **40+ Tools**: Financial, Research, Data, RAG, Code, Browser, Calendar, Auth, GitHub
-- **30+ Agents**: Specialized behaviors composing tools for research, analysis, content
-- **14+ Workflows**: Multi-step DSL workflows for complex orchestration
-- **4 Networks**: Routing and orchestration between agents and workflows
+- **60+ Tools**: Financial, Research, Data, RAG, Code, Browser, Calendar, Auth, GitHub
+- **31+ Agents**: Specialized behaviors composing tools for research, analysis, content, social media, SEO, translation, customer support, project management
+- **15+ Workflows**: Multi-step DSL workflows for complex orchestration
+- **13 Networks**: Routing and orchestration between agents and workflows
 
 ### Infrastructure
 
@@ -244,10 +245,11 @@ graph TB
 - `.eslintignore`: ESLint ignore patterns for node_modules, build artifacts, memory-bank, docs, and other non-source directories
 - `.markdownlint.json`: Markdown linting configuration with relaxed rules for line length, headings, and formatting
 - `src/cli/`: CLI tooling for Governed RAG
-  - `index.ts`: CLI commands for document indexing, querying RAG, and usage statistics
-  - `AGENTS.md`: CLI documentation and usage patterns
+    - `index.ts`: CLI commands for document indexing, querying RAG, and usage statistics
+    - `AGENTS.md`: CLI documentation and usage patterns
 
 If you need more details for a subdirectory, open the folder-specific `AGENTS.md` which contains persona, purpose, and actionable commands.
 
 ---
-Last updated: 2025-12-11
+
+Last updated: 2025-12-15