aragora-sdk 2.7.2__tar.gz

aragora_sdk-2.7.2/.gitignore

@@ -0,0 +1,193 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+/lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+coverage*.json
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+.mypy_cache/
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Node
+node_modules/
+typings/
+docs-site/.docusaurus/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Project specific
+*.db
+*.db-shm
+*.db-wal
+*.db-journal
+elo_snapshot.json
+**/elo_snapshot.json
+agora_memory.db
+debates.db
+*.sqlite
+*.sqlite3
+
+# Logs
+*.log
+logs/
+
+# Local config
+.env.local
+config.local.yaml
+.DS_Store
+
+# Local drafts / scratch
+drafts/
+
+# Local exports / generated artifacts
+exports/
+artifacts/
+smoke_output/
+replays/*.mp3
+
+# Claude-mem context files
+aragora/**/CLAUDE.md
+scripts/CLAUDE.md
+
+# Generated Claude context files (avoid committing new ones)
+**/CLAUDE.md
+!/CLAUDE.md
+
+# Environment files (security - never commit secrets)
+**/.env
+**/.envrc
+**/.env.local
+**/.env.production
+**/.env.*
+**/.env.*.local
+!**/.env.example
+!**/.env.local.example
+!**/.env.template
+!**/.env.*.example
+
+# Live dashboard
+aragora/live/node_modules/
+aragora/live/.next/
+aragora/live/out/
+aragora/live/docs/
+tsconfig.tsbuildinfo
+.env.production
+
+# Playwright E2E tests
+aragora/live/playwright-report/
+aragora/live/playwright-report-production/
+aragora/live/test-results/
+aragora/live/playwright/.cache/
+
+# Test caches
+.test_cache/
+.benchmarks/
+
+# Nomic loop state (runtime artifacts, not needed in git)
+# The entire .nomic/ directory is runtime state -- databases, logs, checkpoints, etc.
+.nomic/
+
+# Web cache
+.web_cache/
+
+# Local backups
+backups/
+.env_backups/
+:memory:
+
+# Convoy runtime state
+.convoys/
+
+# Screenshots (dev/testing artifacts)
+FireShot*.png
+Screenshot*.png
+*.screenshot.png
+output/
+.mypy_cache/
+typings/
+
+# Investor documents (sensitive business documents)
+docs/investor/
+:memory:-shm
+:memory:-wal
+
+# Comparison projects (external references)
+.comparison/
+# Local config
+.python-version
+.claude/
+.checkpoints/
+
+# Bead tracking data (has its own git repo)
+.beads/
+.aragora_beads/
+**/.aragora_beads/
+
+# Build tool caches
+.ruff_cache/
+.grok/
+
+# Approval testing artifacts
+.approvals/
+
+# Local data directories (runtime artifacts)
+data/
+consolidated/
+docs/openapi_generated.json
+.testfixer/
+.tmp/

aragora_sdk-2.7.2/BREAKING_CHANGES.md

@@ -0,0 +1,131 @@
+# Python SDK Breaking Changes
+
+This document tracks breaking changes specific to the Aragora Python SDK. For core API breaking changes, see the main [BREAKING_CHANGES.md](../../docs/BREAKING_CHANGES.md).
+
+---
+
+## Version 2.x
+
+### v2.4.0 (2026-01-25)
+
+**No breaking changes.** Added new namespace resources.
+
+**New Features:**
+- Added resources: `orgs`, `tenants`, `policies`, `codebase`, `costs`, `decisions`, `onboarding`, `notifications`, `gmail`, `explainability`
+- Fixed payloads for billing and RBAC endpoints
+
+---
+
+### v2.2.0 (2026-01-24)
+
+**No breaking changes.** Version aligned with core package.
+
+---
+
+### v2.0.0 (2026-01-17)
+
+#### Breaking Changes
+
+| Change | Before | After | Migration |
+|--------|--------|-------|-----------|
+| API version default | v1 | v2 | Explicit `api_version="v1"` to keep old behavior |
+| Method naming | Camel case methods | Namespace-based methods | `client.getDebates()` becomes `client.debates.list()` |
+| Response format | Direct data | Wrapped in `data`/`meta` | Access via `response["data"]` |
+
+#### Method Renames
+
+| Old Method | New Method |
+|------------|------------|
+| `client.getDebates()` | `client.debates.list()` |
+| `client.createDebate(...)` | `client.debates.create(...)` |
+| `client.getDebate(id)` | `client.debates.get(id)` |
+| `client.getAgents()` | `client.agents.list()` |
+| `client.getAgent(name)` | `client.agents.get(name)` |
+| `client.submitVote(...)` | `client.debates.vote(debate_id, ...)` |
+| `client.getConsensus(id)` | `client.consensus.get(id)` |
+
+#### Migration Example
+
+```python
+# Before (v1.x)
+from aragora.client import AragoraClient
+
+client = AragoraClient(base_url="https://api.aragora.ai")
+debates = client.getDebates()
+debate = client.createDebate(topic="Should we use GraphQL?", max_rounds=3)
+
+# After (v2.x)
+from aragora import AragoraClient
+
+client = AragoraClient(
+    base_url="https://api.aragora.ai",
+    api_version="v2"  # Optional, v2 is now default
+)
+response = client.debates.list()
+debates = response["data"]["debates"]
+
+response = client.debates.create(
+    task="Should we use GraphQL?",  # 'topic' renamed to 'task'
+    rounds=3  # 'max_rounds' renamed to 'rounds'
+)
+debate = response["data"]
+```
+
+#### Response Format Change
+
+```python
+# Before (v1.x) - Direct data access
+response = client.debates.list()
+debates = response["debates"]
+count = response["count"]
+
+# After (v2.x) - Wrapped response
+response = client.debates.list()
+debates = response["data"]["debates"]
+count = response["data"]["count"]
+meta = response["meta"]  # Contains version, timestamp, request_id
+```
+
+---
+
+## Version 1.x
+
+### v1.0.0 (2026-01-14)
+
+**Initial stable release.** No breaking changes from pre-1.0 beta versions.
+
+---
+
+## Upcoming Breaking Changes
+
+### Scheduled for v3.0.0
+
+No breaking changes currently scheduled.
+
+---
+
+## Migration Guides
+
+- [API v1 to v2 Migration](../../docs/MIGRATION_V1_TO_V2.md) - Complete guide for API migration
+- [SDK Guide](../../docs/SDK_GUIDE.md) - Full SDK documentation
+
+---
+
+## Deprecation Warnings
+
+The SDK emits `DeprecationWarning` for deprecated methods. Enable warnings to see them:
+
+```python
+import warnings
+warnings.filterwarnings("default", category=DeprecationWarning, module="aragora")
+```
+
+Or run Python with `-W default`:
+
+```bash
+python -W default your_script.py
+```
+
+---
+
+*Last updated: 2026-01-31*

aragora_sdk-2.7.2/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

aragora_sdk-2.7.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agora Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aragora_sdk-2.7.2/Makefile

@@ -0,0 +1,69 @@
+.PHONY: help install install-dev test lint format typecheck check clean build publish
+
+# Default target
+help:
+	@echo "Aragora Python SDK Development Commands"
+	@echo ""
+	@echo "Setup:"
+	@echo "  make install      Install package in production mode"
+	@echo "  make install-dev  Install package with dev dependencies"
+	@echo ""
+	@echo "Quality:"
+	@echo "  make test         Run test suite"
+	@echo "  make lint         Run ruff linter"
+	@echo "  make format       Format code with ruff"
+	@echo "  make typecheck    Run mypy type checker"
+	@echo "  make check        Run all checks (lint + typecheck + test)"
+	@echo ""
+	@echo "Build:"
+	@echo "  make build        Build distribution packages"
+	@echo "  make clean        Remove build artifacts"
+	@echo "  make publish      Publish to PyPI (requires credentials)"
+
+# Installation
+install:
+	pip install .
+
+install-dev:
+	pip install -e ".[dev]"
+
+# Testing
+test:
+	python -m pytest tests/ -v --tb=short
+
+test-quick:
+	python -m pytest tests/ -q --tb=line
+
+test-cov:
+	python -m pytest tests/ --cov=aragora --cov-report=term-missing --cov-report=html
+
+# Linting and formatting
+lint:
+	python -m ruff check aragora/ tests/
+
+format:
+	python -m ruff format aragora/ tests/
+	python -m ruff check --fix aragora/ tests/
+
+# Type checking
+typecheck:
+	python -m mypy aragora/ --strict
+
+# Combined checks
+check: lint typecheck test
+
+# Build
+build: clean
+	python -m build
+
+clean:
+	rm -rf dist/ build/ *.egg-info .pytest_cache .mypy_cache .ruff_cache
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete 2>/dev/null || true
+
+# Publishing (use with caution)
+publish: build
+	python -m twine upload dist/*
+
+publish-test: build
+	python -m twine upload --repository testpypi dist/*