Append-only markdown log of trading decisions and reflections.

A vendor returned no usable rows for a symbol (empty result or stale data). Carries both the symbol the user requested and the canonical symbol t

Structured transaction proposal produced by the Trader. The trader reads the Research Manager's investment plan and the analyst reports, then

Calls every bound tool once, then answers with TEXT.

Structured sentiment report produced by the Sentiment Analyst. Replaces the previous free-form prose output so downstream consumers (dashboar

A vendor could not answer: it throttled or failed the request. Says nothing about the instrument; the router skips to the next vendor.

Structured output produced by the Portfolio Manager. The model fills every field as part of its primary LLM call; no separate extraction pass

Handles conditional logic for determining graph flow.

Handles reflection on trading decisions.

Handles state initialization and propagation through the graph.

Structured investment plan produced by the Research Manager. Hand-off to the Trader: the recommendation pins the directional view, the ration

Minimal urlopen() context-manager stub returning a JSON body.

Client for Google Gemini models.

Client for OpenAI, Ollama, OpenRouter, and xAI providers. For native OpenAI models, uses the Responses API (/v1/responses) which supports rea

Raised when Alpha Vantage is selected but no API key is configured. A VendorNotConfiguredError (and thus still a ValueError), so the routing

DeepSeek-specific overrides on top of the OpenAI-compatible client. Thinking-mode round-trip is the only DeepSeek-specific behavior that stay

Main class that orchestrates the trading agents framework.

Records the lifecycle calls run_analysis makes.

Raised when the Alpha Vantage API rate limit is exceeded.

Calls a tool on every turn it is offered one (#1420).

What a settlement pass did: the decisions it settled and those it could not.

A System One request that did not produce answers.

Client for Anthropic Claude models.

Client for Azure OpenAI deployments. Requires environment variables: AZURE_OPENAI_API_KEY: API key AZURE_OPENAI_ENDPOINT: Endpoin

Client for Amazon Bedrock via the Converse API (langchain-aws). Authentication is either a Bedrock API key (bearer token) via ``AWS_BEARER_TO

Raised when FRED is selected but no API key is configured. A VendorNotConfiguredError (and thus still a ValueError), so the routing layer's "

Handles the setup and configuration of the agent graph.

MiniMax-specific overrides on top of the OpenAI-compatible client. M2.x reasoning models embed ``<think>...</think>`` blocks directly in ``me

What an OpenAI-compatible model accepts at the API level.

AzureChatOpenAI with normalized content output.

ChatAnthropic with normalized content output. Claude models with extended thinking or tool use return content as a list of typed blocks. This

ChatGoogleGenerativeAI with normalized content output. Gemini 3 models return content as list of typed blocks. This normalizes to string for

Declarative config for one OpenAI-compatible provider. The OpenAI-compatible family (OpenAI, xAI, DeepSeek, Qwen, GLM, MiniMax, OpenRouter, O

Callback handler that tracks LLM calls, tool calls, and token usage.

ScriptedModel that records each call's graph step, prompt and timing.

Abstract base class for LLM clients.

OpenAI-compatible client for arbitrary local servers (LM Studio, vLLM, llama.cpp via the generic ``openai_compatible`` provider). Their tool-

ChatBedrockConverse with normalized (string) content output.

ChatOpenAI with normalized content output and capability-aware binding. The Responses API returns content as a list of typed blocks (reasonin

5-tier rating used by the Research Manager and Portfolio Manager.