dialectus-engine 0.3.0__tar.gz → 0.4.0__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 (86) hide show
  1. {dialectus_engine-0.3.0/dialectus_engine.egg-info → dialectus_engine-0.4.0}/PKG-INFO +119 -4
  2. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/README.md +118 -3
  3. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/__init__.py +1 -1
  4. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/config/settings.py +104 -17
  5. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/context_builder.py +11 -7
  6. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/engine.py +8 -11
  7. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/round_manager.py +26 -23
  8. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/types.py +8 -6
  9. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/utils.py +11 -6
  10. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/ai_judge.py +20 -9
  11. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/base.py +32 -43
  12. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/ensemble_utils.py +44 -29
  13. dialectus_engine-0.4.0/dialectus/engine/models/__init__.py +17 -0
  14. dialectus_engine-0.4.0/dialectus/engine/models/anthropic/__init__.py +15 -0
  15. dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_enhanced_model_info.py +68 -0
  16. dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_model.py +101 -0
  17. dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_model_filter.py +133 -0
  18. dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_pricing.py +31 -0
  19. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/base_types.py +6 -1
  20. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/manager.py +12 -8
  21. dialectus_engine-0.4.0/dialectus/engine/models/openai/__init__.py +14 -0
  22. dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_enhanced_model_info.py +59 -0
  23. dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_model.py +96 -0
  24. dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_model_filter.py +108 -0
  25. dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_pricing.py +31 -0
  26. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_filter_config.py +3 -1
  27. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/__init__.py +2 -0
  28. dialectus_engine-0.4.0/dialectus/engine/models/providers/anthropic_provider.py +202 -0
  29. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/base_model_provider.py +31 -9
  30. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/ollama_provider.py +66 -60
  31. dialectus_engine-0.4.0/dialectus/engine/models/providers/open_router_provider.py +306 -0
  32. dialectus_engine-0.4.0/dialectus/engine/models/providers/openai_compatible_provider.py +573 -0
  33. dialectus_engine-0.4.0/dialectus/engine/models/providers/openai_provider.py +174 -0
  34. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/openrouter_generation_types.py +44 -3
  35. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/providers.py +4 -0
  36. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/openai_moderator.py +20 -55
  37. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0/dialectus_engine.egg-info}/PKG-INFO +119 -4
  38. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/SOURCES.txt +26 -0
  39. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/pyproject.toml +2 -1
  40. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_config_settings.py +13 -5
  41. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_moderation_openai.py +39 -6
  42. dialectus_engine-0.3.0/dialectus/engine/models/__init__.py +0 -1
  43. dialectus_engine-0.3.0/dialectus/engine/models/providers/open_router_provider.py +0 -755
  44. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/LICENSE +0 -0
  45. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/__init__.py +0 -0
  46. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/config/__init__.py +0 -0
  47. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/config/openrouter_filters.json +0 -0
  48. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/__init__.py +0 -0
  49. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/judge_coordinator.py +0 -0
  50. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/models.py +0 -0
  51. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/prompt_builder.py +0 -0
  52. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/response_handler.py +0 -0
  53. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/__init__.py +0 -0
  54. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/base.py +0 -0
  55. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/oxford.py +0 -0
  56. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/parliamentary.py +0 -0
  57. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/public_forum.py +0 -0
  58. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/registry.py +0 -0
  59. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/socratic.py +0 -0
  60. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/topic_themes.py +0 -0
  61. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/__init__.py +0 -0
  62. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/factory.py +0 -0
  63. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/cache_manager.py +0 -0
  64. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_architecture.py +0 -0
  65. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_capability_extractor.py +0 -0
  66. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_enhanced_model_info.py +0 -0
  67. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_model.py +0 -0
  68. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_model_filter.py +0 -0
  69. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_models_response.py +0 -0
  70. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_pricing.py +0 -0
  71. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_top_provider.py +0 -0
  72. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/exceptions.py +0 -0
  73. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/__init__.py +0 -0
  74. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/base_moderator.py +0 -0
  75. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/exceptions.py +0 -0
  76. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/llm_moderator.py +0 -0
  77. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/manager.py +0 -0
  78. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/dependency_links.txt +0 -0
  79. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/requires.txt +0 -0
  80. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/top_level.txt +0 -0
  81. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/setup.cfg +0 -0
  82. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_cache_manager.py +0 -0
  83. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_debate_models.py +0 -0
  84. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_format_registry.py +0 -0
  85. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_formats_base.py +0 -0
  86. {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_judges_factory.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dialectus-engine
3
- Version: 0.3.0
3
+ Version: 0.4.0
4
4
  Summary: Dialectus AI debate engine framework
5
5
  Author: Dialectus AI
6
6
  License-Expression: MIT
@@ -43,14 +43,20 @@ A Python library for orchestrating AI-powered debates with multi-provider model
43
43
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
44
44
  ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
45
45
 
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
+
46
48
  ## Overview
47
49
 
48
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.
49
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
+
50
56
  ## Components
51
57
 
52
58
  - **Core Engine** (`debate_engine/`) - Main debate orchestration logic
53
- - **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter)
59
+ - **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter, Anthropic)
54
60
  - **Configuration** (`config/`) - System configuration management
55
61
  - **Judges** (`judges/`) - AI judge implementations with ensemble support
56
62
  - **Formats** (`formats/`) - Debate format definitions (Oxford, Parliamentary, Socratic, Public Forum)
@@ -170,7 +176,7 @@ cp debate_config.example.json debate_config.json
170
176
 
171
177
  Key configuration sections:
172
178
  - **Models**: Define debate participants with provider, personality, and parameters
173
- - **Providers**: Configure Ollama (local) and OpenRouter (cloud) settings
179
+ - **Providers**: Configure Ollama (local), OpenRouter (cloud), and Anthropic (cloud) settings
174
180
  - **Judging**: Set evaluation criteria and judge models
175
181
  - **Debate**: Default topic, format, and word limits
176
182
  - **Moderation** (optional): Content safety for user-provided topics
@@ -274,9 +280,11 @@ pip install -e ".[dev]"
274
280
  ### Multi-Provider Model Support
275
281
  - **Ollama**: Local model management with hardware optimization
276
282
  - **OpenRouter**: Cloud model access to 100+ models
277
- - **Async streaming**: Chunk-by-chunk response generation
283
+ - **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
284
+ - **Async streaming**: Chunk-by-chunk response generation for all providers
278
285
  - **Auto-discovery**: Dynamic model listing from all configured providers
279
286
  - **Caching**: In-memory cache with TTL for model metadata
287
+ - **Cost tracking**: Token usage and cost calculation for cloud providers
280
288
 
281
289
  ### Debate Formats
282
290
  - **Oxford**: Classic opening/rebuttal/closing structure
@@ -375,3 +383,110 @@ except TopicRejectedError as e:
375
383
  ```
376
384
 
377
385
  For comprehensive moderation testing and setup instructions, see [MODERATION_TESTING.md](MODERATION_TESTING.md).
386
+
387
+ ## Provider Setup
388
+
389
+ ### Anthropic (Claude Models)
390
+
391
+ To use Anthropic's Claude models, you'll need an API key:
392
+
393
+ 1. **Get an API key**: Sign up at [console.anthropic.com](https://console.anthropic.com/)
394
+
395
+ 2. **Set your API key** (choose one method):
396
+
397
+ **Environment variable (recommended):**
398
+ ```bash
399
+ export ANTHROPIC_API_KEY="sk-ant-api03-..."
400
+ ```
401
+
402
+ **Or in `debate_config.json`:**
403
+ ```json
404
+ {
405
+ "system": {
406
+ "anthropic": {
407
+ "api_key": "sk-ant-api03-...",
408
+ "base_url": "https://api.anthropic.com/v1",
409
+ "max_retries": 3,
410
+ "timeout": 60
411
+ }
412
+ }
413
+ }
414
+ ```
415
+
416
+ 3. **Configure a model**:
417
+ ```json
418
+ {
419
+ "models": {
420
+ "model_a": {
421
+ "name": "claude-3-5-sonnet-20241022",
422
+ "provider": "anthropic",
423
+ "personality": "analytical",
424
+ "max_tokens": 300,
425
+ "temperature": 0.7
426
+ }
427
+ }
428
+ }
429
+ ```
430
+
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
437
+
438
+ ### OpenRouter
439
+
440
+ To use OpenRouter's model marketplace:
441
+
442
+ 1. **Get an API key**: Sign up at [openrouter.ai](https://openrouter.ai/)
443
+
444
+ 2. **Set your API key**:
445
+ ```bash
446
+ export OPENROUTER_API_KEY="sk-or-v1-..."
447
+ ```
448
+
449
+ 3. **Configure a model**:
450
+ ```json
451
+ {
452
+ "models": {
453
+ "model_a": {
454
+ "name": "anthropic/claude-3.5-sonnet",
455
+ "provider": "openrouter",
456
+ "personality": "analytical",
457
+ "max_tokens": 300,
458
+ "temperature": 0.7
459
+ }
460
+ }
461
+ }
462
+ ```
463
+
464
+ ### Ollama (Local Models)
465
+
466
+ To use local models via Ollama:
467
+
468
+ 1. **Install Ollama**: Download from [ollama.com](https://ollama.com/)
469
+
470
+ 2. **Pull models**:
471
+ ```bash
472
+ ollama pull llama3.2:3b
473
+ ollama pull qwen2.5:7b
474
+ ```
475
+
476
+ 3. **Configure**:
477
+ ```json
478
+ {
479
+ "models": {
480
+ "model_a": {
481
+ "name": "llama3.2:3b",
482
+ "provider": "ollama",
483
+ "personality": "analytical",
484
+ "max_tokens": 300,
485
+ "temperature": 0.7
486
+ }
487
+ },
488
+ "system": {
489
+ "ollama_base_url": "http://localhost:11434"
490
+ }
491
+ }
492
+ ```
@@ -10,14 +10,20 @@ A Python library for orchestrating AI-powered debates with multi-provider model
10
10
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
11
11
  ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
12
12
 
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
+
13
15
  ## Overview
14
16
 
15
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.
16
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
+
17
23
  ## Components
18
24
 
19
25
  - **Core Engine** (`debate_engine/`) - Main debate orchestration logic
20
- - **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter)
26
+ - **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter, Anthropic)
21
27
  - **Configuration** (`config/`) - System configuration management
22
28
  - **Judges** (`judges/`) - AI judge implementations with ensemble support
23
29
  - **Formats** (`formats/`) - Debate format definitions (Oxford, Parliamentary, Socratic, Public Forum)
@@ -137,7 +143,7 @@ cp debate_config.example.json debate_config.json
137
143
 
138
144
  Key configuration sections:
139
145
  - **Models**: Define debate participants with provider, personality, and parameters
140
- - **Providers**: Configure Ollama (local) and OpenRouter (cloud) settings
146
+ - **Providers**: Configure Ollama (local), OpenRouter (cloud), and Anthropic (cloud) settings
141
147
  - **Judging**: Set evaluation criteria and judge models
142
148
  - **Debate**: Default topic, format, and word limits
143
149
  - **Moderation** (optional): Content safety for user-provided topics
@@ -241,9 +247,11 @@ pip install -e ".[dev]"
241
247
  ### Multi-Provider Model Support
242
248
  - **Ollama**: Local model management with hardware optimization
243
249
  - **OpenRouter**: Cloud model access to 100+ models
244
- - **Async streaming**: Chunk-by-chunk response generation
250
+ - **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
251
+ - **Async streaming**: Chunk-by-chunk response generation for all providers
245
252
  - **Auto-discovery**: Dynamic model listing from all configured providers
246
253
  - **Caching**: In-memory cache with TTL for model metadata
254
+ - **Cost tracking**: Token usage and cost calculation for cloud providers
247
255
 
248
256
  ### Debate Formats
249
257
  - **Oxford**: Classic opening/rebuttal/closing structure
@@ -342,3 +350,110 @@ except TopicRejectedError as e:
342
350
  ```
343
351
 
344
352
  For comprehensive moderation testing and setup instructions, see [MODERATION_TESTING.md](MODERATION_TESTING.md).
353
+
354
+ ## Provider Setup
355
+
356
+ ### Anthropic (Claude Models)
357
+
358
+ To use Anthropic's Claude models, you'll need an API key:
359
+
360
+ 1. **Get an API key**: Sign up at [console.anthropic.com](https://console.anthropic.com/)
361
+
362
+ 2. **Set your API key** (choose one method):
363
+
364
+ **Environment variable (recommended):**
365
+ ```bash
366
+ export ANTHROPIC_API_KEY="sk-ant-api03-..."
367
+ ```
368
+
369
+ **Or in `debate_config.json`:**
370
+ ```json
371
+ {
372
+ "system": {
373
+ "anthropic": {
374
+ "api_key": "sk-ant-api03-...",
375
+ "base_url": "https://api.anthropic.com/v1",
376
+ "max_retries": 3,
377
+ "timeout": 60
378
+ }
379
+ }
380
+ }
381
+ ```
382
+
383
+ 3. **Configure a model**:
384
+ ```json
385
+ {
386
+ "models": {
387
+ "model_a": {
388
+ "name": "claude-3-5-sonnet-20241022",
389
+ "provider": "anthropic",
390
+ "personality": "analytical",
391
+ "max_tokens": 300,
392
+ "temperature": 0.7
393
+ }
394
+ }
395
+ }
396
+ ```
397
+
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
404
+
405
+ ### OpenRouter
406
+
407
+ To use OpenRouter's model marketplace:
408
+
409
+ 1. **Get an API key**: Sign up at [openrouter.ai](https://openrouter.ai/)
410
+
411
+ 2. **Set your API key**:
412
+ ```bash
413
+ export OPENROUTER_API_KEY="sk-or-v1-..."
414
+ ```
415
+
416
+ 3. **Configure a model**:
417
+ ```json
418
+ {
419
+ "models": {
420
+ "model_a": {
421
+ "name": "anthropic/claude-3.5-sonnet",
422
+ "provider": "openrouter",
423
+ "personality": "analytical",
424
+ "max_tokens": 300,
425
+ "temperature": 0.7
426
+ }
427
+ }
428
+ }
429
+ ```
430
+
431
+ ### Ollama (Local Models)
432
+
433
+ To use local models via Ollama:
434
+
435
+ 1. **Install Ollama**: Download from [ollama.com](https://ollama.com/)
436
+
437
+ 2. **Pull models**:
438
+ ```bash
439
+ ollama pull llama3.2:3b
440
+ ollama pull qwen2.5:7b
441
+ ```
442
+
443
+ 3. **Configure**:
444
+ ```json
445
+ {
446
+ "models": {
447
+ "model_a": {
448
+ "name": "llama3.2:3b",
449
+ "provider": "ollama",
450
+ "personality": "analytical",
451
+ "max_tokens": 300,
452
+ "temperature": 0.7
453
+ }
454
+ },
455
+ "system": {
456
+ "ollama_base_url": "http://localhost:11434"
457
+ }
458
+ }
459
+ ```
@@ -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.3.0"
7
+ __version__ = "0.4.0"
@@ -6,6 +6,25 @@ from typing import Literal
6
6
  from pydantic import BaseModel, Field, field_validator
7
7
 
8
8
 
9
+ def validate_provider_value(value: str, valid_providers: set[str]) -> str:
10
+ """Validate provider string against allowed values.
11
+
12
+ Args:
13
+ value: Provider name to validate
14
+ valid_providers: Set of valid provider names
15
+
16
+ Returns:
17
+ Lowercase provider name
18
+
19
+ Raises:
20
+ ValueError: If provider is not in valid_providers
21
+ """
22
+ normalized = value.lower()
23
+ if normalized not in valid_providers:
24
+ raise ValueError(f"Provider must be one of: {valid_providers}")
25
+ return normalized
26
+
27
+
9
28
  class ModelConfig(BaseModel):
10
29
  """Configuration for a debate model."""
11
30
 
@@ -24,11 +43,10 @@ class ModelConfig(BaseModel):
24
43
 
25
44
  @field_validator("provider")
26
45
  @classmethod
27
- def validate_provider(cls, v: str):
28
- valid_providers = {"ollama", "openrouter"}
29
- if v not in valid_providers:
30
- raise ValueError(f"Provider must be one of: {valid_providers}")
31
- return v
46
+ def validate_provider(cls, v: str) -> str:
47
+ return validate_provider_value(
48
+ v, {"ollama", "openrouter", "anthropic", "openai"}
49
+ )
32
50
 
33
51
 
34
52
  class DebateConfig(BaseModel):
@@ -93,9 +111,9 @@ class ModerationConfig(BaseModel):
93
111
 
94
112
  @field_validator("provider")
95
113
  @classmethod
96
- def validate_provider(cls, v: str):
114
+ def validate_provider(cls, v: str) -> str:
97
115
  # Provider names are case-insensitive
98
- # Ollama and openrouter have automatic URL/key resolution
116
+ # For moderation, we accept any provider (ollama, openrouter, openai, custom)
99
117
  # Custom providers require explicit base_url
100
118
  return v.lower()
101
119
 
@@ -153,6 +171,42 @@ class OpenRouterConfig(BaseModel):
153
171
  timeout: int = Field(default=60, description="API request timeout in seconds")
154
172
 
155
173
 
174
+ class OpenAIConfig(BaseModel):
175
+ """OpenAI-specific configuration."""
176
+
177
+ api_key: str | None = Field(
178
+ default=None,
179
+ description=(
180
+ "OpenAI API key (can also be set via OPENAI_API_KEY environment variable)"
181
+ ),
182
+ )
183
+ base_url: str = Field(
184
+ default="https://api.openai.com/v1", description="OpenAI API base URL"
185
+ )
186
+ max_retries: int = Field(
187
+ default=3, description="Maximum number of API call retries"
188
+ )
189
+ timeout: int = Field(default=60, description="API request timeout in seconds")
190
+
191
+
192
+ class AnthropicConfig(BaseModel):
193
+ """Anthropic-specific configuration."""
194
+
195
+ api_key: str | None = Field(
196
+ default=None,
197
+ description=(
198
+ "Anthropic API key (can also be set via ANTHROPIC_API_KEY env var)"
199
+ ),
200
+ )
201
+ base_url: str = Field(
202
+ default="https://api.anthropic.com/v1", description="Anthropic API base URL"
203
+ )
204
+ max_retries: int = Field(
205
+ default=3, description="Maximum number of API call retries"
206
+ )
207
+ timeout: int = Field(default=60, description="API request timeout in seconds")
208
+
209
+
156
210
  class SystemConfig(BaseModel):
157
211
  """System-wide configuration."""
158
212
 
@@ -168,12 +222,18 @@ class SystemConfig(BaseModel):
168
222
  openrouter: OpenRouterConfig = Field(
169
223
  default_factory=OpenRouterConfig, description="OpenRouter-specific settings"
170
224
  )
225
+ openai: OpenAIConfig = Field(
226
+ default_factory=OpenAIConfig, description="OpenAI-specific settings"
227
+ )
228
+ anthropic: AnthropicConfig = Field(
229
+ default_factory=AnthropicConfig, description="Anthropic-specific settings"
230
+ )
171
231
 
172
232
  # System settings
173
233
  log_level: Literal["DEBUG", "INFO", "WARNING", "ERROR"] = Field(default="INFO")
174
234
 
175
235
  # Topic generation settings
176
- debate_topic_source: Literal["ollama", "openrouter"] = Field(
236
+ debate_topic_source: Literal["ollama", "openrouter", "anthropic", "openai"] = Field(
177
237
  default="openrouter", description="Provider for topic generation model"
178
238
  )
179
239
  debate_topic_model: str = Field(
@@ -183,11 +243,10 @@ class SystemConfig(BaseModel):
183
243
 
184
244
  @field_validator("debate_topic_source")
185
245
  @classmethod
186
- def validate_topic_source(cls, v: str):
187
- valid_sources = {"ollama", "openrouter"}
188
- if v not in valid_sources:
189
- raise ValueError(f"debate_topic_source must be one of: {valid_sources}")
190
- return v
246
+ def validate_topic_source(cls, v: str) -> str:
247
+ return validate_provider_value(
248
+ v, {"ollama", "openrouter", "anthropic", "openai"}
249
+ )
191
250
 
192
251
 
193
252
  class AppConfig(BaseModel):
@@ -203,14 +262,26 @@ class AppConfig(BaseModel):
203
262
 
204
263
  @classmethod
205
264
  def load_from_file(cls, config_path: Path) -> "AppConfig":
206
- """Load configuration from JSON file."""
265
+ """Load configuration from JSON file.
266
+
267
+ Args:
268
+ config_path: Path to the JSON configuration file
269
+
270
+ Returns:
271
+ AppConfig instance loaded from the file
272
+
273
+ Raises:
274
+ FileNotFoundError: If config file doesn't exist
275
+ ValueError: If required sections are missing or invalid
276
+ """
207
277
  if not config_path.exists():
208
278
  raise FileNotFoundError(f"Config file not found: {config_path}")
209
279
 
280
+ # Use Pydantic's built-in JSON validation
210
281
  import json
211
282
 
212
- with open(config_path, encoding="utf-8") as f:
213
- data = json.load(f)
283
+ json_data = config_path.read_text(encoding="utf-8")
284
+ data = json.loads(json_data)
214
285
 
215
286
  # Validate required sections
216
287
  required_sections = ["debate", "models", "judging", "system"]
@@ -226,7 +297,7 @@ class AppConfig(BaseModel):
226
297
  "Config must include at least one model in 'models' section"
227
298
  )
228
299
 
229
- return cls(**data)
300
+ return cls.model_validate(data)
230
301
 
231
302
 
232
303
  def get_default_config() -> AppConfig:
@@ -301,6 +372,22 @@ def get_template_config() -> AppConfig:
301
372
  max_retries=3,
302
373
  timeout=60,
303
374
  ),
375
+ openai=OpenAIConfig(
376
+ # Set your OpenAI API key here or use
377
+ # OPENAI_API_KEY env var
378
+ api_key=None,
379
+ base_url="https://api.openai.com/v1",
380
+ max_retries=3,
381
+ timeout=60,
382
+ ),
383
+ anthropic=AnthropicConfig(
384
+ # Set your Anthropic API key here or use
385
+ # ANTHROPIC_API_KEY env var
386
+ api_key=None,
387
+ base_url="https://api.anthropic.com/v1",
388
+ max_retries=3,
389
+ timeout=60,
390
+ ),
304
391
  log_level="INFO",
305
392
  debate_topic_source="openrouter",
306
393
  debate_topic_model="anthropic/claude-3-haiku",
@@ -2,9 +2,10 @@
2
2
 
3
3
  from __future__ import annotations
4
4
 
5
- from typing import TYPE_CHECKING
5
+ from typing import TYPE_CHECKING, cast
6
6
 
7
7
  from dialectus.engine.config.settings import AppConfig
8
+ from dialectus.engine.models.providers.base_model_provider import ChatMessage
8
9
 
9
10
  from .models import DebateContext
10
11
  from .prompt_builder import PromptBuilder
@@ -13,6 +14,9 @@ from .types import DebatePhase
13
14
  if TYPE_CHECKING:
14
15
  from dialectus.engine.formats import DebateFormat, FormatPhase
15
16
 
17
+ # Maximum number of recent messages to include in conversation context
18
+ MAX_CONTEXT_MESSAGES = 6
19
+
16
20
 
17
21
  class ContextBuilder:
18
22
  """Builds conversation context for model prompts during debates."""
@@ -39,7 +43,7 @@ class ContextBuilder:
39
43
  speaker_id: str,
40
44
  phase: DebatePhase,
41
45
  context: DebateContext,
42
- ) -> list[dict[str, str]]:
46
+ ) -> list[ChatMessage]:
43
47
  """Build conversation context for the model.
44
48
 
45
49
  Args:
@@ -71,7 +75,7 @@ class ContextBuilder:
71
75
  })
72
76
 
73
77
  # Add relevant debate history
74
- for msg in context.messages[-6:]: # Last 6 messages for context
78
+ for msg in context.messages[-MAX_CONTEXT_MESSAGES:]:
75
79
  role = "assistant" if msg.speaker_id == speaker_id else "user"
76
80
 
77
81
  # Use a cleaner format that's less likely to be repeated by small
@@ -94,14 +98,14 @@ class ContextBuilder:
94
98
  )
95
99
  messages.append({"role": "user", "content": turn_prompt})
96
100
 
97
- return messages
101
+ return cast(list[ChatMessage], messages)
98
102
 
99
103
  def build_format_conversation_context(
100
104
  self,
101
105
  speaker_id: str,
102
106
  format_phase: FormatPhase,
103
107
  context: DebateContext,
104
- ) -> list[dict[str, str]]:
108
+ ) -> list[ChatMessage]:
105
109
  """Build conversation context for the model using format phase.
106
110
 
107
111
  Args:
@@ -139,7 +143,7 @@ class ContextBuilder:
139
143
  })
140
144
 
141
145
  # Add relevant debate history
142
- for msg in context.messages[-6:]: # Last 6 messages for context
146
+ for msg in context.messages[-MAX_CONTEXT_MESSAGES:]:
143
147
  role = "assistant" if msg.speaker_id == speaker_id else "user"
144
148
 
145
149
  # Use a cleaner format that's less likely to be repeated by small
@@ -160,4 +164,4 @@ class ContextBuilder:
160
164
  turn_prompt = f"Now speak as {role_name}. Stay under {word_limit} words."
161
165
  messages.append({"role": "user", "content": turn_prompt})
162
166
 
163
- return messages
167
+ return cast(list[ChatMessage], messages)
@@ -22,6 +22,7 @@ from .types import (
22
22
  MessageEventCallback,
23
23
  PhaseEventCallback,
24
24
  PhaseEventType,
25
+ PhaseStartedEventData,
25
26
  )
26
27
 
27
28
  logger = logging.getLogger(__name__)
@@ -169,18 +170,14 @@ class DebateEngine:
169
170
 
170
171
  # Invoke phase callback if provided
171
172
  if phase_callback:
172
- await phase_callback(
173
- PhaseEventType.PHASE_STARTED,
174
- {
175
- "phase": format_phase.name,
176
- "instruction": format_phase.instruction,
177
- "current_phase": self.context.current_round,
178
- "total_phases": total_phases,
179
- "progress_percentage": round(
180
- (phase_index / total_phases) * 100
181
- ),
182
- },
173
+ phase_event = PhaseStartedEventData(
174
+ phase=format_phase.name,
175
+ instruction=format_phase.instruction,
176
+ current_phase=self.context.current_round,
177
+ total_phases=total_phases,
178
+ progress_percentage=round((phase_index / total_phases) * 100),
183
179
  )
180
+ await phase_callback(PhaseEventType.PHASE_STARTED, phase_event)
184
181
 
185
182
  # If streaming callbacks provided, use streaming version
186
183
  if message_callback or chunk_callback: