Skip to content

FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.

feat: Add standardized documentation headers to all Python agent files

rudrasheth9f8907f28b8c
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/benjamin_graham_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/benjamin_graham_agent.py
index 57783d74f..52ca8f842 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/benjamin_graham_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/benjamin_graham_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/bill_miller_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/bill_miller_agent.py
index 0f09434d9..067eb8e12 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/bill_miller_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/bill_miller_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/charlie_munger_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/charlie_munger_agent.py
index df950b993..a798a2b4f 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/charlie_munger_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/charlie_munger_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/david_einhorn_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/david_einhorn_agent.py
index 5a2e4284b..a322257fa 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/david_einhorn_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/david_einhorn_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/howard_marks_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/howard_marks_agent.py
index c7fb040ce..8c5025168 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/howard_marks_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/howard_marks_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/jean_marie_eveillard_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/jean_marie_eveillard_agent.py
index 38bd7facf..34ec89b8f 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/jean_marie_eveillard_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/jean_marie_eveillard_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/joel_greenblatt_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/joel_greenblatt_agent.py
index 1f5fe7087..cc534703a 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/joel_greenblatt_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/joel_greenblatt_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/marty_whitman_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/marty_whitman_agent.py
index 9b4d307d4..7855a90b3 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/marty_whitman_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/marty_whitman_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/seth_klarman_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/seth_klarman_agent.py
index a13d44984..00d0831bc 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/seth_klarman_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/seth_klarman_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/warren_buffett_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/warren_buffett_agent.py
index 98dbd4b62..55cda49c5 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/warren_buffett_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/Trader_Investors_agent/warren_buffett_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/arq_capital_hedge_fund_agent/arq_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/arq_capital_hedge_fund_agent/arq_agent.py
index 1409eaae5..14e36f777 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/arq_capital_hedge_fund_agent/arq_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/arq_capital_hedge_fund_agent/arq_agent.py
@@ -1,14 +1,22 @@
-from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
-from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
-from langchain_core.prompts import ChatPromptTemplate
-from langchain_core.messages import HumanMessage
-from pydantic import BaseModel
-import json
-import math
-from typing_extensions import Literal
-from fincept_terminal.Agents.src.utils.progress import progress
-from fincept_terminal.Agents.src.utils.llm import call_llm
-from fincept_terminal.Agents.src.utils.api_key import get_api_key_from_state
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio, P/E, P/B, ROIC, ROA
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares, Total Assets, Current Assets, Current Liabilities
+# - Market Cap
+# - Factor scores: Value, Momentum, Quality, Low Volatility, Profitability
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+# - factor_combination_weights: Value=35%, Momentum=35%, Quality=30%
+# - academic_validation_threshold: 95% confidence level
+"""
class AQRSignal(BaseModel):
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/bridgewater_associates_hedge_fund_agent/bridgewater_associates_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/bridgewater_associates_hedge_fund_agent/bridgewater_associates_agent.py
index 4cb77fcd1..fabdef2b6 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/bridgewater_associates_hedge_fund_agent/bridgewater_associates_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/bridgewater_associates_hedge_fund_agent/bridgewater_associates_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/citadel_hedge_fund_agent/citadel_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/citadel_hedge_fund_agent/citadel_agent.py
index 5f1ef08e5..34da52d8f 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/citadel_hedge_fund_agent/citadel_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/citadel_hedge_fund_agent/citadel_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/de_shaw_hedge_fund_agent/de_shaw_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/de_shaw_hedge_fund_agent/de_shaw_agent.py
index 0cfb4de80..b4700b8e6 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/de_shaw_hedge_fund_agent/de_shaw_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/de_shaw_hedge_fund_agent/de_shaw_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/elliott_management_hedge_fund_agent/elliott_management_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/elliott_management_hedge_fund_agent/elliott_management_agent.py
index 85f19418f..894080209 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/elliott_management_hedge_fund_agent/elliott_management_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/elliott_management_hedge_fund_agent/elliott_management_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/agent_orchestrator.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/agent_orchestrator.py
index 59782cdb7..b8ed686f8 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/agent_orchestrator.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/agent_orchestrator.py
@@ -1,6 +1,23 @@
# -*- coding: utf-8 -*-
# agent_orchestrator.py
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
import asyncio
import json
import logging
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/behavioral_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/behavioral_agent.py
index 4a9800fc1..08f64a49c 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/behavioral_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/behavioral_agent.py
@@ -1,6 +1,26 @@
# -*- coding: utf-8 -*-
# agents/behavioral_agent.py - Behavioral Finance Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - market sentiment data
+# - behavioral indicators
+# - psychological market patterns
+#
+# OUTPUT:
+# - Behavioral finance signals
+# - Market sentiment analysis
+# - Anomaly detection results
+# - Behavioral pattern recognition
+#
+# PARAMETERS:
+# - sentiment_data_sources
+# - behavioral_models
+# - anomaly_thresholds
+# - psychological_indicators
+"""
+
import asyncio
import numpy as np
from datetime import datetime, timedelta
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/central_bank_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/central_bank_agent.py
index 1d737705b..b5fd759a8 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/central_bank_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/central_bank_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/central_bank_agent.py - Central Bank Policy Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - central bank announcements
+# - monetary policy statements
+# - interest rate decisions
+# - economic indicators
+#
+# OUTPUT:
+# - Central bank policy signals
+# - Monetary policy stance analysis
+# - Interest rate forecasts
+# - Market impact assessments
+#
+# PARAMETERS:
+# - policy_indicators
+# - economic_data_sources
+# - central_bank_watchlist
+# - forecast_horizons
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/config.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/config.py
index 4136ef8b6..75fc88cb8 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/config.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/config.py
@@ -1,6 +1,23 @@
# -*- coding: utf-8 -*-
# config.py - Production Configuration for AI Hedge Fund System
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
import os
from dataclasses import dataclass
from typing import Dict, List, Optional
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/currency_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/currency_agent.py
index 620e196a4..70750c1f1 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/currency_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/currency_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/currency_agent.py - Foreign Exchange Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - currency pairs
+# - forex market data
+# - interest rate differentials
+# - geopolitical events
+#
+# OUTPUT:
+# - Currency trading signals
+# - FX market analysis
+# - Exchange rate forecasts
+# - Currency pair recommendations
+#
+# PARAMETERS:
+# - currency_pairs
+# - timeframes
+# - technical_indicators
+# - fundamental_factors
+"""
+
import asyncio
import numpy as np
from datetime import datetime
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/data_feeds.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/data_feeds.py
index 5a2cfe72c..bcd5282e4 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/data_feeds.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/data_feeds.py
@@ -1,6 +1,23 @@
# -*- coding: utf-8 -*-
# data_feeds.py - Production Data Sources and Feed Management
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
import asyncio
import aiohttp
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/geopolitical_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/geopolitical_agent.py
index d3a055171..6eee223f7 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/geopolitical_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/geopolitical_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/geopolitical_agent.py - Geopolitical Risk Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - geopolitical events
+# - political risk indicators
+# - international relations data
+# - regional stability metrics
+#
+# OUTPUT:
+# - Geopolitical risk assessments
+# - Regional stability analysis
+# - Political event impact forecasts
+# - Cross-border investment recommendations
+#
+# PARAMETERS:
+# - risk_indicators
+# - regions_monitoring
+# - event_types
+# - impact_timeframes
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/innovation_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/innovation_agent.py
index 4781bc9e5..c569c762d 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/innovation_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/innovation_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/innovation_agent.py - Technology Innovation Cycle Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - technology trends data
+# - innovation metrics
+# - patent filings
+# - R&D investments
+#
+# OUTPUT:
+# - Technology trend forecasts
+# - Innovation cycle identification
+# - Disruptive technology alerts
+# - Sector impact analysis
+#
+# PARAMETERS:
+# - technology_sectors
+# - innovation_indicators
+# - trend_analysis_periods
+# - disruption_thresholds
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/institutional_flow_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/institutional_flow_agent.py
index 7d0211d78..ae2396d04 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/institutional_flow_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/institutional_flow_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/institutional_flow_agent.py - Institutional Flow Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - institutional trading data
+# - fund flow metrics
+# - position changes
+# - large holder information
+#
+# OUTPUT:
+# - Institutional flow analysis
+# - Fund flow trends
+# - Position change alerts
+# - Institutional sentiment indicators
+#
+# PARAMETERS:
+# - institution_types
+# - flow_thresholds
+# - position_tracking
+# - reporting_periods
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/macro_cycle_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/macro_cycle_agent.py
index 284aabce7..1bb986350 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/macro_cycle_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/macro_cycle_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/macro_cycle_agent.py - Economic Cycles Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - economic indicators
+# - business cycle data
+# - employment statistics
+# - inflation metrics
+#
+# OUTPUT:
+# - Economic cycle phase identification
+# - Business cycle forecasts
+# - Macro trend analysis
+# - Sector rotation recommendations
+#
+# PARAMETERS:
+# - economic_indicators
+# - cycle_detection_methods
+# - forecast_horizons
+# - sector_classification
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/main.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/main.py
index 651a3eeec..0d9b2d07d 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/main.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/main.py
@@ -1,6 +1,30 @@
# -*- coding: utf-8 -*-
# main.py - AI Hedge Fund Orchestrator and Execution Engine
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - Agent reports from all hedge fund agents
+# - Market data feeds (real-time and historical)
+# - Portfolio current positions and allocations
+# - Risk management parameters and limits
+# - Trading signals and market regime data
+#
+# OUTPUT:
+# - Aggregated trading signals with conviction scores
+# - Portfolio recommendations with asset allocations
+# - Risk-adjusted position sizes using Kelly Criterion
+# - Execution results with trading costs and slippage
+# - Performance metrics and portfolio analytics
+#
+# PARAMETERS:
+# - max_position_size: Maximum single position limit (default 10%)
+# - max_sector_exposure: Maximum sector allocation limit (default 25%)
+# - var_limit: Value-at-Risk limit (default 5%)
+# - update_frequency: Analysis cycle frequency (default 60 seconds)
+# - agent_weights: Weight distribution for different agents
+"""
+
import asyncio
import logging
import json
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/regulatory_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/regulatory_agent.py
index c655932b0..a68b3ccaf 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/regulatory_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/regulatory_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/regulatory_agent.py - Regulatory Intelligence Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - regulatory announcements
+# - compliance updates
+# - policy changes
+# - enforcement actions
+#
+# OUTPUT:
+# - Regulatory impact assessments
+# - Compliance requirement updates
+# - Policy change analysis
+# - Risk mitigation recommendations
+#
+# PARAMETERS:
+# - regulatory_sources
+# - compliance_frameworks
+# - risk_categories
+# - monitoring_frequency
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/sentiment_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/sentiment_agent.py
index a23c98ead..c825de8d6 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/sentiment_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/sentiment_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/sentiment_agent.py - Market Sentiment Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - market sentiment data
+# - social media feeds
+# - news sentiment
+# - investor sentiment surveys
+#
+# OUTPUT:
+# - Market sentiment scores
+# - Sentiment trend analysis
+# - Contrarian signals
+# - Sentiment-based alerts
+#
+# PARAMETERS:
+# - sentiment_sources
+# - analysis_timeframes
+# - sentiment_thresholds
+# - contrarian_indicators
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/supply_chain_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/supply_chain_agent.py
index b78cebc18..929078f54 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/supply_chain_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/fincept_hedge_fund/supply_chain_agent.py
@@ -1,6 +1,27 @@
# -*- coding: utf-8 -*-
# agents/supply_chain_agent.py - Supply Chain Analysis Agent
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - supply chain data
+# - logistics metrics
+# - inventory levels
+# - shipping information
+#
+# OUTPUT:
+# - Supply chain risk assessments
+# - Disruption alerts
+# - Efficiency metrics
+# - Supplier risk analysis
+#
+# PARAMETERS:
+# - supply_chain_tiers
+# - risk_indicators
+# - monitoring_regions
+# - disruption_thresholds
+"""
+
import asyncio
import numpy as np
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/pershing_square_hedge_fund_agent/pershing_square_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/pershing_square_hedge_fund_agent/pershing_square_agent.py
index 33eb31333..7138bf2be 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/pershing_square_hedge_fund_agent/pershing_square_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/pershing_square_hedge_fund_agent/pershing_square_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/renaissance_technologies_hedge_fund_agent/renaissance_technologies_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/renaissance_technologies_hedge_fund_agent/renaissance_technologies_agent.py
index a8030f1e3..b1273f610 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/renaissance_technologies_hedge_fund_agent/renaissance_technologies_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/renaissance_technologies_hedge_fund_agent/renaissance_technologies_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/sample_usage.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/sample_usage.py
index 3a520a8d2..a099a8662 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/sample_usage.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/sample_usage.py
@@ -1,5 +1,27 @@
# ===== HEDGE FUND AGENTS INTEGRATION GUIDE =====
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - Mock financial data for testing
+# - API keys for different LLM providers
+# - Hedge fund agent selections and configurations
+#
+# OUTPUT:
+# - Consensus trading signals from multiple hedge funds
+# - Individual fund analysis results
+# - Web service endpoints with JSON responses
+# - Portfolio recommendations with confidence scores
+#
+# PARAMETERS:
+# - consensus_threshold: 60% agreement for bullish/bearish signals
+# - llm_providers: OpenRouter, Ollama, OpenAI configurations
+# - selected_funds: List of hedge funds to run analysis
+# - web_service_endpoints: REST API endpoints for analysis
+"""
+
# 1. STANDALONE USAGE (Direct Import)
from bridgewater_hedge_fund import bridgewater_associates_agent
from renaissance_hedge_fund import renaissance_technologies_agent
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/graph/state.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/graph/state.py
index f8dc42216..c2b4a132c 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/graph/state.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/graph/state.py
@@ -1,3 +1,22 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - Agent state messages
+# - Metadata dictionaries
+# - Agent output data
+# - Agent names
+#
+# OUTPUT:
+# - Formatted agent reasoning display
+# - Merged dictionaries
+# - JSON-serializable agent outputs
+#
+# PARAMETERS:
+# - merge_dicts function for combining state dictionaries
+# - show_agent_reasoning function for displaying analysis
+# - AgentState TypedDict for structure definition
+"""
+
from typing_extensions import Annotated, Sequence, TypedDict
import operator
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/tools/api.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/tools/api.py
index 60ccbdc9b..a8a724487 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/tools/api.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/tools/api.py
@@ -1,3 +1,28 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+# - start_date (optional string)
+# - period (string, default "ttm")
+# - limit (integer, default varies by function)
+#
+# OUTPUT:
+# - Price data: OHLCV with timestamps
+# - Financial metrics: ROE, D/E, Current Ratio, P/E, P/B, etc.
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Company news with sentiment data
+# - Insider trades with filing dates
+# - Market capitalization data
+#
+# PARAMETERS:
+# - period="ttm" or "annual" or "quarterly"
+# - limit=10 years for financial metrics
+# - max_retries=3 for API requests
+# - interval="day" for price data
+"""
+
import datetime
import os
import pandas as pd
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/analysts.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/analysts.py
index 26f9d21fd..be5899573 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/analysts.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/analysts.py
@@ -1,3 +1,26 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - Analyst configuration dictionaries
+# - Agent function references
+# - Trading style definitions
+# - Order sequencing parameters
+#
+# OUTPUT:
+# - ANALYST_CONFIG dictionary with display names, descriptions, investing styles
+# - Analyst function mappings
+# - Ordered agent lists by priority
+# - Agent metadata for API responses
+#
+# PARAMETERS:
+# - display_name: Human-readable analyst names (e.g., "Warren Buffett")
+# - description: Brief titles (e.g., "The Oracle of Omaha")
+# - investing_style: Detailed investment approaches
+# - agent_func: Function references for each analyst
+# - type: Agent categories ("analyst")
+# - order: Numerical execution priorities (0-14)
+"""
+
"""Constants and utilities related to analysts configuration."""
from src.agents import portfolio_manager
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/api_key.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/api_key.py
index 048813f75..792ace964 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/api_key.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/api_key.py
@@ -1,5 +1,22 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - state dictionary with metadata
+# - api_key_name string identifier
+# - request object with api_keys attribute
+#
+# OUTPUT:
+# - API key string for authentication
+# - None if key not found
+#
+# PARAMETERS:
+# - state: Dictionary containing application state and request metadata
+# - api_key_name: String identifier for specific API key (e.g., "FINANCIAL_DATASETS_API_KEY")
+"""
+
+
def get_api_key_from_state(state: dict, api_key_name: str) -> str:
"""Get an API key from the state object."""
if state and state.get("metadata", {}).get("request"):
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/display.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/display.py
index 21a7f6852..9fdd21c73 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/display.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/display.py
@@ -1,3 +1,25 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - Trading decisions dictionary with tickers
+# - Agent analysis signals dictionary
+# - Backtest results with table rows
+# - Performance metrics and portfolio data
+#
+# OUTPUT:
+# - Formatted console output with colored tables
+# - Portfolio summaries with total values
+# - Performance metrics (Sharpe ratio, Sortino ratio, Max drawdown)
+# - Agent signal analysis with confidence scores
+#
+# PARAMETERS:
+# - tickers: Stock symbols for analysis
+# - actions: BUY/SELL/HOLD decisions
+# - quantities: Number of shares
+# - confidence: Confidence percentages
+# - reasoning: Detailed analysis explanations
+"""
+
from colorama import Fore, Style
from tabulate import tabulate
from .analysts import ANALYST_ORDER
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/docker.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/docker.py
index d638f5499..32650954e 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/docker.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/docker.py
@@ -1,3 +1,23 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - model names
+# - Ollama service URLs
+# - download confirmation responses
+#
+# OUTPUT:
+# - Model availability status
+# - Download progress updates
+# - Service connection results
+# - Docker container status
+#
+# PARAMETERS:
+# - model_name: Name of the Ollama model to manage
+# - ollama_url: Base URL for Ollama service
+# - max_wait_time: Maximum time to wait for model downloads
+# - check_interval: Interval for checking download progress
+"""
+
"""Utilities for working with Ollama models in Docker environments"""
import requests
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/llm.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/llm.py
index c7535d5d2..64a729c16 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/llm.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/llm.py
@@ -1,3 +1,24 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - text prompts
+# - Pydantic model classes
+# - agent configuration parameters
+#
+# OUTPUT:
+# - Structured LLM responses
+# - Validated output data
+# - Default fallback responses
+# - API call results
+#
+# PARAMETERS:
+# - prompt: Input text prompt for the LLM to process
+# - pydantic_model: Schema class for structured output validation
+# - agent_name: Identifier for extracting agent-specific model configuration
+# - state: Agent state containing model preferences and API keys
+# - max_retries: Number of retry attempts for failed LLM calls
+"""
+
"""Helper functions for LLM"""
import json
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/ollama.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/ollama.py
index 5af70ee44..59ffb1993 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/ollama.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/ollama.py
@@ -1,3 +1,23 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - model names
+# - installation preferences
+# - download confirmations
+#
+# OUTPUT:
+# - Local model availability
+# - Installation status
+# - Download progress
+# - Server connectivity status
+#
+# PARAMETERS:
+# - model_name: Name of the Ollama model to manage
+# - ollama_url: Server URL for Ollama API communication
+# - system: Operating system platform
+# - max_wait_time: Timeout duration for server startup operations
+"""
+
"""Utilities for working with Ollama models"""
import platform
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/progress.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/progress.py
index 0c709d16f..db86f2018 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/progress.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/progress.py
@@ -1,3 +1,25 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - agent names
+# - status messages
+# - ticker symbols
+# - analysis results
+#
+# OUTPUT:
+# - Formatted progress tables
+# - Live status displays
+# - Agent completion tracking
+# - Real-time execution monitoring
+#
+# PARAMETERS:
+# - agent_name: Name identifier for the agent being tracked
+# - ticker: Stock symbol being analyzed by the agent
+# - status: Current status message
+# - analysis: Analysis results or output from the agent
+# - timestamp: UTC timestamp for status tracking
+"""
+
from datetime import datetime, timezone
from rich.console import Console
from rich.live import Live
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/visualize.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/visualize.py
index 3e498a31a..a44e68d48 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/visualize.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/src/utils/visualize.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - compiled graph objects
+# - output file path specifications
+#
+# OUTPUT:
+# - PNG image files
+# - Graph visualizations
+# - Mermaid diagram representations
+# - Workflow structure diagrams
+#
+# PARAMETERS:
+# - app: Compiled LangGraph application with workflow structure
+# - output_file_path: File system path for saving the PNG visualization
+"""
+
from langgraph.graph.state import CompiledGraph
from langchain_core.runnables.graph import MermaidDrawMethod
diff --git a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/two_sigma_hedge_fund_agent/two_sigma_agent.py b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/two_sigma_hedge_fund_agent/two_sigma_agent.py
index 4123b3fba..9123ecd30 100644
--- a/fincept-terminal-desktop/src-tauri/resources/scripts/agents/two_sigma_hedge_fund_agent/two_sigma_agent.py
+++ b/fincept-terminal-desktop/src-tauri/resources/scripts/agents/two_sigma_hedge_fund_agent/two_sigma_agent.py
@@ -1,3 +1,20 @@
+"""
+===== DATA SOURCES REQUIRED =====
+# INPUT:
+# - ticker symbols (array)
+# - end_date (string)
+# - FINANCIAL_DATASETS_API_KEY
+#
+# OUTPUT:
+# - Financial metrics: ROE, D/E, Current Ratio
+# - Financial line items: Revenue, Net Income, FCF, Debt, Equity, Retained Earnings, Operating Margin, R&D, Shares
+# - Market Cap
+#
+# PARAMETERS:
+# - period="annual"
+# - limit=10 years
+"""
+
from fincept_terminal.Agents.src.graph.state import AgentState, show_agent_reasoning
from fincept_terminal.Agents.src.tools.api import get_financial_metrics, get_market_cap, search_line_items
from langchain_core.prompts import ChatPromptTemplate