ellements 0.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. ellements/__init__.py +57 -0
  2. ellements/agents/__init__.py +45 -0
  3. ellements/agents/backend.py +100 -0
  4. ellements/agents/builder.py +303 -0
  5. ellements/agents/claude_backend.py +200 -0
  6. ellements/agents/controller.py +237 -0
  7. ellements/agents/openai_backend.py +187 -0
  8. ellements/agents/py.typed +0 -0
  9. ellements/agents/runner.py +358 -0
  10. ellements/agents/tools.py +30 -0
  11. ellements/benchmarking/__init__.py +52 -0
  12. ellements/benchmarking/harness.py +342 -0
  13. ellements/benchmarking/py.typed +0 -0
  14. ellements/benchmarking/results.py +173 -0
  15. ellements/cli/__init__.py +80 -0
  16. ellements/cli/adapters.py +73 -0
  17. ellements/cli/agent_tui.py +1178 -0
  18. ellements/cli/components.py +411 -0
  19. ellements/cli/printer.py +229 -0
  20. ellements/cli/py.typed +0 -0
  21. ellements/core/__init__.py +112 -0
  22. ellements/core/async_utils.py +42 -0
  23. ellements/core/budgeting/__init__.py +43 -0
  24. ellements/core/budgeting/client.py +276 -0
  25. ellements/core/budgeting/protocol.py +51 -0
  26. ellements/core/budgeting/trackers.py +177 -0
  27. ellements/core/caching/__init__.py +51 -0
  28. ellements/core/caching/cache.py +73 -0
  29. ellements/core/caching/client.py +300 -0
  30. ellements/core/caching/disk.py +128 -0
  31. ellements/core/caching/keys.py +97 -0
  32. ellements/core/caching/memory.py +104 -0
  33. ellements/core/chunking.py +262 -0
  34. ellements/core/config.py +180 -0
  35. ellements/core/exceptions.py +145 -0
  36. ellements/core/llm/__init__.py +46 -0
  37. ellements/core/llm/client.py +1124 -0
  38. ellements/core/llm/images.py +226 -0
  39. ellements/core/llm/messages.py +202 -0
  40. ellements/core/llm/model_params.py +66 -0
  41. ellements/core/llm/protocol.py +146 -0
  42. ellements/core/llm/requests.py +100 -0
  43. ellements/core/llm/structured.py +91 -0
  44. ellements/core/llm/wrapper.py +79 -0
  45. ellements/core/observability/__init__.py +39 -0
  46. ellements/core/observability/events.py +169 -0
  47. ellements/core/observability/jsonl_logger.py +244 -0
  48. ellements/core/observability/markdown_formatter.py +197 -0
  49. ellements/core/observability/observer.py +56 -0
  50. ellements/core/prompting/__init__.py +14 -0
  51. ellements/core/prompting/context.py +185 -0
  52. ellements/core/prompting/guideline.py +133 -0
  53. ellements/core/prompting/persona.py +267 -0
  54. ellements/core/prompting/sources.py +92 -0
  55. ellements/core/py.typed +0 -0
  56. ellements/core/rate_limit/__init__.py +44 -0
  57. ellements/core/rate_limit/bucket.py +85 -0
  58. ellements/core/rate_limit/client.py +216 -0
  59. ellements/core/rate_limit/protocol.py +27 -0
  60. ellements/core/templating.py +126 -0
  61. ellements/core/tools/__init__.py +51 -0
  62. ellements/core/tools/dialects.py +136 -0
  63. ellements/core/tools/executor.py +48 -0
  64. ellements/core/tools/protocol.py +36 -0
  65. ellements/core/tools/records.py +28 -0
  66. ellements/core/tools/registry.py +205 -0
  67. ellements/core/tools/schemas.py +80 -0
  68. ellements/core/tools/simple.py +119 -0
  69. ellements/core/tools/spec.py +33 -0
  70. ellements/domain_specific/__init__.py +7 -0
  71. ellements/domain_specific/finance/__init__.py +188 -0
  72. ellements/domain_specific/finance/calculations.py +837 -0
  73. ellements/domain_specific/finance/charts.py +426 -0
  74. ellements/domain_specific/finance/portfolio.py +129 -0
  75. ellements/domain_specific/finance/quant_analysis.py +279 -0
  76. ellements/domain_specific/finance/risk.py +362 -0
  77. ellements/domain_specific/finance/technical_indicators.py +241 -0
  78. ellements/domain_specific/finance/tools.py +483 -0
  79. ellements/domain_specific/finance/valuation.py +312 -0
  80. ellements/domain_specific/finance/yahoo_finance.py +1523 -0
  81. ellements/domain_specific/finance/yahoo_finance_models.py +321 -0
  82. ellements/domain_specific/py.typed +0 -0
  83. ellements/execution/__init__.py +56 -0
  84. ellements/execution/callbacks.py +149 -0
  85. ellements/execution/catalog.py +70 -0
  86. ellements/execution/collaborative.py +191 -0
  87. ellements/execution/config.py +135 -0
  88. ellements/execution/py.typed +0 -0
  89. ellements/execution/reflection.py +156 -0
  90. ellements/execution/self_consistency.py +189 -0
  91. ellements/execution/single_call.py +48 -0
  92. ellements/execution/strategies.py +237 -0
  93. ellements/execution/tree_of_thought.py +541 -0
  94. ellements/fslm/__init__.py +108 -0
  95. ellements/fslm/builtins.py +103 -0
  96. ellements/fslm/cli.py +199 -0
  97. ellements/fslm/context.py +50 -0
  98. ellements/fslm/definition.py +163 -0
  99. ellements/fslm/det.py +173 -0
  100. ellements/fslm/dsl.py +458 -0
  101. ellements/fslm/errors.py +38 -0
  102. ellements/fslm/evaluators.py +141 -0
  103. ellements/fslm/kernel.py +603 -0
  104. ellements/fslm/loading.py +123 -0
  105. ellements/fslm/models.py +623 -0
  106. ellements/fslm/nl.py +87 -0
  107. ellements/fslm/observers.py +107 -0
  108. ellements/fslm/persistence.py +72 -0
  109. ellements/fslm/py.typed +0 -0
  110. ellements/fslm/rendering.py +551 -0
  111. ellements/fslm/visualization.py +25 -0
  112. ellements/reporting/__init__.py +12 -0
  113. ellements/reporting/charts.py +364 -0
  114. ellements/reporting/html_generation.py +132 -0
  115. ellements/reporting/py.typed +0 -0
  116. ellements/reporting/visualization.py +73 -0
  117. ellements/standard_tools/__init__.py +22 -0
  118. ellements/standard_tools/py.typed +0 -0
  119. ellements/standard_tools/terminal.py +205 -0
  120. ellements/standard_tools/web/__init__.py +37 -0
  121. ellements/standard_tools/web/browser_viewer.py +214 -0
  122. ellements/standard_tools/web/crawler.py +454 -0
  123. ellements/standard_tools/web/search.py +399 -0
  124. ellements/standard_tools/web/youtube.py +1297 -0
  125. ellements-0.2.0.dist-info/METADATA +368 -0
  126. ellements-0.2.0.dist-info/RECORD +130 -0
  127. ellements-0.2.0.dist-info/WHEEL +5 -0
  128. ellements-0.2.0.dist-info/entry_points.txt +2 -0
  129. ellements-0.2.0.dist-info/licenses/LICENSE +42 -0
  130. ellements-0.2.0.dist-info/top_level.txt +1 -0
ellements/domain_specific/finance/__init__.py ADDED
@@ -0,0 +1,188 @@
1
+ """Financial data retrieval, analytics, valuation, and finance-specific tools."""
2
+
3
+ from .calculations import (
4
+ BondPrice,
5
+ BondYield,
6
+ CashFlowAnalysis,
7
+ CompoundingFrequency,
8
+ CompoundInterestResult,
9
+ DepreciationMethod,
10
+ DepreciationSchedule,
11
+ FinancialCalculator,
12
+ InvestmentMetrics,
13
+ LoanAmortization,
14
+ LoanSchedulePayment,
15
+ PaymentTiming,
16
+ calculator,
17
+ )
18
+ from .charts import (
19
+ TechnicalChartResult,
20
+ mplfinance_available,
21
+ render_technical_chart,
22
+ render_technical_chart_from_dataframe,
23
+ technical_chart_assets,
24
+ )
25
+ from .portfolio import (
26
+ PortfolioAccount,
27
+ PortfolioActivityEntry,
28
+ PortfolioDocument,
29
+ PortfolioMetadata,
30
+ PortfolioOwner,
31
+ PortfolioPosition,
32
+ PortfolioTargets,
33
+ PortfolioWatchAsset,
34
+ PortfolioWatchlist,
35
+ )
36
+ from .quant_analysis import (
37
+ AlignedReturnSeries,
38
+ QuantRiskSummary,
39
+ align_return_series,
40
+ generate_quantstats_tear_sheet,
41
+ quantstats_available,
42
+ risk_metrics_from_quant_summary,
43
+ summarize_quant_risk,
44
+ )
45
+ from .risk import (
46
+ PortfolioOptimizationResult,
47
+ PortfolioResult,
48
+ RiskMetrics,
49
+ calculate_beta,
50
+ calmar_ratio,
51
+ conditional_value_at_risk,
52
+ max_drawdown,
53
+ optimize_portfolio_min_variance,
54
+ portfolio_analysis,
55
+ portfolio_return,
56
+ portfolio_volatility,
57
+ risk_metrics,
58
+ sharpe_ratio,
59
+ simulated_portfolio_scenarios,
60
+ sortino_ratio,
61
+ value_at_risk,
62
+ )
63
+ from .technical_indicators import (
64
+ TechnicalIndicatorSnapshot,
65
+ compute_technical_indicators,
66
+ latest_indicator_snapshot,
67
+ talib_available,
68
+ )
69
+ from .tools import calculation_tools
70
+ from .valuation import (
71
+ DCFResult,
72
+ EquityValueResult,
73
+ FCFResult,
74
+ TerminalValueResult,
75
+ WACCResult,
76
+ capm,
77
+ dcf,
78
+ ev_to_equity,
79
+ fcfe,
80
+ fcff,
81
+ gordon_growth_model,
82
+ terminal_value_exit_multiple,
83
+ terminal_value_gordon,
84
+ wacc,
85
+ )
86
+ from .yahoo_finance import YahooFinanceSearcher, finance_tools
87
+ from .yahoo_finance_models import (
88
+ AssetInfo,
89
+ AssetProfile,
90
+ AssetQuote,
91
+ BalanceSheet,
92
+ CashFlowStatement,
93
+ EarningsData,
94
+ FinancialMetrics,
95
+ Fundamentals,
96
+ HistoricalData,
97
+ HistoricalPrice,
98
+ IncomeStatement,
99
+ SearchResult,
100
+ SearchResults,
101
+ )
102
+
103
+ __all__ = [
104
+ 'AlignedReturnSeries',
105
+ 'AssetInfo',
106
+ 'AssetProfile',
107
+ 'AssetQuote',
108
+ 'BalanceSheet',
109
+ 'BondPrice',
110
+ 'BondYield',
111
+ 'CashFlowAnalysis',
112
+ 'CashFlowStatement',
113
+ 'CompoundInterestResult',
114
+ 'CompoundingFrequency',
115
+ 'DCFResult',
116
+ 'DepreciationMethod',
117
+ 'DepreciationSchedule',
118
+ 'EarningsData',
119
+ 'EquityValueResult',
120
+ 'FCFResult',
121
+ 'FinancialCalculator',
122
+ 'FinancialMetrics',
123
+ 'Fundamentals',
124
+ 'HistoricalData',
125
+ 'HistoricalPrice',
126
+ 'IncomeStatement',
127
+ 'InvestmentMetrics',
128
+ 'LoanAmortization',
129
+ 'LoanSchedulePayment',
130
+ 'PaymentTiming',
131
+ 'PortfolioAccount',
132
+ 'PortfolioActivityEntry',
133
+ 'PortfolioDocument',
134
+ 'PortfolioMetadata',
135
+ 'PortfolioOptimizationResult',
136
+ 'PortfolioOwner',
137
+ 'PortfolioPosition',
138
+ 'PortfolioResult',
139
+ 'PortfolioTargets',
140
+ 'PortfolioWatchAsset',
141
+ 'PortfolioWatchlist',
142
+ 'QuantRiskSummary',
143
+ 'RiskMetrics',
144
+ 'SearchResult',
145
+ 'SearchResults',
146
+ 'TechnicalChartResult',
147
+ 'TechnicalIndicatorSnapshot',
148
+ 'TerminalValueResult',
149
+ 'WACCResult',
150
+ 'YahooFinanceSearcher',
151
+ 'align_return_series',
152
+ 'calculate_beta',
153
+ 'calculation_tools',
154
+ 'calculator',
155
+ 'calmar_ratio',
156
+ 'capm',
157
+ 'conditional_value_at_risk',
158
+ 'compute_technical_indicators',
159
+ 'dcf',
160
+ 'ev_to_equity',
161
+ 'fcfe',
162
+ 'fcff',
163
+ 'finance_tools',
164
+ 'generate_quantstats_tear_sheet',
165
+ 'gordon_growth_model',
166
+ 'latest_indicator_snapshot',
167
+ 'max_drawdown',
168
+ 'mplfinance_available',
169
+ 'optimize_portfolio_min_variance',
170
+ 'portfolio_analysis',
171
+ 'portfolio_return',
172
+ 'portfolio_volatility',
173
+ 'quantstats_available',
174
+ 'render_technical_chart',
175
+ 'render_technical_chart_from_dataframe',
176
+ 'risk_metrics',
177
+ 'risk_metrics_from_quant_summary',
178
+ 'sharpe_ratio',
179
+ 'simulated_portfolio_scenarios',
180
+ 'sortino_ratio',
181
+ 'summarize_quant_risk',
182
+ 'talib_available',
183
+ 'technical_chart_assets',
184
+ 'terminal_value_exit_multiple',
185
+ 'terminal_value_gordon',
186
+ 'value_at_risk',
187
+ 'wacc',
188
+ ]