agentnova 0.3.2__tar.gz → 0.3.3__tar.gz

{agentnova-0.3.2 → agentnova-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentnova
-Version: 0.3.2
+Version: 0.3.3
 Summary: ⚛️ AgentNova - A minimal, hackable agentic framework for local LLM inference
 Author-email: VTSTech <veritas@vts-tech.org>
 Maintainer-email: VTSTech <veritas@vts-tech.org>
@@ -32,7 +32,7 @@ Requires-Dist: black>=23.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Dynamic: license-file
 
-# ⚛️ AgentNova R03.2
+# ⚛️ AgentNova R03.3
 
 **Status: Alpha**
 
@@ -63,10 +63,14 @@ Inspired by the architecture of OpenClaw, rebuilt from scratch for local-first o
 
 - **Zero dependencies** — Uses Python stdlib only (urllib for HTTP)
 - **Ollama + BitNet backends** — Switch with `--backend` flag
+- **Dual API support** — OpenResponses (`--api resp`) and Chat-Completions (`--api comp`)
 - **Three-tier tool support** — Native, ReAct, or none (auto-detected)
 - **Small model optimized** — Fuzzy matching, argument normalization
 - **Built-in security** — Path validation, command blocklist, SSRF protection
 - **Multi-agent orchestration** — Router, pipeline, and parallel modes
+- **Soul Spec v0.5** — Persona packages with progressive disclosure
+- **ACP v1.0.5 integration** — Agent Control Panel for monitoring and control
+- **AgentSkills spec** — Skill loading with SPDX license validation
 
 ## Installation
 
@@ -94,6 +98,9 @@ agentnova chat -m qwen2.5:0.5b --tools calculator,shell
 # Autonomous agent mode
 agentnova agent -m qwen2.5:7b --tools calculator,shell,write_file
 
+# Use Chat-Completions API (OpenAI-compatible)
+agentnova chat -m qwen2.5:0.5b --api comp
+
 # List available models
 agentnova models
 
@@ -123,6 +130,37 @@ print(result.final_answer)
 print(f"Completed in {result.total_ms:.0f}ms")
 ```
 
+### Chat-Completions Streaming
+
+```python
+from agentnova.backends import get_backend
+from agentnova.core.types import ApiMode
+
+# Use Chat-Completions mode with streaming
+backend = get_backend("ollama", api_mode=ApiMode.COMPLETIONS)
+
+for chunk in backend.generate_completions_stream(
+    model="qwen2.5:0.5b",
+    messages=[{"role": "user", "content": "Hello!"}],
+    response_format={"type": "json_object"}
+):
+    print(chunk["delta"], end="", flush=True)
+```
+
+### Skill License Validation
+
+```python
+from agentnova.skills import validate_spdx_license, parse_compatibility
+
+# Validate SPDX license identifier
+valid, msg = validate_spdx_license("MIT")  # (True, "Valid SPDX identifier: MIT")
+valid, msg = validate_spdx_license("Custom")  # (False, "Unknown license...")
+
+# Parse compatibility requirements
+compat = parse_compatibility("python>=3.8, ollama")
+# Returns: {"python": ">=3.8", "runtimes": ["ollama"], "frameworks": []}
+```
+
 ### Multi-Agent Orchestration
 
 ```python
@@ -218,6 +256,20 @@ agentnova config
 agentnova config --urls  # Show only URLs
 ```
 
+### CLI Options (run, chat, agent)
+
+| Option | Description |
+|--------|-------------|
+| `--api resp\|comp` | API mode: OpenResponses (default) or Chat-Completions |
+| `--response-format text\|json` | Response format (Chat-Completions mode) |
+| `--truncation auto\|disabled` | Truncation behavior for long responses |
+| `--soul <path>` | Load Soul Spec persona package |
+| `--soul-level 1-3` | Progressive disclosure level |
+| `--num-ctx <tokens>` | Context window size (default: 4096) |
+| `--timeout <seconds>` | Request timeout (default: 120) |
+| `--acp` | Enable ACP (Agent Control Panel) logging |
+| `--acp-url <url>` | ACP server URL |
+
 ## LocalClaw Redirect
 
 The `localclaw` command is provided for backward compatibility: