dialectus-engine 0.4.0__tar.gz → 0.4.2__tar.gz

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 (84) hide show
  1. {dialectus_engine-0.4.0/dialectus_engine.egg-info → dialectus_engine-0.4.2}/PKG-INFO +20 -33
  2. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/README.md +15 -28
  3. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/__init__.py +1 -1
  4. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/config/openrouter_filters.json +7 -0
  5. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/base.py +3 -2
  6. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/oxford.py +3 -2
  7. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/parliamentary.py +2 -1
  8. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/public_forum.py +2 -1
  9. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/socratic.py +2 -1
  10. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/manager.py +20 -1
  11. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_filter_config.py +5 -1
  12. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2/dialectus_engine.egg-info}/PKG-INFO +20 -33
  13. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus_engine.egg-info/requires.txt +4 -4
  14. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/pyproject.toml +5 -5
  15. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/LICENSE +0 -0
  16. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/__init__.py +0 -0
  17. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/config/__init__.py +0 -0
  18. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/config/settings.py +0 -0
  19. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/__init__.py +0 -0
  20. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/context_builder.py +0 -0
  21. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/engine.py +0 -0
  22. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/judge_coordinator.py +0 -0
  23. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/models.py +0 -0
  24. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/prompt_builder.py +0 -0
  25. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/response_handler.py +0 -0
  26. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/round_manager.py +0 -0
  27. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/types.py +0 -0
  28. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/debate_engine/utils.py +0 -0
  29. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/__init__.py +0 -0
  30. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/registry.py +0 -0
  31. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/formats/topic_themes.py +0 -0
  32. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/judges/__init__.py +0 -0
  33. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/judges/ai_judge.py +0 -0
  34. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/judges/base.py +0 -0
  35. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/judges/ensemble_utils.py +0 -0
  36. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/judges/factory.py +0 -0
  37. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/__init__.py +0 -0
  38. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/anthropic/__init__.py +0 -0
  39. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/anthropic/anthropic_enhanced_model_info.py +0 -0
  40. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/anthropic/anthropic_model.py +0 -0
  41. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/anthropic/anthropic_model_filter.py +0 -0
  42. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/anthropic/anthropic_pricing.py +0 -0
  43. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/base_types.py +0 -0
  44. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/cache_manager.py +0 -0
  45. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openai/__init__.py +0 -0
  46. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openai/openai_enhanced_model_info.py +0 -0
  47. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openai/openai_model.py +0 -0
  48. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openai/openai_model_filter.py +0 -0
  49. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openai/openai_pricing.py +0 -0
  50. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_architecture.py +0 -0
  51. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_capability_extractor.py +0 -0
  52. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_enhanced_model_info.py +0 -0
  53. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_model.py +0 -0
  54. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_model_filter.py +0 -0
  55. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_models_response.py +0 -0
  56. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_pricing.py +0 -0
  57. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/openrouter/openrouter_top_provider.py +0 -0
  58. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/__init__.py +0 -0
  59. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/anthropic_provider.py +0 -0
  60. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/base_model_provider.py +0 -0
  61. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/exceptions.py +0 -0
  62. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/ollama_provider.py +0 -0
  63. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/open_router_provider.py +0 -0
  64. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/openai_compatible_provider.py +0 -0
  65. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/openai_provider.py +0 -0
  66. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/openrouter_generation_types.py +0 -0
  67. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/models/providers/providers.py +0 -0
  68. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/moderation/__init__.py +0 -0
  69. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/moderation/base_moderator.py +0 -0
  70. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/moderation/exceptions.py +0 -0
  71. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/moderation/llm_moderator.py +0 -0
  72. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/moderation/manager.py +0 -0
  73. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus/engine/moderation/openai_moderator.py +0 -0
  74. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus_engine.egg-info/SOURCES.txt +0 -0
  75. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus_engine.egg-info/dependency_links.txt +0 -0
  76. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/dialectus_engine.egg-info/top_level.txt +0 -0
  77. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/setup.cfg +0 -0
  78. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_cache_manager.py +0 -0
  79. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_config_settings.py +0 -0
  80. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_debate_models.py +0 -0
  81. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_format_registry.py +0 -0
  82. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_formats_base.py +0 -0
  83. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_judges_factory.py +0 -0
  84. {dialectus_engine-0.4.0 → dialectus_engine-0.4.2}/tests/test_moderation_openai.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dialectus-engine
3
- Version: 0.4.0
3
+ Version: 0.4.2
4
4
  Summary: Dialectus AI debate engine framework
5
5
  Author: Dialectus AI
6
6
  License-Expression: MIT
@@ -24,14 +24,15 @@ Requires-Dist: httpx>=0.28.1
24
24
  Requires-Dist: openai>=1.105.0
25
25
  Requires-Dist: pydantic>=2.11.7
26
26
  Provides-Extra: dev
27
- Requires-Dist: ruff>=0.5.0; extra == "dev"
28
- Requires-Dist: pytest>=7.0; extra == "dev"
29
- Requires-Dist: twine; extra == "dev"
27
+ Requires-Dist: ruff>=0.14.2; extra == "dev"
28
+ Requires-Dist: pytest>=8.4.2; extra == "dev"
29
+ Requires-Dist: twine>=6.2.0; extra == "dev"
30
30
  Requires-Dist: build; extra == "dev"
31
- Requires-Dist: pyright>=1.1.377; extra == "dev"
31
+ Requires-Dist: pyright>=1.1.407; extra == "dev"
32
32
  Dynamic: license-file
33
33
 
34
- <img src="https://raw.githubusercontent.com/dialectus-ai/dialectus-engine/main/assets/logo.png" alt="Dialectus Engine" width="350">
34
+
35
+ <img width="500" height="117" alt="dialectus-logo-horz" src="https://github.com/user-attachments/assets/438b8963-0652-4886-acd1-5c197040c606" />
35
36
 
36
37
  <br />
37
38
 
@@ -41,7 +42,6 @@ A Python library for orchestrating AI-powered debates with multi-provider model
41
42
 
42
43
  ![Python](https://img.shields.io/badge/python-3.12+-blue.svg)
43
44
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
44
- ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
45
45
 
46
46
  > **Ready-to-Use CLI:** Want to run debates right away? Check out the [dialectus-cli](https://github.com/dialectus-ai/dialectus-cli) - a command-line interface that uses this engine to run debates locally with a beautiful terminal UI.
47
47
 
@@ -49,10 +49,6 @@ A Python library for orchestrating AI-powered debates with multi-provider model
49
49
 
50
50
  The Dialectus Engine is a standalone Python library that provides core debate orchestration logic, including participant coordination, turn management, AI judge integration, and multi-provider model support. It's designed to be imported and used by other applications to build debate systems.
51
51
 
52
- **Applications using this engine:**
53
- - **[dialectus-cli](https://github.com/dialectus-ai/dialectus-cli)** - Command-line interface with Rich terminal UI and SQLite storage
54
- - **dialectus-web** - Web application with React frontend and FastAPI backend (private repository)
55
-
56
52
  ## Components
57
53
 
58
54
  - **Core Engine** (`debate_engine/`) - Main debate orchestration logic
@@ -129,26 +125,20 @@ pip install git+https://github.com/dialectus-ai/dialectus-engine.git@main
129
125
 
130
126
  ```python
131
127
  import asyncio
132
- from debate_engine.core import DebateEngine
133
- from models.manager import ModelManager
134
- from config.settings import AppConfig, ModelConfig
128
+ from pathlib import Path
129
+ from dialectus.engine.debate_engine import DebateEngine
130
+ from dialectus.engine.models.manager import ModelManager
131
+ from dialectus.engine.config.settings import AppConfig
135
132
 
136
133
  async def run_debate():
137
134
  # Load configuration
138
- config = AppConfig.from_json_file("debate_config.json")
135
+ config = AppConfig.load_from_file(Path("debate_config.json"))
139
136
 
140
- # Set up model manager
141
- model_manager = ModelManager()
142
-
143
- # Register models
144
- for model_id, model_config in config.models.items():
145
- model_manager.register_model(model_id, model_config)
137
+ # Create model manager from config
138
+ model_manager = ModelManager.from_config(config)
146
139
 
147
140
  # Create debate engine
148
- engine = DebateEngine(
149
- config=config,
150
- model_manager=model_manager
151
- )
141
+ engine = DebateEngine(config=config, model_manager=model_manager)
152
142
 
153
143
  # Run debate
154
144
  transcript = await engine.run_debate()
@@ -279,8 +269,8 @@ pip install -e ".[dev]"
279
269
 
280
270
  ### Multi-Provider Model Support
281
271
  - **Ollama**: Local model management with hardware optimization
282
- - **OpenRouter**: Cloud model access to 100+ models
283
- - **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
272
+ - **OpenRouter**: Cloud model access to a wide variety of models
273
+ - **Anthropic**: Direct access to Claude models
284
274
  - **Async streaming**: Chunk-by-chunk response generation for all providers
285
275
  - **Auto-discovery**: Dynamic model listing from all configured providers
286
276
  - **Caching**: In-memory cache with TTL for model metadata
@@ -428,12 +418,9 @@ To use Anthropic's Claude models, you'll need an API key:
428
418
  }
429
419
  ```
430
420
 
431
- **Available Claude models:**
432
- - `claude-3-5-sonnet-20241022` - Latest, most intelligent (best for debates)
433
- - `claude-3-5-haiku-20241022` - Fastest and most economical
434
- - `claude-3-opus-20240229` - Most capable Claude 3 model
435
- - `claude-3-sonnet-20240229` - Balanced performance
436
- - `claude-3-haiku-20240307` - Budget-friendly option
421
+ **Finding available models:**
422
+
423
+ Anthropic provides a `/v1/models` API endpoint to list available models. You can also check [Anthropic's model documentation](https://docs.anthropic.com/en/docs/models-overview) for the latest models and their capabilities.
437
424
 
438
425
  ### OpenRouter
439
426
 
@@ -1,4 +1,5 @@
1
- <img src="https://raw.githubusercontent.com/dialectus-ai/dialectus-engine/main/assets/logo.png" alt="Dialectus Engine" width="350">
1
+
2
+ <img width="500" height="117" alt="dialectus-logo-horz" src="https://github.com/user-attachments/assets/438b8963-0652-4886-acd1-5c197040c606" />
2
3
 
3
4
  <br />
4
5
 
@@ -8,7 +9,6 @@ A Python library for orchestrating AI-powered debates with multi-provider model
8
9
 
9
10
  ![Python](https://img.shields.io/badge/python-3.12+-blue.svg)
10
11
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
11
- ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
12
12
 
13
13
  > **Ready-to-Use CLI:** Want to run debates right away? Check out the [dialectus-cli](https://github.com/dialectus-ai/dialectus-cli) - a command-line interface that uses this engine to run debates locally with a beautiful terminal UI.
14
14
 
@@ -16,10 +16,6 @@ A Python library for orchestrating AI-powered debates with multi-provider model
16
16
 
17
17
  The Dialectus Engine is a standalone Python library that provides core debate orchestration logic, including participant coordination, turn management, AI judge integration, and multi-provider model support. It's designed to be imported and used by other applications to build debate systems.
18
18
 
19
- **Applications using this engine:**
20
- - **[dialectus-cli](https://github.com/dialectus-ai/dialectus-cli)** - Command-line interface with Rich terminal UI and SQLite storage
21
- - **dialectus-web** - Web application with React frontend and FastAPI backend (private repository)
22
-
23
19
  ## Components
24
20
 
25
21
  - **Core Engine** (`debate_engine/`) - Main debate orchestration logic
@@ -96,26 +92,20 @@ pip install git+https://github.com/dialectus-ai/dialectus-engine.git@main
96
92
 
97
93
  ```python
98
94
  import asyncio
99
- from debate_engine.core import DebateEngine
100
- from models.manager import ModelManager
101
- from config.settings import AppConfig, ModelConfig
95
+ from pathlib import Path
96
+ from dialectus.engine.debate_engine import DebateEngine
97
+ from dialectus.engine.models.manager import ModelManager
98
+ from dialectus.engine.config.settings import AppConfig
102
99
 
103
100
  async def run_debate():
104
101
  # Load configuration
105
- config = AppConfig.from_json_file("debate_config.json")
102
+ config = AppConfig.load_from_file(Path("debate_config.json"))
106
103
 
107
- # Set up model manager
108
- model_manager = ModelManager()
109
-
110
- # Register models
111
- for model_id, model_config in config.models.items():
112
- model_manager.register_model(model_id, model_config)
104
+ # Create model manager from config
105
+ model_manager = ModelManager.from_config(config)
113
106
 
114
107
  # Create debate engine
115
- engine = DebateEngine(
116
- config=config,
117
- model_manager=model_manager
118
- )
108
+ engine = DebateEngine(config=config, model_manager=model_manager)
119
109
 
120
110
  # Run debate
121
111
  transcript = await engine.run_debate()
@@ -246,8 +236,8 @@ pip install -e ".[dev]"
246
236
 
247
237
  ### Multi-Provider Model Support
248
238
  - **Ollama**: Local model management with hardware optimization
249
- - **OpenRouter**: Cloud model access to 100+ models
250
- - **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
239
+ - **OpenRouter**: Cloud model access to a wide variety of models
240
+ - **Anthropic**: Direct access to Claude models
251
241
  - **Async streaming**: Chunk-by-chunk response generation for all providers
252
242
  - **Auto-discovery**: Dynamic model listing from all configured providers
253
243
  - **Caching**: In-memory cache with TTL for model metadata
@@ -395,12 +385,9 @@ To use Anthropic's Claude models, you'll need an API key:
395
385
  }
396
386
  ```
397
387
 
398
- **Available Claude models:**
399
- - `claude-3-5-sonnet-20241022` - Latest, most intelligent (best for debates)
400
- - `claude-3-5-haiku-20241022` - Fastest and most economical
401
- - `claude-3-opus-20240229` - Most capable Claude 3 model
402
- - `claude-3-sonnet-20240229` - Balanced performance
403
- - `claude-3-haiku-20240307` - Budget-friendly option
388
+ **Finding available models:**
389
+
390
+ Anthropic provides a `/v1/models` API endpoint to list available models. You can also check [Anthropic's model documentation](https://docs.anthropic.com/en/docs/models-overview) for the latest models and their capabilities.
404
391
 
405
392
  ### OpenRouter
406
393
 
@@ -4,4 +4,4 @@ from pkgutil import extend_path
4
4
 
5
5
  __path__ = extend_path(__path__, __name__)
6
6
  __all__: list[str] = []
7
- __version__ = "0.4.0"
7
+ __version__ = "0.4.1"
@@ -117,6 +117,13 @@
117
117
  "-translator"
118
118
  ]
119
119
  },
120
+ {
121
+ "category": "batch_only_variants",
122
+ "description": "Batch-API-only model variants (e.g. ':batch' suffix) that reject chat/completions requests",
123
+ "patterns": [
124
+ ":batch$"
125
+ ]
126
+ },
120
127
  {
121
128
  "category": "jailbreak_variants",
122
129
  "description": "Problematic jailbreak model variants",
@@ -10,6 +10,7 @@ from dialectus.engine.formats.topic_themes import (
10
10
  TopicTheme,
11
11
  TopicTone,
12
12
  )
13
+ from dialectus.engine.models.providers.base_model_provider import ChatMessage
13
14
 
14
15
 
15
16
  @dataclass
@@ -114,7 +115,7 @@ class DebateFormat(ABC):
114
115
  self,
115
116
  theme: TopicTheme | None = None,
116
117
  tone: TopicTone | None = None,
117
- ) -> list[dict[str, str]]:
118
+ ) -> list[ChatMessage]:
118
119
  """Get format-specific messages for AI topic generation.
119
120
 
120
121
  Args:
@@ -122,7 +123,7 @@ class DebateFormat(ABC):
122
123
  tone: Optional specific tone/sub-theme for more granular control
123
124
 
124
125
  Returns:
125
- List of message dictionaries for the AI model
126
+ List of ChatMessage objects for the AI model
126
127
  """
127
128
  # Build the system prompt
128
129
  system_content = (
@@ -1,6 +1,7 @@
1
1
  """Oxford-style debate format implementation."""
2
2
 
3
3
  from dialectus.engine.debate_engine.types import DebatePhase
4
+ from dialectus.engine.models.providers.base_model_provider import ChatMessage
4
5
 
5
6
  from .base import DebateFormat, FormatPhase, Position
6
7
  from .topic_themes import TopicTheme, TopicTone
@@ -155,7 +156,7 @@ class OxfordFormat(DebateFormat):
155
156
  self,
156
157
  theme: TopicTheme | None = None,
157
158
  tone: TopicTone | None = None,
158
- ) -> list[dict[str, str]]:
159
+ ) -> list[ChatMessage]:
159
160
  """Get Oxford specific messages for AI topic generation.
160
161
 
161
162
  Args:
@@ -163,7 +164,7 @@ class OxfordFormat(DebateFormat):
163
164
  tone: Optional specific tone/sub-theme for more granular control
164
165
 
165
166
  Returns:
166
- List of message dictionaries for the AI model
167
+ List of ChatMessage objects for the AI model
167
168
  """
168
169
  # Customize system prompt for Oxford format
169
170
  oxford_system = (
@@ -1,6 +1,7 @@
1
1
  """Parliamentary debate format implementation."""
2
2
 
3
3
  from dialectus.engine.debate_engine.types import DebatePhase
4
+ from dialectus.engine.models.providers.base_model_provider import ChatMessage
4
5
 
5
6
  from .base import DebateFormat, FormatPhase, Position
6
7
  from .topic_themes import TopicTheme, TopicTone
@@ -137,7 +138,7 @@ class ParliamentaryFormat(DebateFormat):
137
138
  self,
138
139
  theme: TopicTheme | None = None,
139
140
  tone: TopicTone | None = None,
140
- ) -> list[dict[str, str]]:
141
+ ) -> list[ChatMessage]:
141
142
  """Get Parliamentary specific messages for AI topic generation.
142
143
 
143
144
  Args:
@@ -1,6 +1,7 @@
1
1
  """Public Forum Debate format implementation."""
2
2
 
3
3
  from dialectus.engine.debate_engine.types import DebatePhase
4
+ from dialectus.engine.models.providers.base_model_provider import ChatMessage
4
5
 
5
6
  from .base import DebateFormat, FormatPhase, Position
6
7
  from .topic_themes import TopicTheme, TopicTone
@@ -173,7 +174,7 @@ class PublicForumFormat(DebateFormat):
173
174
  self,
174
175
  theme: TopicTheme | None = None,
175
176
  tone: TopicTone | None = None,
176
- ) -> list[dict[str, str]]:
177
+ ) -> list[ChatMessage]:
177
178
  """Get Public Forum specific messages for AI topic generation.
178
179
 
179
180
  Args:
@@ -1,6 +1,7 @@
1
1
  """Socratic dialogue format implementation."""
2
2
 
3
3
  from dialectus.engine.debate_engine.types import DebatePhase
4
+ from dialectus.engine.models.providers.base_model_provider import ChatMessage
4
5
 
5
6
  from .base import DebateFormat, FormatPhase, Position
6
7
  from .topic_themes import TopicTheme, TopicTone
@@ -168,7 +169,7 @@ class SocraticFormat(DebateFormat):
168
169
  self,
169
170
  theme: TopicTheme | None = None,
170
171
  tone: TopicTone | None = None,
171
- ) -> list[dict[str, str]]:
172
+ ) -> list[ChatMessage]:
172
173
  """Get Socratic specific messages for AI topic generation.
173
174
 
174
175
  Args:
@@ -7,7 +7,7 @@ from collections.abc import AsyncIterator
7
7
  from contextlib import asynccontextmanager
8
8
  from typing import Protocol, Unpack, cast
9
9
 
10
- from dialectus.engine.config.settings import ModelConfig, SystemConfig
10
+ from dialectus.engine.config.settings import AppConfig, ModelConfig, SystemConfig
11
11
  from dialectus.engine.debate_engine.types import ChunkCallback
12
12
  from dialectus.engine.models.base_types import BaseEnhancedModelInfo
13
13
 
@@ -49,6 +49,25 @@ class ModelManager:
49
49
  self._model_configs: dict[str, ModelConfig] = {}
50
50
  self._providers: dict[str, BaseModelProvider] = {}
51
51
 
52
+ @classmethod
53
+ def from_config(cls, config: AppConfig) -> ModelManager:
54
+ """Create a ModelManager with all models from config pre-registered.
55
+
56
+ Args:
57
+ config: Complete application configuration
58
+
59
+ Returns:
60
+ ModelManager instance with all models registered
61
+
62
+ Example:
63
+ >>> config = AppConfig.load_from_file(Path("debate_config.json"))
64
+ >>> model_manager = ModelManager.from_config(config)
65
+ """
66
+ manager = cls(config.system)
67
+ for model_id, model_config in config.models.items():
68
+ manager.register_model(model_id, model_config)
69
+ return manager
70
+
52
71
  def _get_provider(self, provider_name: str) -> BaseModelProvider:
53
72
  """Return (and cache) the provider instance identified by name."""
54
73
  if provider_name not in self._providers:
@@ -102,7 +102,11 @@ class OpenRouterFilterConfig:
102
102
  "mixture.*expert",
103
103
  "moe",
104
104
  ],
105
- }
105
+ },
106
+ {
107
+ "category": "batch_only_variants",
108
+ "patterns": [":batch$"],
109
+ },
106
110
  ],
107
111
  "preview_patterns": [
108
112
  {
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dialectus-engine
3
- Version: 0.4.0
3
+ Version: 0.4.2
4
4
  Summary: Dialectus AI debate engine framework
5
5
  Author: Dialectus AI
6
6
  License-Expression: MIT
@@ -24,14 +24,15 @@ Requires-Dist: httpx>=0.28.1
24
24
  Requires-Dist: openai>=1.105.0
25
25
  Requires-Dist: pydantic>=2.11.7
26
26
  Provides-Extra: dev
27
- Requires-Dist: ruff>=0.5.0; extra == "dev"
28
- Requires-Dist: pytest>=7.0; extra == "dev"
29
- Requires-Dist: twine; extra == "dev"
27
+ Requires-Dist: ruff>=0.14.2; extra == "dev"
28
+ Requires-Dist: pytest>=8.4.2; extra == "dev"
29
+ Requires-Dist: twine>=6.2.0; extra == "dev"
30
30
  Requires-Dist: build; extra == "dev"
31
- Requires-Dist: pyright>=1.1.377; extra == "dev"
31
+ Requires-Dist: pyright>=1.1.407; extra == "dev"
32
32
  Dynamic: license-file
33
33
 
34
- <img src="https://raw.githubusercontent.com/dialectus-ai/dialectus-engine/main/assets/logo.png" alt="Dialectus Engine" width="350">
34
+
35
+ <img width="500" height="117" alt="dialectus-logo-horz" src="https://github.com/user-attachments/assets/438b8963-0652-4886-acd1-5c197040c606" />
35
36
 
36
37
  <br />
37
38
 
@@ -41,7 +42,6 @@ A Python library for orchestrating AI-powered debates with multi-provider model
41
42
 
42
43
  ![Python](https://img.shields.io/badge/python-3.12+-blue.svg)
43
44
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
44
- ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
45
45
 
46
46
  > **Ready-to-Use CLI:** Want to run debates right away? Check out the [dialectus-cli](https://github.com/dialectus-ai/dialectus-cli) - a command-line interface that uses this engine to run debates locally with a beautiful terminal UI.
47
47
 
@@ -49,10 +49,6 @@ A Python library for orchestrating AI-powered debates with multi-provider model
49
49
 
50
50
  The Dialectus Engine is a standalone Python library that provides core debate orchestration logic, including participant coordination, turn management, AI judge integration, and multi-provider model support. It's designed to be imported and used by other applications to build debate systems.
51
51
 
52
- **Applications using this engine:**
53
- - **[dialectus-cli](https://github.com/dialectus-ai/dialectus-cli)** - Command-line interface with Rich terminal UI and SQLite storage
54
- - **dialectus-web** - Web application with React frontend and FastAPI backend (private repository)
55
-
56
52
  ## Components
57
53
 
58
54
  - **Core Engine** (`debate_engine/`) - Main debate orchestration logic
@@ -129,26 +125,20 @@ pip install git+https://github.com/dialectus-ai/dialectus-engine.git@main
129
125
 
130
126
  ```python
131
127
  import asyncio
132
- from debate_engine.core import DebateEngine
133
- from models.manager import ModelManager
134
- from config.settings import AppConfig, ModelConfig
128
+ from pathlib import Path
129
+ from dialectus.engine.debate_engine import DebateEngine
130
+ from dialectus.engine.models.manager import ModelManager
131
+ from dialectus.engine.config.settings import AppConfig
135
132
 
136
133
  async def run_debate():
137
134
  # Load configuration
138
- config = AppConfig.from_json_file("debate_config.json")
135
+ config = AppConfig.load_from_file(Path("debate_config.json"))
139
136
 
140
- # Set up model manager
141
- model_manager = ModelManager()
142
-
143
- # Register models
144
- for model_id, model_config in config.models.items():
145
- model_manager.register_model(model_id, model_config)
137
+ # Create model manager from config
138
+ model_manager = ModelManager.from_config(config)
146
139
 
147
140
  # Create debate engine
148
- engine = DebateEngine(
149
- config=config,
150
- model_manager=model_manager
151
- )
141
+ engine = DebateEngine(config=config, model_manager=model_manager)
152
142
 
153
143
  # Run debate
154
144
  transcript = await engine.run_debate()
@@ -279,8 +269,8 @@ pip install -e ".[dev]"
279
269
 
280
270
  ### Multi-Provider Model Support
281
271
  - **Ollama**: Local model management with hardware optimization
282
- - **OpenRouter**: Cloud model access to 100+ models
283
- - **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
272
+ - **OpenRouter**: Cloud model access to a wide variety of models
273
+ - **Anthropic**: Direct access to Claude models
284
274
  - **Async streaming**: Chunk-by-chunk response generation for all providers
285
275
  - **Auto-discovery**: Dynamic model listing from all configured providers
286
276
  - **Caching**: In-memory cache with TTL for model metadata
@@ -428,12 +418,9 @@ To use Anthropic's Claude models, you'll need an API key:
428
418
  }
429
419
  ```
430
420
 
431
- **Available Claude models:**
432
- - `claude-3-5-sonnet-20241022` - Latest, most intelligent (best for debates)
433
- - `claude-3-5-haiku-20241022` - Fastest and most economical
434
- - `claude-3-opus-20240229` - Most capable Claude 3 model
435
- - `claude-3-sonnet-20240229` - Balanced performance
436
- - `claude-3-haiku-20240307` - Budget-friendly option
421
+ **Finding available models:**
422
+
423
+ Anthropic provides a `/v1/models` API endpoint to list available models. You can also check [Anthropic's model documentation](https://docs.anthropic.com/en/docs/models-overview) for the latest models and their capabilities.
437
424
 
438
425
  ### OpenRouter
439
426
 
@@ -3,8 +3,8 @@ openai>=1.105.0
3
3
  pydantic>=2.11.7
4
4
 
5
5
  [dev]
6
- ruff>=0.5.0
7
- pytest>=7.0
8
- twine
6
+ ruff>=0.14.2
7
+ pytest>=8.4.2
8
+ twine>=6.2.0
9
9
  build
10
- pyright>=1.1.377
10
+ pyright>=1.1.407
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "dialectus-engine"
7
- version = "0.4.0"
7
+ version = "0.4.2"
8
8
  description = "Dialectus AI debate engine framework"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -37,11 +37,11 @@ Issues = "https://github.com/dialectus-ai/dialectus-engine/issues"
37
37
 
38
38
  [project.optional-dependencies]
39
39
  dev = [
40
- "ruff>=0.5.0",
41
- "pytest>=7.0",
42
- "twine",
40
+ "ruff>=0.14.2",
41
+ "pytest>=8.4.2",
42
+ "twine>=6.2.0",
43
43
  "build",
44
- "pyright>=1.1.377"
44
+ "pyright>=1.1.407"
45
45
  ]
46
46
 
47
47
  [tool.setuptools]