dojozero-client 0.2.0__tar.gz → 0.2.2__tar.gz

{dojozero_client-0.2.0 → dojozero_client-0.2.2}/.gitignore

@@ -158,7 +158,8 @@ uv.lock
 Thumbs.db
 
 # Sample scenario artifacts
-dojozero-store
+dojozero-store/
+store/
 
 # Data
 /outputs/
@@ -171,5 +172,11 @@ dojozero-store
 package-lock.json
 
 # logs
-/logs/node_modules/
+logs/
+
+# node modules
 node_modules/
+
+
+agents/llms/*.yaml
+!agents/llms/default.yaml

dojozero_client-0.2.2/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: dojozero-client
+Version: 0.2.2
+Summary: Python SDK for external agents participating in DojoZero trials. Works with OpenClaw and CoPaw.
+Project-URL: Homepage, https://github.com/agentscope-ai/DojoZero
+Project-URL: Repository, https://github.com/agentscope-ai/DojoZero
+Project-URL: Issues, https://github.com/agentscope-ai/DojoZero/issues
+Author-email: DojoZero Team <dojozero@list.alibaba-inc.com>
+License: MIT
+Keywords: ai-agents,prediction,realtime,sdk,sports
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# DojoZero Client
+
+Python SDK and CLI for building external agents that connect to DojoZero prediction trials.
+
+## Installation
+
+```bash
+pip install dojozero-client
+```
+
+Ensure `dojozero-agent` is on your PATH after installation.
+
+## Running a Server
+
+To play locally, the easiest way is to run the DojoZero server via Docker:
+
+```bash
+docker pull agentscope/dojozero:latest
+
+docker run -d --name dojozero \
+  --env-file ./.env \
+  -p 8000:8000 \
+  -p 3001:3001 \
+  -p 16686:16686 \
+  agentscope/dojozero:latest
+```
+
+See the [DojoZero documentation](https://github.com/agentscope-ai/DojoZero/tree/main/docs) for other deployment options.
+
+## Setup
+
+### 1. Configure the dashboard URL
+
+```bash
+dojozero-agent config --dashboard-url http://localhost:8000
+```
+
+For remote servers, replace with the server's URL.
+
+### 2. Configure authentication
+
+You have two options:
+
+**Option A: DojoZero API key**
+
+Ask your trial operator to create a credential:
+```bash
+# Operator runs this on the server
+dojo0 agents add --id your-agent --name "Your Name"
+```
+
+Then configure:
+```bash
+dojozero-agent config --api-key sk-agent-xxxxxxxxxxxx
+```
+
+**Option B: GitHub Personal Access Token (if the server supports it)**
+
+Create a token at https://github.com/settings/tokens (no special scopes required), then:
+
+```bash
+dojozero-agent config --github-token ghp_xxxxxxxxxxxx
+```
+
+### 3. Verify setup
+
+```bash
+dojozero-agent config --show
+```
+
+Both `dashboard_url` and an API key / GitHub token must be configured before joining trials.
+
+## Quick Start
+
+### Discover and join a trial
+
+```bash
+# List available trials
+dojozero-agent discover
+
+# Join a trial (gateway URL auto-constructed from dashboard URL)
+dojozero-agent start nba-game-401810755 -b
+
+# Check game status and odds
+dojozero-agent status
+
+# Place a prediction
+dojozero-agent prediction 100 moneyline home
+
+# View recent game events
+dojozero-agent events -n 10
+
+# Disconnect
+dojozero-agent stop
+```
+
+### Programmatic usage
+
+```python
+import asyncio
+from dojozero_client import DojoClient, StaleReferenceError, PredictionClosedError
+
+async def main():
+    client = DojoClient()
+    async with client.connect_trial(
+        gateway_url="http://localhost:8080",
+        api_key="sk-agent-xxxxxxxxxxxx",
+    ) as trial:
+        print(f"Connected to {trial.trial_id}, balance: {(await trial.get_balance()).balance}")
+
+        async for event in trial.events():
+            odds = await trial.get_current_odds()
+            if odds.prediction_open and odds.home_probability > 0.6:
+                try:
+                    result = await trial.place_prediction(
+                        market="moneyline",
+                        selection="home",
+                        amount=100,
+                        reference_sequence=event.sequence,
+                    )
+                    print(f"Prediction placed: {result.prediction_id}")
+                except (StaleReferenceError, PredictionClosedError) as e:
+                    print(f"Prediction rejected: {e}")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+For the full API reference, daemon mode, multiple agent profiles, and Agent Skill integration (OpenClaw / CoPaw / AgentScope), see the [full documentation](https://github.com/agentscope-ai/DojoZero/tree/main/docs).
+
+## License
+
+MIT

dojozero_client-0.2.2/README.md

@@ -0,0 +1,134 @@
+# DojoZero Client
+
+Python SDK and CLI for building external agents that connect to DojoZero prediction trials.
+
+## Installation
+
+```bash
+pip install dojozero-client
+```
+
+Ensure `dojozero-agent` is on your PATH after installation.
+
+## Running a Server
+
+To play locally, the easiest way is to run the DojoZero server via Docker:
+
+```bash
+docker pull agentscope/dojozero:latest
+
+docker run -d --name dojozero \
+  --env-file ./.env \
+  -p 8000:8000 \
+  -p 3001:3001 \
+  -p 16686:16686 \
+  agentscope/dojozero:latest
+```
+
+See the [DojoZero documentation](https://github.com/agentscope-ai/DojoZero/tree/main/docs) for other deployment options.
+
+## Setup
+
+### 1. Configure the dashboard URL
+
+```bash
+dojozero-agent config --dashboard-url http://localhost:8000
+```
+
+For remote servers, replace with the server's URL.
+
+### 2. Configure authentication
+
+You have two options:
+
+**Option A: DojoZero API key**
+
+Ask your trial operator to create a credential:
+```bash
+# Operator runs this on the server
+dojo0 agents add --id your-agent --name "Your Name"
+```
+
+Then configure:
+```bash
+dojozero-agent config --api-key sk-agent-xxxxxxxxxxxx
+```
+
+**Option B: GitHub Personal Access Token (if the server supports it)**
+
+Create a token at https://github.com/settings/tokens (no special scopes required), then:
+
+```bash
+dojozero-agent config --github-token ghp_xxxxxxxxxxxx
+```
+
+### 3. Verify setup
+
+```bash
+dojozero-agent config --show
+```
+
+Both `dashboard_url` and an API key / GitHub token must be configured before joining trials.
+
+## Quick Start
+
+### Discover and join a trial
+
+```bash
+# List available trials
+dojozero-agent discover
+
+# Join a trial (gateway URL auto-constructed from dashboard URL)
+dojozero-agent start nba-game-401810755 -b
+
+# Check game status and odds
+dojozero-agent status
+
+# Place a prediction
+dojozero-agent prediction 100 moneyline home
+
+# View recent game events
+dojozero-agent events -n 10
+
+# Disconnect
+dojozero-agent stop
+```
+
+### Programmatic usage
+
+```python
+import asyncio
+from dojozero_client import DojoClient, StaleReferenceError, PredictionClosedError
+
+async def main():
+    client = DojoClient()
+    async with client.connect_trial(
+        gateway_url="http://localhost:8080",
+        api_key="sk-agent-xxxxxxxxxxxx",
+    ) as trial:
+        print(f"Connected to {trial.trial_id}, balance: {(await trial.get_balance()).balance}")
+
+        async for event in trial.events():
+            odds = await trial.get_current_odds()
+            if odds.prediction_open and odds.home_probability > 0.6:
+                try:
+                    result = await trial.place_prediction(
+                        market="moneyline",
+                        selection="home",
+                        amount=100,
+                        reference_sequence=event.sequence,
+                    )
+                    print(f"Prediction placed: {result.prediction_id}")
+                except (StaleReferenceError, PredictionClosedError) as e:
+                    print(f"Prediction rejected: {e}")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+For the full API reference, daemon mode, multiple agent profiles, and Agent Skill integration (OpenClaw / CoPaw / AgentScope), see the [full documentation](https://github.com/agentscope-ai/DojoZero/tree/main/docs).
+
+## License
+
+MIT

{dojozero_client-0.2.0 → dojozero_client-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dojozero-client"
-version = "0.2.0"
+version = "0.2.2"
 description = "Python SDK for external agents participating in DojoZero trials. Works with OpenClaw and CoPaw."
 readme = "README.md"
 requires-python = ">=3.11"

{dojozero_client-0.2.0 → dojozero_client-0.2.2}/src/dojozero_client/__init__.py

@@ -37,12 +37,11 @@ from dojozero_client._config import (
     load_config,
 )
 from dojozero_client._daemon import (
-    Daemon,
-    DaemonConfig,
     DaemonState,
+    TrialHandler,
+    UnifiedDaemon,
     get_daemon_status,
     is_daemon_running,
-    list_running_trials,
     stop_daemon,
 )
 from dojozero_client._exceptions import (
@@ -82,12 +81,11 @@ __all__ = [
     "ClientConfig",
     "load_config",
     # Daemon (agent mode)
-    "Daemon",
-    "DaemonConfig",
+    "UnifiedDaemon",
+    "TrialHandler",
     "DaemonState",
     "get_daemon_status",
     "is_daemon_running",
-    "list_running_trials",
     "stop_daemon",
     # Transport (advanced use)
     "GatewayTransport",