deepstrike 0.2.28__tar.gz → 0.2.31__tar.gz

{deepstrike-0.2.28 → deepstrike-0.2.31}/Cargo.lock

@@ -194,7 +194,7 @@ dependencies = [
 
 [[package]]
 name = "deepstrike-core"
-version = "0.2.28"
+version = "0.2.31"
 dependencies = [
  "compact_str",
  "pretty_assertions",
@@ -206,7 +206,7 @@ dependencies = [
 
 [[package]]
 name = "deepstrike-node"
-version = "0.2.28"
+version = "0.2.31"
 dependencies = [
  "compact_str",
  "deepstrike-core",
@@ -218,7 +218,7 @@ dependencies = [
 
 [[package]]
 name = "deepstrike-py"
-version = "0.2.28"
+version = "0.2.31"
 dependencies = [
  "compact_str",
  "deepstrike-core",
@@ -229,7 +229,7 @@ dependencies = [
 
 [[package]]
 name = "deepstrike-sdk"
-version = "0.2.28"
+version = "0.2.31"
 dependencies = [
  "async-stream",
  "async-trait",
@@ -263,7 +263,7 @@ dependencies = [
 
 [[package]]
 name = "deepstrike-wasm"
-version = "0.2.28"
+version = "0.2.31"
 dependencies = [
  "compact_str",
  "deepstrike-core",

{deepstrike-0.2.28 → deepstrike-0.2.31}/Cargo.toml

@@ -3,13 +3,13 @@ resolver = "2"
 members = ["crates/deepstrike-core", "crates/deepstrike-py"]
 
 [workspace.package]
-version = "0.2.28"
+version = "0.2.31"
 edition = "2024"
 license = "MIT"
 repository = "https://github.com/kongusen/deepstrike"
 
 [workspace.dependencies]
-deepstrike-core = { path = "crates/deepstrike-core", version = "0.2.28" }
+deepstrike-core = { path = "crates/deepstrike-core", version = "0.2.31" }
 notify = "6"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"

{deepstrike-0.2.28 → deepstrike-0.2.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepstrike
-Version: 0.2.28
+Version: 0.2.31
 Requires-Dist: httpx>=0.27
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: anyio>=4.0
@@ -68,6 +68,25 @@ asyncio.run(collect_text(runner.run(
 # => "45"
 ```
 
+### Recipes — the canonical entry points
+
+Most apps need one of two shapes. Start with the facades; drop to `RuntimeRunner` for streaming, tools, signals, memory, or governance.
+
+```python
+from deepstrike import run_agent, run_fanout
+
+# 1) Single agent — one prompt, one model, the text back.
+answer = await run_agent(provider=provider, goal="What is 17 + 28?", tools=[add])
+
+# 2) Parallel fan-out → synthesize over the kernel-gated DAG (safe from a stateless handler).
+out = await run_fanout(
+    provider=provider,
+    tasks=["Summarize the auth module", "Summarize the data layer"],
+    synthesize="Combine the findings into one summary.",
+)
+synthesis = out["synthesis"]
+```
+
 Same-session continuity is explicit via `session_id`:
 
 ```python
@@ -205,17 +224,25 @@ runner = RuntimeRunner(RuntimeOptions(
 ))
 ```
 
-| Class | Backend | Notes |
-|-------|---------|-------|
-| `OpenAIProvider` | OpenAI API | SSE tool-call accumulation |
-| `AnthropicProvider` | Anthropic API | Native SSE, `ThinkingDelta` support |
-| `QwenProvider` | DashScope | `enable_thinking` via extensions |
-| `DeepSeekProvider` | DeepSeek API | Reasoner models strip tools automatically |
-| `MiniMaxProvider` | MiniMax API | M1 reasoning via `expose_reasoning` |
-| `OllamaProvider` | Local Ollama | `http://localhost:11434` default |
-| `KimiProvider` | Moonshot API | |
-
-All providers accept `RetryConfig` for exponential backoff and share a `CircuitBreaker`.
+The top-level package exports the base providers `OpenAIProvider`, `OpenAIResponsesProvider`, and
+`AnthropicProvider`. **Every other backend is a factory function** in `deepstrike.providers`, with a
+`protocol` argument where a backend speaks both the OpenAI- and Anthropic-compatible wire:
+
+```python
+from deepstrike.providers import deepseek, kimi, minimax
+
+ds = deepseek(api_key="...")                          # OpenAI-compatible wire (default)
+dsA = deepseek(api_key="...", protocol="anthropic")   # Anthropic-compatible wire
+mm = minimax(api_key="...")                           # MiniMax defaults to the Anthropic wire
+```
+
+| Entry | Import from | Backend |
+|-------|-------------|---------|
+| `OpenAIProvider` / `OpenAIResponsesProvider` | `deepstrike` | OpenAI (and OpenAI-compatible) |
+| `AnthropicProvider` | `deepstrike` | Anthropic Messages API |
+| `deepseek` · `kimi` · `qwen` · `glm` · `minimax` · `gemini` · `ollama` | `deepstrike.providers` | the respective vendor (factory functions) |
+
+All providers accept `retry_config` for exponential backoff and share a `CircuitBreaker`.
 
 `extensions` are forwarded to the provider while SDK-owned structural fields remain protected.
 

{deepstrike-0.2.28 → deepstrike-0.2.31}/README.md

@@ -55,6 +55,25 @@ asyncio.run(collect_text(runner.run(
 # => "45"
 ```
 
+### Recipes — the canonical entry points
+
+Most apps need one of two shapes. Start with the facades; drop to `RuntimeRunner` for streaming, tools, signals, memory, or governance.
+
+```python
+from deepstrike import run_agent, run_fanout
+
+# 1) Single agent — one prompt, one model, the text back.
+answer = await run_agent(provider=provider, goal="What is 17 + 28?", tools=[add])
+
+# 2) Parallel fan-out → synthesize over the kernel-gated DAG (safe from a stateless handler).
+out = await run_fanout(
+    provider=provider,
+    tasks=["Summarize the auth module", "Summarize the data layer"],
+    synthesize="Combine the findings into one summary.",
+)
+synthesis = out["synthesis"]
+```
+
 Same-session continuity is explicit via `session_id`:
 
 ```python
@@ -192,17 +211,25 @@ runner = RuntimeRunner(RuntimeOptions(
 ))
 ```
 
-| Class | Backend | Notes |
-|-------|---------|-------|
-| `OpenAIProvider` | OpenAI API | SSE tool-call accumulation |
-| `AnthropicProvider` | Anthropic API | Native SSE, `ThinkingDelta` support |
-| `QwenProvider` | DashScope | `enable_thinking` via extensions |
-| `DeepSeekProvider` | DeepSeek API | Reasoner models strip tools automatically |
-| `MiniMaxProvider` | MiniMax API | M1 reasoning via `expose_reasoning` |
-| `OllamaProvider` | Local Ollama | `http://localhost:11434` default |
-| `KimiProvider` | Moonshot API | |
-
-All providers accept `RetryConfig` for exponential backoff and share a `CircuitBreaker`.
+The top-level package exports the base providers `OpenAIProvider`, `OpenAIResponsesProvider`, and
+`AnthropicProvider`. **Every other backend is a factory function** in `deepstrike.providers`, with a
+`protocol` argument where a backend speaks both the OpenAI- and Anthropic-compatible wire:
+
+```python
+from deepstrike.providers import deepseek, kimi, minimax
+
+ds = deepseek(api_key="...")                          # OpenAI-compatible wire (default)
+dsA = deepseek(api_key="...", protocol="anthropic")   # Anthropic-compatible wire
+mm = minimax(api_key="...")                           # MiniMax defaults to the Anthropic wire
+```
+
+| Entry | Import from | Backend |
+|-------|-------------|---------|
+| `OpenAIProvider` / `OpenAIResponsesProvider` | `deepstrike` | OpenAI (and OpenAI-compatible) |
+| `AnthropicProvider` | `deepstrike` | Anthropic Messages API |
+| `deepseek` · `kimi` · `qwen` · `glm` · `minimax` · `gemini` · `ollama` | `deepstrike.providers` | the respective vendor (factory functions) |
+
+All providers accept `retry_config` for exponential backoff and share a `CircuitBreaker`.
 
 `extensions` are forwarded to the provider while SDK-owned structural fields remain protected.
 

{deepstrike-0.2.28 → deepstrike-0.2.31}/crates/deepstrike-core/src/governance/quota.rs

@@ -17,8 +17,15 @@ use serde::{Deserialize, Serialize};
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 pub struct ResourceQuota {
     /// Max sub-agents in the `Running` state at once. Further `Spawn`s are denied while at cap.
+    /// *Instantaneous* — vehicle-scoped (cannot span stateless replicas; spec §2.5).
     #[serde(default, skip_serializing_if = "Option::is_none")]
     pub max_concurrent_subagents: Option<u32>,
+    /// L1 (RunGroup): max sub-agents spawned *cumulatively* over the whole governance domain. Unlike
+    /// `max_concurrent_subagents` this counts every spawn ever (running + completed), seeded across
+    /// members via `group_spawns_base`, so it spans N stateless top-level runs. A hard `Deny` at cap
+    /// (a completed sibling never frees a cumulative slot).
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub max_total_subagents: Option<u32>,
     /// Max sub-agent nesting depth (direct children of the root loop are depth 1).
     #[serde(default, skip_serializing_if = "Option::is_none")]
     pub max_spawn_depth: Option<u32>,
@@ -37,6 +44,7 @@ impl ResourceQuota {
     /// Whether any limit is actually set (used to short-circuit the gate when fully open).
     pub fn is_open(&self) -> bool {
         self.max_concurrent_subagents.is_none()
+            && self.max_total_subagents.is_none()
             && self.max_spawn_depth.is_none()
             && self.memory_writes_per_window.is_none()
             && self.max_workflow_nodes.is_none()