selectools 0.27.1__tar.gz → 0.27.2__tar.gz

{selectools-0.27.1/src/selectools.egg-info → selectools-0.27.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.27.1
+Version: 0.27.2
 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>
@@ -116,6 +116,10 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 
 ## What's New in v0.27
 
+### v0.27.2 — Provider Model Fix & Tool-less Agents
+
+Fixes a P0: the agent ignored every provider's default model and sent `gpt-5-mini` to all of them, so **any non-OpenAI provider (Anthropic, Gemini, Ollama, LiteLLM) 404'd on every request**. `AgentConfig.model` now defaults to `None` and resolves to the provider's own default. Also: `Agent(tools=[])` is now valid (pure conversational agents), and the structured-output (`result.parsed` vs `.content`) and streaming (accumulate `StreamChunk` deltas, not the terminal `AgentResult`) sharp edges are documented.
+
 ### v0.27.1 — Bug-Hunt Patch
 
 An adversarial bug hunt of the v0.27.0 surface fixed 10 confirmed bugs (no API changes, no breaking changes). Highlights: scheduled agents recorded the `AgentResult` repr instead of the answer text; `PromptInjectionGuardrail` blocked benign requests ("pretend you are a pirate", "show the rules"); `s3_get_object` leaked its HTTP connection; and unified memory persisted un-redacted input in async mode. See `CHANGELOG.md` for the full list.

{selectools-0.27.1 → selectools-0.27.2}/README.md

@@ -32,6 +32,10 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 
 ## What's New in v0.27
 
+### v0.27.2 — Provider Model Fix & Tool-less Agents
+
+Fixes a P0: the agent ignored every provider's default model and sent `gpt-5-mini` to all of them, so **any non-OpenAI provider (Anthropic, Gemini, Ollama, LiteLLM) 404'd on every request**. `AgentConfig.model` now defaults to `None` and resolves to the provider's own default. Also: `Agent(tools=[])` is now valid (pure conversational agents), and the structured-output (`result.parsed` vs `.content`) and streaming (accumulate `StreamChunk` deltas, not the terminal `AgentResult`) sharp edges are documented.
+
 ### v0.27.1 — Bug-Hunt Patch
 
 An adversarial bug hunt of the v0.27.0 surface fixed 10 confirmed bugs (no API changes, no breaking changes). Highlights: scheduled agents recorded the `AgentResult` repr instead of the answer text; `PromptInjectionGuardrail` blocked benign requests ("pretend you are a pirate", "show the rules"); `s3_get_object` leaked its HTTP connection; and unified memory persisted un-redacted input in async mode. See `CHANGELOG.md` for the full list.

{selectools-0.27.1 → selectools-0.27.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "selectools"
-version = "0.27.1"
+version = "0.27.2"
 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.27.1 → selectools-0.27.2}/src/selectools/__init__.py

@@ -1,6 +1,6 @@
 """Public exports for the selectools package."""
 
-__version__ = "0.27.1"
+__version__ = "0.27.2"
 
 # Import submodules (lazy loading for optional dependencies)
 from . import embeddings, evals, guardrails, models, observe, patterns, rag, toolbox

{selectools-0.27.1 → selectools-0.27.2}/src/selectools/agent/config.py

@@ -123,7 +123,10 @@ class AgentConfig:
     """
 
     name: str = "agent"
-    model: str = "gpt-5-mini"
+    # None means "use the provider's own default_model". A hardcoded default
+    # here would be sent to EVERY provider — e.g. an OpenAI model id reaching
+    # the Anthropic API and 404-ing on every call.
+    model: Optional[str] = None
     temperature: float = 0.0
     max_tokens: int = 1000
     max_iterations: int = 6

{selectools-0.27.1 → selectools-0.27.2}/src/selectools/agent/core.py

@@ -160,11 +160,10 @@ class Agent(_ToolExecutorMixin, _ProviderCallerMixin, _LifecycleMixin, _MemoryMa
             ...     memory=ConversationMemory(max_messages=20)
             ... )
         """
-        if not tools:
-            raise ValueError("Agent requires at least one tool.")
-
-        self.tools = tools
-        self._tools_by_name = {tool.name: tool for tool in tools}
+        # An empty tool list is valid: a pure conversational agent (no tools)
+        # is a normal use case — the provider is simply called with no tools.
+        self.tools = tools or []
+        self._tools_by_name = {tool.name: tool for tool in self.tools}
         self.provider = provider or OpenAIProvider()
         strategy = config.reasoning_strategy if config else None
         if prompt_builder:
@@ -248,10 +247,16 @@ class Agent(_ToolExecutorMixin, _ProviderCallerMixin, _LifecycleMixin, _MemoryMa
     def _effective_model(self) -> str:
         """The model to use for the current iteration.
 
-        Returns the model set by ``model_selector`` if active, otherwise
-        falls back to ``self.config.model``.
+        Resolution order: a ``model_selector`` override, then an explicit
+        ``config.model``, then the provider's own ``default_model``. Without the
+        provider fallback a non-OpenAI provider would receive the OpenAI default
+        and 404. The final ``"gpt-5-mini"`` only applies to providers that expose
+        no default (e.g. the LocalProvider stub, which ignores the model).
         """
-        return getattr(self, "_current_model", None) or self.config.model
+        override = getattr(self, "_current_model", None) or self.config.model
+        if override:
+            return override
+        return getattr(self.provider, "default_model", None) or "gpt-5-mini"
 
     def __call__(
         self,
@@ -316,14 +321,11 @@ class Agent(_ToolExecutorMixin, _ProviderCallerMixin, _LifecycleMixin, _MemoryMa
 
         Raises:
             KeyError: If no tool with that name exists.
-            ValueError: If removing would leave the agent with zero tools.
         """
         if tool_name not in self._tools_by_name:
             raise KeyError(
                 f"Tool '{tool_name}' not found. Available: {', '.join(self._tools_by_name.keys())}"
             )
-        if len(self.tools) <= 1:
-            raise ValueError("Agent requires at least one tool.")
 
         removed = self._tools_by_name.pop(tool_name)
         self.tools = [t for t in self.tools if t.name != tool_name]
@@ -1391,8 +1393,21 @@ class Agent(_ToolExecutorMixin, _ProviderCallerMixin, _LifecycleMixin, _MemoryMa
             parent_run_id: Optional run-ID of a parent agent for trace linking.
 
         Yields:
-            StreamChunk: Intermediate content chunks.
-            AgentResult: The final result object (yielded at the very end).
+            StreamChunk: incremental content deltas (and tool-call chunks).
+            AgentResult: the final, complete result — yielded once at the very
+                end. Its ``.content`` is the WHOLE answer, not a delta.
+
+        Consuming the stream — accumulate the ``StreamChunk`` deltas and treat
+        the terminal ``AgentResult`` separately. Do NOT add the final
+        ``AgentResult.content`` to the accumulated deltas, or you will get the
+        answer twice::
+
+            text = ""
+            async for chunk in agent.astream("..."):
+                if isinstance(chunk, StreamChunk):
+                    text += chunk.content or ""   # deltas only
+                else:                              # AgentResult (terminal)
+                    result = chunk                 # full answer + metadata
         """
         messages = self._normalize_messages(messages)
 

{selectools-0.27.1 → selectools-0.27.2}/src/selectools/serve/app.py

@@ -172,7 +172,9 @@ class AgentRouter:
         response = HealthResponse(
             status="ok",
             version=__version__,
-            model=self.agent.config.model,
+            # Report the resolved model (config.model may be None = use the
+            # provider's default).
+            model=self.agent._effective_model,
             provider=getattr(self.agent.provider, "name", "unknown"),
             tools=[t.name for t in self.agent.tools],
         )
@@ -188,7 +190,7 @@ class AgentRouter:
         """Handle GET /schema."""
         return {
             "tools": [t.schema() for t in self.agent.tools],
-            "model": self.agent.config.model,
+            "model": self.agent._effective_model,
         }
 
 

{selectools-0.27.1 → selectools-0.27.2}/src/selectools/types.py

@@ -328,6 +328,15 @@ class AgentResult:
         {'query': 'Python'}
         >>> result.iterations
         2
+
+    Structured output: when ``response_format`` is set, the validated object is
+    on ``result.parsed`` — ``result.content`` stays the raw JSON *text*::
+
+        >>> result = agent.run("Extract: John is 30", response_format=Person)
+        >>> result.parsed           # the typed object you want
+        Person(name='John', age=30)
+        >>> result.content          # the JSON string, NOT the object
+        '{"name": "John", "age": 30}'
     """
 
     message: Message

{selectools-0.27.1 → selectools-0.27.2/src/selectools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.27.1
+Version: 0.27.2
 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>
@@ -116,6 +116,10 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 
 ## What's New in v0.27
 
+### v0.27.2 — Provider Model Fix & Tool-less Agents
+
+Fixes a P0: the agent ignored every provider's default model and sent `gpt-5-mini` to all of them, so **any non-OpenAI provider (Anthropic, Gemini, Ollama, LiteLLM) 404'd on every request**. `AgentConfig.model` now defaults to `None` and resolves to the provider's own default. Also: `Agent(tools=[])` is now valid (pure conversational agents), and the structured-output (`result.parsed` vs `.content`) and streaming (accumulate `StreamChunk` deltas, not the terminal `AgentResult`) sharp edges are documented.
+
 ### v0.27.1 — Bug-Hunt Patch
 
 An adversarial bug hunt of the v0.27.0 surface fixed 10 confirmed bugs (no API changes, no breaking changes). Highlights: scheduled agents recorded the `AgentResult` repr instead of the answer text; `PromptInjectionGuardrail` blocked benign requests ("pretend you are a pirate", "show the rules"); `s3_get_object` leaked its HTTP connection; and unified memory persisted un-redacted input in async mode. See `CHANGELOG.md` for the full list.

{selectools-0.27.1 → selectools-0.27.2}/tests/test_model_switching.py

@@ -157,3 +157,49 @@ class TestModelSwitching:
         # If it weren't reset, the second run would start with "switched"
         # instead of "default", and model_selector would see it's already
         # "switched" and not fire on_model_switch
+
+
+# --------------------------------------------------------------------------- #
+# Bug hunt 2026-06-14: agent must use the provider's default_model, not a
+# hardcoded "gpt-5-mini", when config.model is unset.
+# --------------------------------------------------------------------------- #
+
+
+class _ModelCapturingProvider:
+    """Records the `model` the agent passes to complete()."""
+
+    name = "capture"
+
+    def __init__(self, default_model: str) -> None:
+        self.default_model = default_model
+        self.seen_models: list = []
+
+    def complete(self, *, model=None, system_prompt="", messages, tools=None, **kw):
+        self.seen_models.append(model)
+        return _resp("done")
+
+    async def acomplete(self, *, model=None, system_prompt="", messages, tools=None, **kw):
+        self.seen_models.append(model)
+        return _resp("done")
+
+
+def test_uses_provider_default_model_when_config_model_unset():
+    prov = _ModelCapturingProvider(default_model="claude-sonnet-4-6")
+    agent = Agent(tools=[_DUMMY], provider=prov, config=AgentConfig())
+    assert agent._effective_model == "claude-sonnet-4-6"
+    agent.run("hi")
+    assert prov.seen_models == ["claude-sonnet-4-6"]  # NOT "gpt-5-mini"
+
+
+def test_explicit_config_model_overrides_provider_default():
+    prov = _ModelCapturingProvider(default_model="claude-sonnet-4-6")
+    agent = Agent(tools=[_DUMMY], provider=prov, config=AgentConfig(model="gpt-4o"))
+    assert agent._effective_model == "gpt-4o"
+    agent.run("hi")
+    assert prov.seen_models == ["gpt-4o"]
+
+
+def test_config_model_defaults_to_none():
+    # The default must be None (sentinel for "use the provider default"), not a
+    # hardcoded model id that would reach every provider.
+    assert AgentConfig().model is None