selectools 0.29.0__tar.gz → 1.0.0__tar.gz

{selectools-0.29.0/src/selectools.egg-info → selectools-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.29.0
+Version: 1.0.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>
@@ -14,17 +14,16 @@ Project-URL: Builder, https://selectools.dev/builder/
 Project-URL: Examples, https://selectools.dev/examples/
 Project-URL: NichevLabs, https://nichevlabs.com
 Keywords: llm,ai,agent,agents,multi-agent,agent-framework,tool-calling,openai,anthropic,gemini,ollama,rag,hybrid-search,vector-search,embeddings,guardrails,evals,evaluators,visual-builder,structured-output,observability,fallback,langchain-alternative
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai<2.0.0,>=1.30.0
@@ -118,6 +117,16 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v1.0
+
+### v1.0.0 — Stable
+
+selectools is **1.0**. The public API is frozen and `@stable` symbols now carry a real compatibility promise — no removal or breaking signature change without a deprecation cycle spanning at least two minor releases. The package is `Development Status :: 5 - Production/Stable`.
+
+- **Frozen, marked surface** — every public symbol carries a `@stable`/`@beta` marker (CI-enforced). The stable set covers the agent loop and config, providers, tools and the mature toolbox, sessions, memory, guardrails, orchestration graphs, the pattern agents, the policy layer, and the core types. RAG/embeddings, MCP, A2A, the evaluator catalog, unified memory, the scheduler, and the newest backends stay `@beta` and keep evolving in 1.x.
+- **Python 3.10+** *(breaking)* — Python 3.9 reached end-of-life in October 2025 and is dropped; the minimum is now 3.10 (CI runs 3.10–3.13). Pin `selectools<1.0` to stay on 3.9.
+- Aside from the 3.9 drop, code that ran deprecation-warning-free on the latest 0.x release runs unmodified on 1.0. See `docs/MIGRATION_1.0.md`.
+
 ## What's New in v0.29
 
 ### v0.29.0 — Stability Promotions (v1.0 Freeze Prep)
@@ -349,19 +358,25 @@ selectools serve --builder
 
 ### v0.19.3 — Stability Markers Applied to All Public APIs
 
-Every public class and function exported from `selectools` now carries a stability marker:
+Every public class and function exported from `selectools` carries a stability
+marker. As of 1.0, `@stable` symbols carry a compatibility promise — no removal
+or breaking signature change without a deprecation cycle of at least two minors:
 
 ```python
-from selectools import Agent, AgentGraph, PlanAndExecuteAgent
+from selectools import Agent, AgentGraph, AgentScheduler
 
-print(Agent.__stability__)               # "stable"
-print(AgentGraph.__stability__)          # "beta"
-print(PlanAndExecuteAgent.__stability__) # "beta"
+print(Agent.__stability__)          # "stable"
+print(AgentGraph.__stability__)     # "stable"  (promoted for 1.0)
+print(AgentScheduler.__stability__) # "beta"    (still iterating)
 ```
 
-**`@stable`** — 60+ core symbols (Agent, AgentConfig, providers, memory, tools, evals, guardrails, sessions, knowledge, cache, cancellation)
+**`@stable`** — the frozen core: Agent, AgentConfig, providers, memory, tools and
+the mature toolbox, sessions, guardrails, orchestration graphs, the pattern
+agents, the policy layer, and the core types.
 
-**`@beta`** — 30+ newer symbols (AgentGraph, SupervisorAgent, Pipeline, @step, parallel, branch, all four patterns, compose)
+**`@beta`** — subsystems still evolving in 1.x: RAG/embeddings, MCP, A2A, the
+evaluator catalog, unified memory, the scheduler, and the newest backends. Run
+`python scripts/stability_audit.py` for the live marker map.
 
 ### v0.19.2 — Enterprise Hardening
 
@@ -555,7 +570,7 @@ def web_search(query: str) -> str:
     return expensive_api_call(query)
 ```
 
-Also: Python 3.9–3.13 CI matrix (verified zero compatibility issues).
+Also: Python 3.10–3.13 CI matrix (verified zero compatibility issues).
 
 </details>
 

{selectools-0.29.0 → selectools-1.0.0}/README.md

@@ -30,6 +30,16 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v1.0
+
+### v1.0.0 — Stable
+
+selectools is **1.0**. The public API is frozen and `@stable` symbols now carry a real compatibility promise — no removal or breaking signature change without a deprecation cycle spanning at least two minor releases. The package is `Development Status :: 5 - Production/Stable`.
+
+- **Frozen, marked surface** — every public symbol carries a `@stable`/`@beta` marker (CI-enforced). The stable set covers the agent loop and config, providers, tools and the mature toolbox, sessions, memory, guardrails, orchestration graphs, the pattern agents, the policy layer, and the core types. RAG/embeddings, MCP, A2A, the evaluator catalog, unified memory, the scheduler, and the newest backends stay `@beta` and keep evolving in 1.x.
+- **Python 3.10+** *(breaking)* — Python 3.9 reached end-of-life in October 2025 and is dropped; the minimum is now 3.10 (CI runs 3.10–3.13). Pin `selectools<1.0` to stay on 3.9.
+- Aside from the 3.9 drop, code that ran deprecation-warning-free on the latest 0.x release runs unmodified on 1.0. See `docs/MIGRATION_1.0.md`.
+
 ## What's New in v0.29
 
 ### v0.29.0 — Stability Promotions (v1.0 Freeze Prep)
@@ -261,19 +271,25 @@ selectools serve --builder
 
 ### v0.19.3 — Stability Markers Applied to All Public APIs
 
-Every public class and function exported from `selectools` now carries a stability marker:
+Every public class and function exported from `selectools` carries a stability
+marker. As of 1.0, `@stable` symbols carry a compatibility promise — no removal
+or breaking signature change without a deprecation cycle of at least two minors:
 
 ```python
-from selectools import Agent, AgentGraph, PlanAndExecuteAgent
+from selectools import Agent, AgentGraph, AgentScheduler
 
-print(Agent.__stability__)               # "stable"
-print(AgentGraph.__stability__)          # "beta"
-print(PlanAndExecuteAgent.__stability__) # "beta"
+print(Agent.__stability__)          # "stable"
+print(AgentGraph.__stability__)     # "stable"  (promoted for 1.0)
+print(AgentScheduler.__stability__) # "beta"    (still iterating)
 ```
 
-**`@stable`** — 60+ core symbols (Agent, AgentConfig, providers, memory, tools, evals, guardrails, sessions, knowledge, cache, cancellation)
+**`@stable`** — the frozen core: Agent, AgentConfig, providers, memory, tools and
+the mature toolbox, sessions, guardrails, orchestration graphs, the pattern
+agents, the policy layer, and the core types.
 
-**`@beta`** — 30+ newer symbols (AgentGraph, SupervisorAgent, Pipeline, @step, parallel, branch, all four patterns, compose)
+**`@beta`** — subsystems still evolving in 1.x: RAG/embeddings, MCP, A2A, the
+evaluator catalog, unified memory, the scheduler, and the newest backends. Run
+`python scripts/stability_audit.py` for the live marker map.
 
 ### v0.19.2 — Enterprise Hardening
 
@@ -467,7 +483,7 @@ def web_search(query: str) -> str:
     return expensive_api_call(query)
 ```
 
-Also: Python 3.9–3.13 CI matrix (verified zero compatibility issues).
+Also: Python 3.10–3.13 CI matrix (verified zero compatibility issues).
 
 </details>
 

{selectools-0.29.0 → selectools-1.0.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "selectools"
-version = "0.29.0"
+version = "1.0.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"
+requires-python = ">=3.10"
 license = "Apache-2.0"
 authors = [{name = "John Nichev", email = "johnnichev@gmail.com"}]
 maintainers = [{name = "NichevLabs", email = "support@nichevlabs.com"}]
@@ -25,10 +25,9 @@ keywords = [
     "structured-output", "observability", "fallback", "langchain-alternative",
 ]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -130,7 +129,7 @@ where = ["src"]
 
 [tool.ruff]
 line-length = 100
-target-version = "py39"
+target-version = "py310"
 extend-exclude = [
     ".eggs",
     ".git",

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/__init__.py

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

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/_async_utils.py

@@ -16,8 +16,15 @@ import asyncio
 import contextvars
 import threading
 from concurrent.futures import ThreadPoolExecutor
+from contextlib import aclosing
 from typing import Any, Awaitable, Callable, Optional, TypeVar
 
+# ``aclosing`` is re-exported from this module so existing call sites
+# (agent._provider_caller, agent.core) and the regression test that imports it
+# from here are unchanged. It was a local backport while selectools supported
+# 3.9; the floor is now >=3.10, where ``contextlib.aclosing`` is stdlib.
+__all__ = ["aclosing", "run_sync", "run_in_executor_copyctx"]
+
 T = TypeVar("T")
 
 # Module-level singleton for running coroutines from sync code that is
@@ -63,36 +70,6 @@ def run_sync(coro: Awaitable[T]) -> T:
     return future.result()
 
 
-class aclosing:  # noqa: N801 — intentionally matches stdlib contextlib.aclosing
-    """Async context manager that calls ``aclose()`` on exit.
-
-    BUG-33 / Pydantic AI PRs #4476, #4205: ``async for item in gen:``
-    without a context manager leaks the async generator when the loop
-    body raises — ``gen.__aexit__`` runs under GC instead of
-    deterministically. ``contextlib.aclosing`` fixes this, but was only
-    added in Python 3.10 and selectools supports 3.9+. This class is a
-    drop-in backport that works on any Python version.
-
-    Usage::
-
-        async with aclosing(provider.astream(...)) as gen:
-            async for item in gen:
-                if stop_condition(item):
-                    break  # provider gen gets aclose()'d on exit
-    """
-
-    def __init__(self, thing: Any) -> None:
-        self._thing = thing
-
-    async def __aenter__(self) -> Any:
-        """Return the wrapped async iterable so callers can iterate it."""
-        return self._thing
-
-    async def __aexit__(self, *_exc: Any) -> None:
-        """Call ``aclose()`` on the wrapped async iterable on exit."""
-        await self._thing.aclose()
-
-
 async def run_in_executor_copyctx(
     loop: asyncio.AbstractEventLoop,
     executor: Optional[Any],

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/agent/_tool_executor.py

@@ -1215,7 +1215,7 @@ class _ToolExecutorMixin:
                     for i in candidate_indices
                 ]
             )
-            for i, text in zip(candidate_indices, compressed_texts):
+            for i, text in zip(candidate_indices, compressed_texts, strict=False):
                 compressed_by_index[i] = text
                 self._store_compressed_in_cache(
                     results[i].tool, results[i].tool_call.parameters, results[i].result, text

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/agent/core.py

@@ -1593,7 +1593,7 @@ class Agent(_ToolExecutorMixin, _ProviderCallerMixin, _LifecycleMixin, _MemoryMa
                     # finally block and releases HTTP connections — instead
                     # of waiting for GC and emitting `async generator raised
                     # StopAsyncIteration` warnings.
-                    async with aclosing(
+                    async with aclosing(  # type: ignore[type-var]  # astream is an async generator (has aclose) but typed AsyncIterable
                         self.provider.astream(
                             model=self._effective_model,
                             system_prompt=self._system_prompt,

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/cache.py

@@ -287,7 +287,7 @@ class CacheKeyBuilder:
 
 
 # Cache is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("Cache", "stable")
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/cache_semantic.py

@@ -210,7 +210,7 @@ class SemanticCache:
 
 def _cosine_similarity(a: List[float], b: List[float]) -> float:
     """Compute cosine similarity between two vectors (pure Python, no numpy)."""
-    dot = sum(x * y for x, y in zip(a, b))
+    dot = sum(x * y for x, y in zip(a, b, strict=False))
     norm_a = math.sqrt(sum(x * x for x in a))
     norm_b = math.sqrt(sum(x * x for x in b))
     if norm_a == 0.0 or norm_b == 0.0:

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/evals/evaluators.py

@@ -1248,6 +1248,6 @@ DEFAULT_EVALUATORS: List[Any] = [
 
 
 # Evaluator is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("Evaluator", "beta")

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/evals/pairwise.py

@@ -167,7 +167,7 @@ class PairwiseEval:
         report_b = suite_b.run()
 
         pairwise_results: List[PairwiseCaseResult] = []
-        for cr_a, cr_b in zip(report_a.case_results, report_b.case_results):
+        for cr_a, cr_b in zip(report_a.case_results, report_b.case_results, strict=False):
             winner, reason = self._compare_case(cr_a, cr_b)
             pairwise_results.append(
                 PairwiseCaseResult(

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/guardrails/topic.py

@@ -49,7 +49,7 @@ class TopicGuardrail(Guardrail):
         normalized = re.sub(r"[\u200b\u200c\u200d\ufeff\u00ad]", "", normalized)
 
         matched: List[str] = []
-        for pattern, topic in zip(self._patterns, self.deny):
+        for pattern, topic in zip(self._patterns, self.deny, strict=False):
             if pattern.search(normalized):
                 matched.append(topic)
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/knowledge.py

@@ -954,7 +954,7 @@ class KnowledgeMemory:
 
 
 # KnowledgeStore is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("KnowledgeStore", "stable")
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/knowledge_graph.py

@@ -491,7 +491,7 @@ class KnowledgeGraphMemory:
 
 
 # TripleStore is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("TripleStore", "beta")
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/loop_detection.py

@@ -159,7 +159,7 @@ class StallDetector(BaseDetector):
         result_window = tool_results[-self.threshold :]
         first_name = call_window[0].tool_name
         first_hash = _result_hash(result_window[0])
-        for call, result in zip(call_window[1:], result_window[1:]):
+        for call, result in zip(call_window[1:], result_window[1:], strict=False):
             if call.tool_name != first_name:
                 return None
             if _result_hash(result) != first_hash:

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/observe/trace_store.py

@@ -390,7 +390,7 @@ class JSONLTraceStore:
 
 
 # TraceStore is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("TraceStore", "beta")
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/orchestration/checkpoint.py

@@ -388,7 +388,7 @@ class SQLiteCheckpointStore:
 
 
 # CheckpointStore is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("CheckpointStore", "stable")
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/orchestration/graph.py

@@ -271,7 +271,7 @@ class AgentGraph:
         node_names = names or [f"step_{i}" for i in range(len(agents))]
         if len(node_names) != len(agents):
             raise ValueError(f"names length ({len(node_names)}) != agents length ({len(agents)})")
-        for i, (nname, agent) in enumerate(zip(node_names, agents)):
+        for i, (nname, agent) in enumerate(zip(node_names, agents, strict=False)):
             graph.add_node(nname, agent)
             if i > 0:
                 graph.add_edge(node_names[i - 1], nname)
@@ -1449,7 +1449,7 @@ class AgentGraph:
             child_outputs = await asyncio.gather(
                 *[
                     run_child(name, bstate)
-                    for name, bstate in zip(node.child_node_names, branch_states)
+                    for name, bstate in zip(node.child_node_names, branch_states, strict=False)
                 ],
                 return_exceptions=True,
             )

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/providers/base.py

@@ -124,7 +124,7 @@ class Provider(Protocol):
 
 
 # Provider is @runtime_checkable: a ``__stability__`` class attribute would become
-# a structural protocol member on Python 3.9-3.11 and break ``isinstance()``
+# a structural protocol member on Python 3.10-3.11 and break ``isinstance()``
 # for implementations that do not define it, so it is registered instead.
 register_stability("Provider", "stable")
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/chunking.py

@@ -301,7 +301,7 @@ def _split_into_sentences(text: str) -> List[str]:
 
 def _cosine_similarity(a: List[float], b: List[float]) -> float:
     """Compute cosine similarity between two vectors without numpy."""
-    dot = sum(x * y for x, y in zip(a, b))
+    dot = sum(x * y for x, y in zip(a, b, strict=False))
     norm_a = math.sqrt(sum(x * x for x in a))
     norm_b = math.sqrt(sum(x * x for x in b))
     if norm_a == 0 or norm_b == 0:
@@ -531,7 +531,7 @@ class ContextualChunker:
             chunk_origins.extend([idx] * len(chunks))
 
         enriched: List[Document] = []
-        for chunk_doc, origin_idx in zip(all_base_chunks, chunk_origins):
+        for chunk_doc, origin_idx in zip(all_base_chunks, chunk_origins, strict=False):
             full_text = doc_text_map[origin_idx]
             truncated_doc = full_text[: self.max_document_chars]
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/hybrid.py

@@ -257,14 +257,14 @@ class HybridSearcher:
         doc_scores: Dict[int, float] = {}
         doc_map: Dict[int, SearchResult] = {}
 
-        for result, norm_score in zip(vector_results, v_normalised):
+        for result, norm_score in zip(vector_results, v_normalised, strict=False):
             key = id(result.document)
             doc_scores[key] = self.vector_weight * norm_score
             doc_map[key] = result
 
         text_to_key = {doc_map[key].document.text: key for key in doc_map}
 
-        for result, norm_score in zip(keyword_results, k_normalised):
+        for result, norm_score in zip(keyword_results, k_normalised, strict=False):
             matched_key = text_to_key.get(result.document.text)
             if matched_key is not None:
                 key = matched_key

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/stores/faiss.py

@@ -258,7 +258,7 @@ class FAISSVectorStore(VectorStore):
 
         results: List[SearchResult] = []
         seen_texts: set = set()
-        for score, idx in zip(scores[0], indices[0]):
+        for score, idx in zip(scores[0], indices[0], strict=False):
             # FAISS returns -1 for empty slots
             if idx < 0:
                 continue

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/stores/pgvector.py

@@ -282,7 +282,7 @@ class PgVectorStore(VectorStore):
         try:
             cursor = conn.cursor()
 
-            for doc_id, doc, embedding in zip(ids, documents, embeddings):
+            for doc_id, doc, embedding in zip(ids, documents, embeddings, strict=False):
                 embedding_str = "[" + ",".join(str(v) for v in embedding) + "]"
                 metadata_json = json.dumps(doc.metadata or {})
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/stores/pinecone.py

@@ -116,7 +116,7 @@ class PineconeVectorStore(VectorStore):
         # Generate IDs and prepare vectors
         vectors = []
         ids = []
-        for i, (doc, embedding) in enumerate(zip(documents, embeddings)):
+        for i, (doc, embedding) in enumerate(zip(documents, embeddings, strict=False)):
             doc_id = f"doc_{hashlib.sha256(doc.text.encode()).hexdigest()[:16]}_{i}"
             ids.append(doc_id)
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/stores/qdrant.py

@@ -218,7 +218,7 @@ class QdrantVectorStore(VectorStore):
         ids: List[str] = []
         points: List[Any] = []
 
-        for doc, embedding in zip(documents, embeddings):
+        for doc, embedding in zip(documents, embeddings, strict=False):
             doc_id = uuid.uuid4().hex
             ids.append(doc_id)
 

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/rag/stores/sqlite.py

@@ -131,7 +131,7 @@ class SQLiteVectorStore(VectorStore):
             conn = sqlite3.connect(self.db_path)
             try:
                 cursor = conn.cursor()
-                for doc_id, doc, embedding in zip(ids, documents, embeddings):
+                for doc_id, doc, embedding in zip(ids, documents, embeddings, strict=False):
                     cursor.execute(
                         """
                         INSERT OR REPLACE INTO documents (id, text, metadata, embedding)

{selectools-0.29.0 → selectools-1.0.0}/src/selectools/stability.py

@@ -25,7 +25,7 @@ Some public symbols cannot carry a ``__stability__`` attribute:
 
 - module-level constants (``str``/``float``/``list``/``dict``/``tuple`` instances)
 - typing aliases (``Union[...]``, ``Callable[...]``, and friends)
-- ``@runtime_checkable`` Protocol classes — on Python 3.9-3.11 a
+- ``@runtime_checkable`` Protocol classes — on Python 3.10-3.11 a
   ``__stability__`` class attribute becomes a structural member of the
   protocol and silently breaks ``isinstance()`` for conforming
   implementations that do not define it.
@@ -162,7 +162,7 @@ def register_stability(name: str, level: str) -> None:
 
     Use this for module-level constants, typing aliases, and
     ``@runtime_checkable`` Protocol classes (decorating those would change
-    ``isinstance()`` behavior on Python 3.9-3.11). Call it at the symbol's
+    ``isinstance()`` behavior on Python 3.10-3.11). Call it at the symbol's
     definition site, right after the assignment.
 
     Raises:

{selectools-0.29.0 → selectools-1.0.0/src/selectools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.29.0
+Version: 1.0.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>
@@ -14,17 +14,16 @@ Project-URL: Builder, https://selectools.dev/builder/
 Project-URL: Examples, https://selectools.dev/examples/
 Project-URL: NichevLabs, https://nichevlabs.com
 Keywords: llm,ai,agent,agents,multi-agent,agent-framework,tool-calling,openai,anthropic,gemini,ollama,rag,hybrid-search,vector-search,embeddings,guardrails,evals,evaluators,visual-builder,structured-output,observability,fallback,langchain-alternative
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai<2.0.0,>=1.30.0
@@ -118,6 +117,16 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 # selectools serve agent.yaml
 ```
 
+## What's New in v1.0
+
+### v1.0.0 — Stable
+
+selectools is **1.0**. The public API is frozen and `@stable` symbols now carry a real compatibility promise — no removal or breaking signature change without a deprecation cycle spanning at least two minor releases. The package is `Development Status :: 5 - Production/Stable`.
+
+- **Frozen, marked surface** — every public symbol carries a `@stable`/`@beta` marker (CI-enforced). The stable set covers the agent loop and config, providers, tools and the mature toolbox, sessions, memory, guardrails, orchestration graphs, the pattern agents, the policy layer, and the core types. RAG/embeddings, MCP, A2A, the evaluator catalog, unified memory, the scheduler, and the newest backends stay `@beta` and keep evolving in 1.x.
+- **Python 3.10+** *(breaking)* — Python 3.9 reached end-of-life in October 2025 and is dropped; the minimum is now 3.10 (CI runs 3.10–3.13). Pin `selectools<1.0` to stay on 3.9.
+- Aside from the 3.9 drop, code that ran deprecation-warning-free on the latest 0.x release runs unmodified on 1.0. See `docs/MIGRATION_1.0.md`.
+
 ## What's New in v0.29
 
 ### v0.29.0 — Stability Promotions (v1.0 Freeze Prep)
@@ -349,19 +358,25 @@ selectools serve --builder
 
 ### v0.19.3 — Stability Markers Applied to All Public APIs
 
-Every public class and function exported from `selectools` now carries a stability marker:
+Every public class and function exported from `selectools` carries a stability
+marker. As of 1.0, `@stable` symbols carry a compatibility promise — no removal
+or breaking signature change without a deprecation cycle of at least two minors:
 
 ```python
-from selectools import Agent, AgentGraph, PlanAndExecuteAgent
+from selectools import Agent, AgentGraph, AgentScheduler
 
-print(Agent.__stability__)               # "stable"
-print(AgentGraph.__stability__)          # "beta"
-print(PlanAndExecuteAgent.__stability__) # "beta"
+print(Agent.__stability__)          # "stable"
+print(AgentGraph.__stability__)     # "stable"  (promoted for 1.0)
+print(AgentScheduler.__stability__) # "beta"    (still iterating)
 ```
 
-**`@stable`** — 60+ core symbols (Agent, AgentConfig, providers, memory, tools, evals, guardrails, sessions, knowledge, cache, cancellation)
+**`@stable`** — the frozen core: Agent, AgentConfig, providers, memory, tools and
+the mature toolbox, sessions, guardrails, orchestration graphs, the pattern
+agents, the policy layer, and the core types.
 
-**`@beta`** — 30+ newer symbols (AgentGraph, SupervisorAgent, Pipeline, @step, parallel, branch, all four patterns, compose)
+**`@beta`** — subsystems still evolving in 1.x: RAG/embeddings, MCP, A2A, the
+evaluator catalog, unified memory, the scheduler, and the newest backends. Run
+`python scripts/stability_audit.py` for the live marker map.
 
 ### v0.19.2 — Enterprise Hardening
 
@@ -555,7 +570,7 @@ def web_search(query: str) -> str:
     return expensive_api_call(query)
 ```
 
-Also: Python 3.9–3.13 CI matrix (verified zero compatibility issues).
+Also: Python 3.10–3.13 CI matrix (verified zero compatibility issues).
 
 </details>
 

{selectools-0.29.0 → selectools-1.0.0}/tests/test_orchestration_integration.py

@@ -80,9 +80,12 @@ class TestPublicExports:
         assert hasattr(selectools, "ErrorPolicy")
 
     def test_version_updated(self):
+        import re
+
         import selectools
 
-        assert selectools.__version__.startswith("0.")
+        # Version is a valid semver (MAJOR.MINOR.PATCH), not pinned to 0.x.
+        assert re.match(r"^\d+\.\d+\.\d+", selectools.__version__)
 
 
 class TestNewStepTypes: