selectools 0.24.0__tar.gz → 0.25.0__tar.gz

{selectools-0.24.0/src/selectools.egg-info → selectools-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.24.0
+Version: 0.25.0
 Summary: Production-ready Python framework for AI agents with multi-agent graphs, hybrid RAG, guardrails, audit logging, 50 evaluators, and a visual builder. Supports OpenAI, Anthropic, Gemini, Ollama. By NichevLabs.
 Author-email: John Nichev <johnnichev@gmail.com>
 Maintainer-email: NichevLabs <support@nichevlabs.com>
@@ -108,6 +108,24 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v0.25
+
+### v0.25.0 — Hardening & v1.0 Prep
+
+Five new features plus the final v1.0 groundwork: the entire 433-symbol public surface is now stability-marked (205 stable, 228 beta) with a CI gate, the long-deprecated `AgentConfig.hooks` is removed, and the security audit is published.
+
+- **Planning-as-config** — `AgentConfig(planning=PlanningConfig(...))` adds plan→execute→synthesize to any agent via isolated clones, with a complexity gate, cross-clone budget caps, and a plan approval handler.
+- **Agent-level HITL** — `ToolConfig(require_approval=[...], approval_handler=...)` gates tool execution behind a sync or async approval callback (fail-closed, denials memoized per run).
+- **Tool result compression** — `ToolConfig(compress_results=True)` summarizes oversized tool results via a one-shot LLM call before they enter context, with raw-text retention for stop conditions and loop detection.
+- **Knowledge pre-save sanitization** — `pre_save` hook on `KnowledgeMemory` plus built-in sanitizers: `defang_delimiters` (prompt-injection markers), `strip_surrogates`, `dedupe_against`.
+- **Pending intent hooks** — `pop_if_intent` (structured confirm/cancel from chat buttons, bypasses the text parser) and `tighten_ttl` (id-pinned atomic Lua rewrite on Redis).
+- **Stability marking sweep** — 100% of the public surface marked; 19 beta→stable promotions (AgentGraph + orchestration core, all 5 pattern agents, checkpoint stores, `RedisSessionStore`, `AzureOpenAIProvider`, ...); module-level `__stability__` on all 123 public modules; CI gate enforces markers forever.
+- **Wart removal** — `Agent.clone_for_isolation()` is public (`@beta`); `__all__` reconciled (11 documented symbols now exported, incl. the Pipeline family and `RouterProvider`); **BREAKING**: `AgentConfig(hooks=...)` now raises `TypeError` (deprecated since v0.16) — migrate to `AgentObserver` via `docs/MIGRATION_1.0.md`.
+- **Security audit published** — `docs/SECURITY_AUDIT.md`: bandit clean at medium/high, all 73 `nosec` suppressions justified, pip-audit pass, SBOM regenerated.
+- **Protocol isinstance fix** — stability markers no longer break third-party `isinstance` checks against `Cache`/`KnowledgeStore`/`CheckpointStore` on Python 3.9–3.11.
+
+See `CHANGELOG.md` for the full entry (7,268 tests, 111 examples).
+
 ## What's New in v0.24
 
 ### v0.24.0 — Production Interop
@@ -133,7 +151,7 @@ from selectools.serve import AgentAPI
 api = AgentAPI(agent, auth_key="secret")  # ASGI app: uvicorn main:api
 ```
 
-See `CHANGELOG.md` for the full entry (5,968 tests, 106 examples).
+See `CHANGELOG.md` for the full entry (6,187 tests, 111 examples).
 
 ## What's New in v0.23
 
@@ -620,7 +638,7 @@ report.to_html("report.html")
 | **Eval Framework** | 50 built-in evaluators (30 deterministic + 21 LLM-as-judge). A/B testing, regression detection, snapshot testing, HTML reports, JUnit XML, CI integration. |
 | **Multi-Agent Orchestration** | `AgentGraph` for directed agent graphs, `SupervisorAgent` with 4 strategies, HITL via generator nodes, parallel execution, checkpointing, subgraph composition. |
 | **Composable Pipelines** | `Pipeline` + `@step` + `|` operator + `parallel()` + `branch()` — chain agents, tools, and transforms with plain Python. |
-| **AgentObserver Protocol** | 45-event lifecycle observer with `run_id`/`call_id` correlation. Built-in `LoggingObserver` + `SimpleStepObserver`. |
+| **AgentObserver Protocol** | 46-event lifecycle observer with `run_id`/`call_id` correlation. Built-in `LoggingObserver` + `SimpleStepObserver`. |
 | **Runtime Controls** | Token/cost budget limits, cooperative cancellation, per-tool approval gates, model switching per iteration. |
 | **Production Hardened** | Retries with backoff, per-tool timeouts, iteration caps, cost warnings, observability hooks + observers. |
 | **Library-First** | Not a framework. No magic globals, no hidden state. Use as much or as little as you need. |
@@ -660,10 +678,10 @@ report.to_html("report.html")
 - **Conversation Branching**: `ConversationMemory.branch()` and `SessionStore.branch()` for A/B exploration and checkpointing
 - **Multi-Agent Orchestration**: `AgentGraph` with routing, parallel execution, HITL, checkpointing; `SupervisorAgent` with 4 strategies (plan_and_execute, round_robin, dynamic, magentic)
 - **Composable Pipelines**: `Pipeline` + `@step` + `|` operator + `parallel()` + `branch()` — chain agents, tools, and transforms
-- **106 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions (incl. Supabase), entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, agent-as-API, A2A, routing, unified memory, and more
+- **111 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions (incl. Supabase), entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, agent-as-API, A2A, routing, unified memory, and more
 - **Built-in Eval Framework**: 50 evaluators (30 deterministic + 21 LLM-as-judge), A/B testing, regression detection, HTML reports, JUnit XML, snapshot testing
-- **AgentObserver Protocol**: 45 lifecycle events with `run_id` correlation, `LoggingObserver`, `SimpleStepObserver`, OTel export
-- **5968 Tests**: Unit, integration, regression, and E2E with real API calls
+- **AgentObserver Protocol**: 46 lifecycle events with `run_id` correlation, `LoggingObserver`, `SimpleStepObserver`, OTel export
+- **7268 Tests**: Unit, integration, regression, and E2E with real API calls
 
 ## Install
 
@@ -989,7 +1007,7 @@ agent = Agent(
 )
 ```
 
-45 lifecycle events: run, LLM, tool, iteration, batch, policy, structured output, fallback, retry, memory trim, guardrail, coherence, screening, session, entity, KG, budget exceeded, cancelled, prompt compressed, plus 13 graph events (graph start/end, node start/end, routing, interrupt, resume, parallel, stall, loop, supervisor replan). See `observer.py` for full reference.
+46 lifecycle events: run, LLM, tool, iteration, batch, policy, structured output, fallback, retry, memory trim, guardrail, coherence, screening, session, entity, KG, budget exceeded, cancelled, prompt compressed, plus 13 graph events (graph start/end, node start/end, routing, interrupt, resume, parallel, stall, loop, supervisor replan). See `observer.py` for full reference.
 
 ### E2E Streaming & Parallel Execution
 
@@ -1165,7 +1183,7 @@ Examples are numbered by difficulty. Start from 01 and work your way up.
 |---|---|---|---|
 | 01 | `01_hello_world.py` | First agent, `@tool`, `ask()` | No |
 | 02 | `02_search_weather.py` | ToolRegistry, multiple tools | No |
-| 03 | `03_toolbox.py` | 24 pre-built tools (file, data, text, datetime, web) | No |
+| 03 | `03_toolbox.py` | 48 pre-built tools (file, data, text, datetime, web, code, search, and more) | No |
 | 04 | `04_conversation_memory.py` | Multi-turn memory | Yes |
 | 05 | `05_cost_tracking.py` | Token counting, cost warnings | Yes |
 | 06 | `06_async_agent.py` | `arun()`, concurrent agents, FastAPI | Yes |
@@ -1174,7 +1192,7 @@ Examples are numbered by difficulty. Start from 01 and work your way up.
 | 09 | `09_caching.py` | InMemoryCache, RedisCache, cache stats | Yes |
 | 10 | `10_routing_mode.py` | Routing mode, intent classification | Yes |
 | 11 | `11_tool_analytics.py` | Call counts, success rates, timing | Yes |
-| 12 | `12_observability_hooks.py` | Lifecycle hooks, tool validation | Yes |
+| 12 | `12_observability_hooks.py` | Lifecycle observers, tool validation | Yes |
 | 13 | `13_dynamic_tools.py` | ToolLoader, plugins, hot-reload | Yes |
 | 14 | `14_rag_basic.py` | RAG pipeline, document loading, vector search | Yes + `[rag]` |
 | 15 | `15_semantic_search.py` | Pure semantic search, metadata filtering | Yes + `[rag]` |
@@ -1289,7 +1307,7 @@ pytest tests/ -x -q          # All tests
 pytest tests/ -k "not e2e"   # Skip E2E (no API keys needed)
 ```
 
-5968 tests covering parsing, agent loop, providers, RAG pipeline, hybrid search, advanced chunking, dynamic tools, caching, streaming, guardrails, sessions, memory, eval framework, budget/cancellation, knowledge stores, orchestration, pipelines, agent patterns, stability markers, trace viewer, serve API, A2A, routing, and E2E integration with real API calls.
+7268 tests covering parsing, agent loop, providers, RAG pipeline, hybrid search, advanced chunking, dynamic tools, caching, streaming, guardrails, sessions, memory, eval framework, budget/cancellation, knowledge stores, orchestration, pipelines, agent patterns, stability markers, trace viewer, serve API, A2A, routing, and E2E integration with real API calls.
 
 ## License
 

{selectools-0.24.0 → selectools-0.25.0}/README.md

@@ -30,6 +30,24 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v0.25
+
+### v0.25.0 — Hardening & v1.0 Prep
+
+Five new features plus the final v1.0 groundwork: the entire 433-symbol public surface is now stability-marked (205 stable, 228 beta) with a CI gate, the long-deprecated `AgentConfig.hooks` is removed, and the security audit is published.
+
+- **Planning-as-config** — `AgentConfig(planning=PlanningConfig(...))` adds plan→execute→synthesize to any agent via isolated clones, with a complexity gate, cross-clone budget caps, and a plan approval handler.
+- **Agent-level HITL** — `ToolConfig(require_approval=[...], approval_handler=...)` gates tool execution behind a sync or async approval callback (fail-closed, denials memoized per run).
+- **Tool result compression** — `ToolConfig(compress_results=True)` summarizes oversized tool results via a one-shot LLM call before they enter context, with raw-text retention for stop conditions and loop detection.
+- **Knowledge pre-save sanitization** — `pre_save` hook on `KnowledgeMemory` plus built-in sanitizers: `defang_delimiters` (prompt-injection markers), `strip_surrogates`, `dedupe_against`.
+- **Pending intent hooks** — `pop_if_intent` (structured confirm/cancel from chat buttons, bypasses the text parser) and `tighten_ttl` (id-pinned atomic Lua rewrite on Redis).
+- **Stability marking sweep** — 100% of the public surface marked; 19 beta→stable promotions (AgentGraph + orchestration core, all 5 pattern agents, checkpoint stores, `RedisSessionStore`, `AzureOpenAIProvider`, ...); module-level `__stability__` on all 123 public modules; CI gate enforces markers forever.
+- **Wart removal** — `Agent.clone_for_isolation()` is public (`@beta`); `__all__` reconciled (11 documented symbols now exported, incl. the Pipeline family and `RouterProvider`); **BREAKING**: `AgentConfig(hooks=...)` now raises `TypeError` (deprecated since v0.16) — migrate to `AgentObserver` via `docs/MIGRATION_1.0.md`.
+- **Security audit published** — `docs/SECURITY_AUDIT.md`: bandit clean at medium/high, all 73 `nosec` suppressions justified, pip-audit pass, SBOM regenerated.
+- **Protocol isinstance fix** — stability markers no longer break third-party `isinstance` checks against `Cache`/`KnowledgeStore`/`CheckpointStore` on Python 3.9–3.11.
+
+See `CHANGELOG.md` for the full entry (7,268 tests, 111 examples).
+
 ## What's New in v0.24
 
 ### v0.24.0 — Production Interop
@@ -55,7 +73,7 @@ from selectools.serve import AgentAPI
 api = AgentAPI(agent, auth_key="secret")  # ASGI app: uvicorn main:api
 ```
 
-See `CHANGELOG.md` for the full entry (5,968 tests, 106 examples).
+See `CHANGELOG.md` for the full entry (6,187 tests, 111 examples).
 
 ## What's New in v0.23
 
@@ -542,7 +560,7 @@ report.to_html("report.html")
 | **Eval Framework** | 50 built-in evaluators (30 deterministic + 21 LLM-as-judge). A/B testing, regression detection, snapshot testing, HTML reports, JUnit XML, CI integration. |
 | **Multi-Agent Orchestration** | `AgentGraph` for directed agent graphs, `SupervisorAgent` with 4 strategies, HITL via generator nodes, parallel execution, checkpointing, subgraph composition. |
 | **Composable Pipelines** | `Pipeline` + `@step` + `|` operator + `parallel()` + `branch()` — chain agents, tools, and transforms with plain Python. |
-| **AgentObserver Protocol** | 45-event lifecycle observer with `run_id`/`call_id` correlation. Built-in `LoggingObserver` + `SimpleStepObserver`. |
+| **AgentObserver Protocol** | 46-event lifecycle observer with `run_id`/`call_id` correlation. Built-in `LoggingObserver` + `SimpleStepObserver`. |
 | **Runtime Controls** | Token/cost budget limits, cooperative cancellation, per-tool approval gates, model switching per iteration. |
 | **Production Hardened** | Retries with backoff, per-tool timeouts, iteration caps, cost warnings, observability hooks + observers. |
 | **Library-First** | Not a framework. No magic globals, no hidden state. Use as much or as little as you need. |
@@ -582,10 +600,10 @@ report.to_html("report.html")
 - **Conversation Branching**: `ConversationMemory.branch()` and `SessionStore.branch()` for A/B exploration and checkpointing
 - **Multi-Agent Orchestration**: `AgentGraph` with routing, parallel execution, HITL, checkpointing; `SupervisorAgent` with 4 strategies (plan_and_execute, round_robin, dynamic, magentic)
 - **Composable Pipelines**: `Pipeline` + `@step` + `|` operator + `parallel()` + `branch()` — chain agents, tools, and transforms
-- **106 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions (incl. Supabase), entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, agent-as-API, A2A, routing, unified memory, and more
+- **111 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions (incl. Supabase), entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, agent-as-API, A2A, routing, unified memory, and more
 - **Built-in Eval Framework**: 50 evaluators (30 deterministic + 21 LLM-as-judge), A/B testing, regression detection, HTML reports, JUnit XML, snapshot testing
-- **AgentObserver Protocol**: 45 lifecycle events with `run_id` correlation, `LoggingObserver`, `SimpleStepObserver`, OTel export
-- **5968 Tests**: Unit, integration, regression, and E2E with real API calls
+- **AgentObserver Protocol**: 46 lifecycle events with `run_id` correlation, `LoggingObserver`, `SimpleStepObserver`, OTel export
+- **7268 Tests**: Unit, integration, regression, and E2E with real API calls
 
 ## Install
 
@@ -911,7 +929,7 @@ agent = Agent(
 )
 ```
 
-45 lifecycle events: run, LLM, tool, iteration, batch, policy, structured output, fallback, retry, memory trim, guardrail, coherence, screening, session, entity, KG, budget exceeded, cancelled, prompt compressed, plus 13 graph events (graph start/end, node start/end, routing, interrupt, resume, parallel, stall, loop, supervisor replan). See `observer.py` for full reference.
+46 lifecycle events: run, LLM, tool, iteration, batch, policy, structured output, fallback, retry, memory trim, guardrail, coherence, screening, session, entity, KG, budget exceeded, cancelled, prompt compressed, plus 13 graph events (graph start/end, node start/end, routing, interrupt, resume, parallel, stall, loop, supervisor replan). See `observer.py` for full reference.
 
 ### E2E Streaming & Parallel Execution
 
@@ -1087,7 +1105,7 @@ Examples are numbered by difficulty. Start from 01 and work your way up.
 |---|---|---|---|
 | 01 | `01_hello_world.py` | First agent, `@tool`, `ask()` | No |
 | 02 | `02_search_weather.py` | ToolRegistry, multiple tools | No |
-| 03 | `03_toolbox.py` | 24 pre-built tools (file, data, text, datetime, web) | No |
+| 03 | `03_toolbox.py` | 48 pre-built tools (file, data, text, datetime, web, code, search, and more) | No |
 | 04 | `04_conversation_memory.py` | Multi-turn memory | Yes |
 | 05 | `05_cost_tracking.py` | Token counting, cost warnings | Yes |
 | 06 | `06_async_agent.py` | `arun()`, concurrent agents, FastAPI | Yes |
@@ -1096,7 +1114,7 @@ Examples are numbered by difficulty. Start from 01 and work your way up.
 | 09 | `09_caching.py` | InMemoryCache, RedisCache, cache stats | Yes |
 | 10 | `10_routing_mode.py` | Routing mode, intent classification | Yes |
 | 11 | `11_tool_analytics.py` | Call counts, success rates, timing | Yes |
-| 12 | `12_observability_hooks.py` | Lifecycle hooks, tool validation | Yes |
+| 12 | `12_observability_hooks.py` | Lifecycle observers, tool validation | Yes |
 | 13 | `13_dynamic_tools.py` | ToolLoader, plugins, hot-reload | Yes |
 | 14 | `14_rag_basic.py` | RAG pipeline, document loading, vector search | Yes + `[rag]` |
 | 15 | `15_semantic_search.py` | Pure semantic search, metadata filtering | Yes + `[rag]` |
@@ -1211,7 +1229,7 @@ pytest tests/ -x -q          # All tests
 pytest tests/ -k "not e2e"   # Skip E2E (no API keys needed)
 ```
 
-5968 tests covering parsing, agent loop, providers, RAG pipeline, hybrid search, advanced chunking, dynamic tools, caching, streaming, guardrails, sessions, memory, eval framework, budget/cancellation, knowledge stores, orchestration, pipelines, agent patterns, stability markers, trace viewer, serve API, A2A, routing, and E2E integration with real API calls.
+7268 tests covering parsing, agent loop, providers, RAG pipeline, hybrid search, advanced chunking, dynamic tools, caching, streaming, guardrails, sessions, memory, eval framework, budget/cancellation, knowledge stores, orchestration, pipelines, agent patterns, stability markers, trace viewer, serve API, A2A, routing, and E2E integration with real API calls.
 
 ## License
 

{selectools-0.24.0 → selectools-0.25.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "selectools"
-version = "0.24.0"
+version = "0.25.0"
 description = "Production-ready Python framework for AI agents with multi-agent graphs, hybrid RAG, guardrails, audit logging, 50 evaluators, and a visual builder. Supports OpenAI, Anthropic, Gemini, Ollama. By NichevLabs."
 readme = "README.md"
 requires-python = ">=3.9"

{selectools-0.24.0 → selectools-0.25.0}/src/selectools/__init__.py

@@ -1,10 +1,10 @@
 """Public exports for the selectools package."""
 
-__version__ = "0.24.0"
+__version__ = "0.25.0"
 
 # Import submodules (lazy loading for optional dependencies)
 from . import embeddings, evals, guardrails, models, observe, patterns, rag, toolbox
-from .agent import Agent, AgentConfig
+from .agent import Agent, AgentConfig, PlanningConfig
 from .agent.config_groups import (
     BudgetConfig,
     CoherenceConfig,
@@ -54,6 +54,7 @@ from .knowledge import (
     KnowledgeEntry,
     KnowledgeMemory,
     KnowledgeStore,
+    PreSaveHook,
     SQLiteKnowledgeStore,
 )
 from .knowledge_backends import (
@@ -67,6 +68,11 @@ from .knowledge_graph import (
     Triple,
     TripleStore,
 )
+from .knowledge_sanitizers import (
+    dedupe_against,
+    defang_delimiters,
+    strip_surrogates,
+)
 from .loop_detection import (
     BaseDetector,
     LoopDetectedError,
@@ -142,7 +148,7 @@ from .pending import (
     stash_pending,
 )
 from .pipeline import Pipeline, Step, StepResult, branch, cache_step, parallel, retry, step
-from .policy import PolicyDecision, PolicyResult, ToolPolicy
+from .policy import ApprovalRequest, PolicyDecision, PolicyResult, ToolPolicy
 from .pricing import PRICING, calculate_cost, calculate_embedding_cost, get_model_pricing
 from .prompt import REASONING_STRATEGIES, PromptBuilder
 from .providers.anthropic_provider import AnthropicProvider
@@ -152,6 +158,7 @@ from .providers.gemini_provider import GeminiProvider
 from .providers.litellm_provider import LiteLLMProvider
 from .providers.ollama_provider import OllamaProvider
 from .providers.openai_provider import OpenAIProvider
+from .providers.router import RouterConfig, RouterProvider
 from .providers.stubs import LocalProvider
 from .results import Ambiguous, Artifact, NotFound, ToolResult, emit_artifact
 from .sessions import (
@@ -184,6 +191,7 @@ from .usage import AgentUsage, UsageStats
 __all__ = [
     "Agent",
     "AgentConfig",
+    "PlanningConfig",
     "AgentResult",
     "AgentAnalytics",
     "ToolMetrics",
@@ -205,10 +213,22 @@ __all__ = [
     "GeminiProvider",
     "OllamaProvider",
     "LiteLLMProvider",
+    "RouterProvider",
+    "RouterConfig",
     "LocalProvider",
     "FallbackProvider",
     "ToolRegistry",
     "tool",
+    # Pipeline composition (public since 0.19.3, @beta)
+    "Pipeline",
+    "Step",
+    "StepResult",
+    "compose",
+    "step",
+    "parallel",
+    "branch",
+    "retry",
+    "cache_step",
     # Cancellation
     "CancellationToken",
     # Exceptions
@@ -247,6 +267,7 @@ __all__ = [
     "SemanticCache",
     # Tool policy
     "ToolPolicy",
+    "ApprovalRequest",
     "PolicyDecision",
     "PolicyResult",
     # Structured output
@@ -334,6 +355,11 @@ __all__ = [
     "KnowledgeBackend",
     "SupabaseKnowledgeBackend",
     "RedisKnowledgeBackend",
+    # Knowledge pre-save sanitizers (beta)
+    "PreSaveHook",
+    "defang_delimiters",
+    "strip_surrogates",
+    "dedupe_against",
     # Token estimation
     "TokenEstimate",
     "estimate_tokens",

selectools-0.25.0/src/selectools/_json_utils.py

@@ -0,0 +1,37 @@
+"""Internal JSON helpers shared across modules.
+
+Home for JSON-parsing utilities that multiple subsystems need (orchestration
+supervisor, team-lead and plan-and-execute patterns). Internal — not part of
+the public API.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+from typing import Any
+
+_JSON_BLOCK_RE = re.compile(r"(\[.*\]|\{.*\})", re.DOTALL)
+
+
+def safe_json_parse(text: str, default: Any = None) -> Any:
+    """Try to extract and parse JSON from an LLM response.
+
+    Strips markdown code fences, then attempts a direct parse; falls back to
+    extracting the first JSON array or object embedded in surrounding prose.
+    Returns *default* when nothing parses.
+    """
+    text = text.strip()
+    if text.startswith("```"):
+        lines = text.splitlines()
+        text = "\n".join(lines[1:-1] if lines[-1].strip() == "```" else lines[1:])
+    try:
+        return json.loads(text)
+    except json.JSONDecodeError:
+        m = _JSON_BLOCK_RE.search(text)
+        if m:
+            try:
+                return json.loads(m.group(1))
+            except json.JSONDecodeError:
+                pass
+    return default

{selectools-0.24.0 → selectools-0.25.0}/src/selectools/a2a/__init__.py

@@ -25,6 +25,8 @@ from typing import Any
 
 from .types import A2AError, A2ATask, AgentCard, AgentSkill, TaskState
 
+__stability__ = "beta"
+
 __all__ = [
     "A2AClient",
     "A2AError",

{selectools-0.24.0 → selectools-0.25.0}/src/selectools/a2a/client.py

@@ -26,6 +26,8 @@ from .._async_utils import run_sync
 from ..stability import beta
 from .types import A2AError, A2ATask, AgentCard
 
+__stability__ = "beta"
+
 __all__ = ["A2AClient"]
 
 

{selectools-0.24.0 → selectools-0.25.0}/src/selectools/a2a/server.py

@@ -58,6 +58,8 @@ from .types import (
 if TYPE_CHECKING:
     from ..agent.core import Agent
 
+__stability__ = "beta"
+
 __all__ = ["A2AServer"]
 
 logger = logging.getLogger(__name__)
@@ -328,12 +330,11 @@ class A2AServer:
         try:
             # Run on an isolated clone: Agent.run mutates shared _history (and
             # memory), which would leak caller A's conversation into caller B's
-            # provider context and race under concurrency. _clone_for_isolation
+            # provider context and race under concurrency. clone_for_isolation
             # (same mechanism run_batch uses) shares tools/provider/config but
             # gives fresh history/usage and drops memory — correct for A2A v1,
-            # which has no session model. It is underscore-private today;
-            # promoting it to a public API is a follow-up.
-            clone = self._agent._clone_for_isolation()
+            # which has no session model.
+            clone = self._agent.clone_for_isolation()
             result = await run_in_threadpool(clone.run, [Message(role=Role.USER, content=prompt)])
         except Exception as exc:
             # Agent failure is a task-level outcome, not a transport error.

{selectools-0.24.0 → selectools-0.25.0}/src/selectools/a2a/types.py

@@ -13,6 +13,8 @@ from typing import Any, Dict, List, Optional
 
 from ..stability import beta
 
+__stability__ = "beta"
+
 __all__ = ["A2AError", "AgentCard", "AgentSkill", "A2ATask", "TaskState"]
 
 # A2A JSON-RPC protocol version advertised in the Agent Card.

selectools-0.25.0/src/selectools/agent/__init__.py

@@ -0,0 +1,10 @@
+"""
+Public exports for the agent package.
+"""
+
+from .config import AgentConfig, PlanningConfig
+from .core import Agent
+
+__stability__ = "stable"
+
+__all__ = ["Agent", "AgentConfig", "PlanningConfig"]