selectools 0.19.1__tar.gz → 0.19.2__tar.gz

{selectools-0.19.1/src/selectools.egg-info → selectools-0.19.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.19.1
+Version: 0.19.2
 Summary: Production-ready AI agents with tool calling, structured output, execution traces, and RAG. Provider-agnostic (OpenAI, Anthropic, Gemini, Ollama) with fallback chains, batch processing, tool policies, streaming, caching, and cost tracking.
 Author-email: John Nichev <johnnichev@gmail.com>
 Maintainer-email: NichevLabs <support@nichevlabs.com>
@@ -86,6 +86,32 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 
 ## What's New in v0.19
 
+### v0.19.2 — Enterprise Hardening
+
+```python
+from selectools.stability import stable, beta, deprecated
+from selectools import trace_to_html
+
+# Mark your own extensions with stability levels
+@stable
+class MyProductionAgent: ...
+
+@beta
+class MyExperimentalFeature: ...
+
+@deprecated(since="0.19", replacement="MyProductionAgent")
+class MyOldAgent: ...
+
+# Visualise any trace as a waterfall HTML timeline
+Path("trace.html").write_text(trace_to_html(result.trace))
+```
+
+- **Stability markers** — `@stable`, `@beta`, `@deprecated(since, replacement)` for public API signalling
+- **Trace HTML viewer** — `trace_to_html(trace)` renders a standalone waterfall timeline
+- **Deprecation policy** — 2-minor-version window, programmatic introspection via `.__stability__`
+- **Security audit** — all 41 `# nosec` annotations reviewed and published in `docs/SECURITY.md`
+- **Quality infrastructure** — property-based tests (Hypothesis), thread-safety smoke suite, 5 new production simulations (3135 tests total)
+
 ### v0.19.1 — Advanced Agent Patterns
 
 ```python
@@ -437,10 +463,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
-- **73 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions, entity memory, knowledge graph, eval framework, advanced agent patterns, and more
+- **75 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions, entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, 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
-- **2918 Tests**: Unit, integration, regression, and E2E with real API calls
+- **3135 Tests**: Unit, integration, regression, and E2E with real API calls
 
 ## Install
 
@@ -1054,7 +1080,7 @@ pytest tests/ -x -q          # All tests
 pytest tests/ -k "not e2e"   # Skip E2E (no API keys needed)
 ```
 
-2918 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, and E2E integration with real API calls.
+3135 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, and E2E integration with real API calls.
 
 ## License
 

{selectools-0.19.1 → selectools-0.19.2}/README.md

@@ -26,6 +26,32 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 
 ## What's New in v0.19
 
+### v0.19.2 — Enterprise Hardening
+
+```python
+from selectools.stability import stable, beta, deprecated
+from selectools import trace_to_html
+
+# Mark your own extensions with stability levels
+@stable
+class MyProductionAgent: ...
+
+@beta
+class MyExperimentalFeature: ...
+
+@deprecated(since="0.19", replacement="MyProductionAgent")
+class MyOldAgent: ...
+
+# Visualise any trace as a waterfall HTML timeline
+Path("trace.html").write_text(trace_to_html(result.trace))
+```
+
+- **Stability markers** — `@stable`, `@beta`, `@deprecated(since, replacement)` for public API signalling
+- **Trace HTML viewer** — `trace_to_html(trace)` renders a standalone waterfall timeline
+- **Deprecation policy** — 2-minor-version window, programmatic introspection via `.__stability__`
+- **Security audit** — all 41 `# nosec` annotations reviewed and published in `docs/SECURITY.md`
+- **Quality infrastructure** — property-based tests (Hypothesis), thread-safety smoke suite, 5 new production simulations (3135 tests total)
+
 ### v0.19.1 — Advanced Agent Patterns
 
 ```python
@@ -377,10 +403,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
-- **73 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions, entity memory, knowledge graph, eval framework, advanced agent patterns, and more
+- **75 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions, entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, 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
-- **2918 Tests**: Unit, integration, regression, and E2E with real API calls
+- **3135 Tests**: Unit, integration, regression, and E2E with real API calls
 
 ## Install
 
@@ -994,7 +1020,7 @@ pytest tests/ -x -q          # All tests
 pytest tests/ -k "not e2e"   # Skip E2E (no API keys needed)
 ```
 
-2918 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, and E2E integration with real API calls.
+3135 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, and E2E integration with real API calls.
 
 ## License
 

{selectools-0.19.1 → selectools-0.19.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "selectools"
-version = "0.19.1"
+version = "0.19.2"
 description = "Production-ready AI agents with tool calling, structured output, execution traces, and RAG. Provider-agnostic (OpenAI, Anthropic, Gemini, Ollama) with fallback chains, batch processing, tool policies, streaming, caching, and cost tracking."
 readme = "README.md"
 requires-python = ">=3.9"

{selectools-0.19.1 → selectools-0.19.2}/src/selectools/__init__.py

@@ -1,6 +1,6 @@
 """Public exports for the selectools package."""
 
-__version__ = "0.19.1"
+__version__ = "0.19.2"
 
 # Import submodules (lazy loading for optional dependencies)
 from . import embeddings, evals, guardrails, models, patterns, rag, toolbox
@@ -129,10 +129,11 @@ from .sessions import (
     SessionStore,
     SQLiteSessionStore,
 )
+from .stability import beta, deprecated, stable
 from .structured import ResponseFormat
 from .token_estimation import TokenEstimate, estimate_run_tokens, estimate_tokens
 from .tools import Tool, ToolParameter, ToolRegistry, tool
-from .trace import AgentTrace, StepType, TraceStep
+from .trace import AgentTrace, StepType, TraceStep, trace_to_html
 from .types import AgentResult, Message, Role, ToolCall
 from .usage import AgentUsage, UsageStats
 
@@ -201,6 +202,10 @@ __all__ = [
     "PolicyResult",
     # Structured output
     "ResponseFormat",
+    # Stability markers
+    "stable",
+    "beta",
+    "deprecated",
     # Observability
     "AgentObserver",
     "AsyncAgentObserver",
@@ -209,6 +214,7 @@ __all__ = [
     "AgentTrace",
     "StepType",
     "TraceStep",
+    "trace_to_html",
     # Guardrails
     "guardrails",
     "Guardrail",

selectools-0.19.2/src/selectools/stability.py

@@ -0,0 +1,111 @@
+"""
+Stability markers for the selectools public API.
+
+Use these decorators to signal the stability of any public function or class:
+
+- ``@stable``  — API is frozen; breaking changes require a major version bump.
+- ``@beta``    — API may change in a minor release; no deprecation cycle guaranteed.
+- ``@deprecated(since, replacement)`` — Emits ``DeprecationWarning`` on use and will
+  be removed after the minimum deprecation window (2 minor releases).
+
+Examples::
+
+    from selectools.stability import stable, beta, deprecated
+
+    @stable
+    def my_function(): ...
+
+    @beta
+    class MyExperimentalClass: ...
+
+    @deprecated(since="0.19", replacement="NewThing")
+    def old_function(): ...
+"""
+
+from __future__ import annotations
+
+import functools
+import inspect
+import warnings
+from typing import Any, Callable, Optional, TypeVar, Union, overload
+
+_F = TypeVar("_F", bound=Callable[..., Any])
+_C = TypeVar("_C", bound=type)
+
+
+def stable(obj: Union[_F, _C]) -> Union[_F, _C]:
+    """Set stability marker to 'stable' (API is frozen)."""
+    obj.__stability__ = "stable"  # type: ignore[union-attr]
+    return obj
+
+
+def beta(obj: Union[_F, _C]) -> Union[_F, _C]:
+    """Set stability marker to 'beta' (API may change in minor releases)."""
+    obj.__stability__ = "beta"  # type: ignore[union-attr]
+    return obj
+
+
+def deprecated(
+    since: str,
+    replacement: Optional[str] = None,
+) -> Callable[[Union[_F, _C]], Union[_F, _C]]:
+    """Mark a function or class as deprecated.
+
+    Emits a ``DeprecationWarning`` on every call or instantiation.
+
+    Args:
+        since: The version in which the deprecation was introduced (e.g. ``"0.19"``).
+        replacement: Optional name of the replacement API to suggest in the warning.
+
+    Example::
+
+        @deprecated(since="0.19", replacement="NewProvider")
+        class OldProvider:
+            ...
+    """
+
+    def _make_message(name: str) -> str:
+        msg = f"{name} is deprecated since v{since}."
+        if replacement:
+            msg += f" Use {replacement} instead."
+        return msg
+
+    @overload
+    def decorator(obj: _C) -> _C: ...
+
+    @overload
+    def decorator(obj: _F) -> _F: ...
+
+    def decorator(obj: Union[_F, _C]) -> Union[_F, _C]:
+        if inspect.isclass(obj):
+            # Wrap __init__ so the warning fires on instantiation.
+            original_init = obj.__init__  # type: ignore[misc]
+            message = _make_message(obj.__qualname__)
+
+            @functools.wraps(original_init)
+            def _new_init(self: Any, *args: Any, **kwargs: Any) -> None:
+                warnings.warn(message, DeprecationWarning, stacklevel=2)
+                original_init(self, *args, **kwargs)
+
+            obj.__init__ = _new_init  # type: ignore[method-assign]
+            obj.__stability__ = "deprecated"  # type: ignore[union-attr]
+            obj.__deprecated_since__ = since  # type: ignore[union-attr]
+            obj.__deprecated_replacement__ = replacement  # type: ignore[union-attr]
+            return obj  # type: ignore[return-value]
+        else:
+            message = _make_message(obj.__qualname__)
+
+            @functools.wraps(obj)
+            def _wrapper(*args: Any, **kwargs: Any) -> Any:
+                warnings.warn(message, DeprecationWarning, stacklevel=2)
+                return obj(*args, **kwargs)
+
+            _wrapper.__stability__ = "deprecated"  # type: ignore[attr-defined]
+            _wrapper.__deprecated_since__ = since  # type: ignore[attr-defined]
+            _wrapper.__deprecated_replacement__ = replacement  # type: ignore[attr-defined]
+            return _wrapper  # type: ignore[return-value]
+
+    return decorator  # type: ignore[return-value]
+
+
+__all__ = ["stable", "beta", "deprecated"]

{selectools-0.19.1 → selectools-0.19.2}/src/selectools/trace.py

@@ -300,4 +300,179 @@ def _span_id() -> str:
     return uuid.uuid4().hex[:16]
 
 
-__all__ = ["TraceStep", "AgentTrace", "StepType"]
+# ---------------------------------------------------------------------------
+# HTML trace viewer
+# ---------------------------------------------------------------------------
+
+_STEP_COLORS: Dict[str, str] = {
+    "llm_call": "#3b82f6",
+    "tool_execution": "#8b5cf6",
+    "tool_selection": "#a78bfa",
+    "cache_hit": "#4ade80",
+    "error": "#f87171",
+    "guardrail": "#fbbf24",
+    "output_screening": "#fbbf24",
+    "coherence_check": "#fbbf24",
+    "graph_node_start": "#06b6d4",
+    "graph_node_end": "#06b6d4",
+    "graph_routing": "#06b6d4",
+    "graph_checkpoint": "#06b6d4",
+    "graph_interrupt": "#06b6d4",
+    "graph_resume": "#06b6d4",
+    "graph_parallel_start": "#06b6d4",
+    "graph_parallel_end": "#06b6d4",
+    "graph_stall": "#f97316",
+    "graph_loop_detected": "#f97316",
+}
+_DEFAULT_COLOR = "#64748b"
+
+
+def trace_to_html(trace: "AgentTrace") -> str:
+    """Render an AgentTrace as a standalone HTML waterfall timeline.
+
+    Returns a self-contained HTML string (no external dependencies).
+    The caller is responsible for writing it to disk if desired::
+
+        from selectools import trace_to_html
+        Path("trace.html").write_text(trace_to_html(result.trace))
+
+    Args:
+        trace: The ``AgentTrace`` to visualise.
+
+    Returns:
+        A complete HTML document as a string.
+    """
+    import html as _html
+
+    max_dur = max((s.duration_ms for s in trace.steps), default=1.0)
+    max_dur = max(max_dur, 1.0)  # guard against all-zero durations
+
+    total_ms = trace.total_duration_ms
+    llm_ms = trace.llm_duration_ms
+    tool_ms = trace.tool_duration_ms
+    llm_pct = f"{llm_ms / max(total_ms, 1) * 100:.0f}%"
+    tool_pct = f"{tool_ms / max(total_ms, 1) * 100:.0f}%"
+
+    def _esc(v: Any) -> str:
+        return _html.escape(str(v)) if v is not None else ""
+
+    def _detail(step: "TraceStep") -> str:
+        parts = []
+        if step.model:
+            parts.append(f"<b>model:</b> {_esc(step.model)}")
+        if step.prompt_tokens is not None:
+            parts.append(f"<b>prompt tokens:</b> {step.prompt_tokens}")
+        if step.completion_tokens is not None:
+            parts.append(f"<b>completion tokens:</b> {step.completion_tokens}")
+        if step.cost_usd is not None:
+            parts.append(f"<b>cost:</b> ${step.cost_usd:.6f}")
+        if step.tool_name:
+            parts.append(f"<b>tool:</b> {_esc(step.tool_name)}")
+        if step.tool_args:
+            parts.append(f"<b>args:</b> <code>{_esc(json.dumps(step.tool_args))}</code>")
+        if step.tool_result:
+            truncated = str(step.tool_result)[:300]
+            parts.append(f"<b>result:</b> <code>{_esc(truncated)}</code>")
+        if step.error:
+            parts.append(f"<b>error:</b> <span style='color:#f87171'>{_esc(step.error)}</span>")
+        if step.node_name:
+            parts.append(f"<b>node:</b> {_esc(step.node_name)}")
+        if step.from_node or step.to_node:
+            parts.append(f"<b>route:</b> {_esc(step.from_node)} → {_esc(step.to_node)}")
+        if step.summary:
+            parts.append(f"<b>summary:</b> {_esc(step.summary)}")
+        if step.reasoning:
+            parts.append(f"<b>reasoning:</b> {_esc(step.reasoning[:200])}")
+        return "<br>".join(parts) if parts else "<i>no details</i>"
+
+    rows = []
+    for i, step in enumerate(trace.steps):
+        type_val = step.type.value if hasattr(step.type, "value") else str(step.type)
+        color = _STEP_COLORS.get(type_val, _DEFAULT_COLOR)
+        bar_pct = step.duration_ms / max_dur * 100
+        label = step.summary or type_val
+        detail_html = _detail(step)
+        rows.append(
+            f"""
+      <tr onclick="toggleDetail('d{i}')" style="cursor:pointer">
+        <td style="color:#94a3b8;width:32px;text-align:right;padding-right:12px">{i + 1}</td>
+        <td style="width:160px">
+          <span style="background:{color};color:#0f172a;font-size:11px;font-weight:600;
+                       padding:2px 7px;border-radius:4px">{_esc(type_val)}</span>
+        </td>
+        <td style="width:200px;padding:0 12px">
+          <div style="background:#1e3a5f;border-radius:3px;height:10px;width:100%">
+            <div style="background:{color};border-radius:3px;height:10px;width:{bar_pct:.1f}%"></div>
+          </div>
+        </td>
+        <td style="color:#94a3b8;width:70px;text-align:right;padding-right:12px">
+          {step.duration_ms:.1f}ms
+        </td>
+        <td style="color:#e2e8f0">{_esc(label)}</td>
+      </tr>
+      <tr id="d{i}" style="display:none">
+        <td colspan="5" style="padding:8px 16px 12px 44px;color:#94a3b8;
+                               font-size:12px;background:#0f2035;border-bottom:1px solid #1e3a5f">
+          {detail_html}
+        </td>
+      </tr>"""
+        )
+
+    rows_html = "\n".join(rows)
+    run_id_display = _esc(trace.run_id[:16]) + "…" if len(trace.run_id) > 16 else _esc(trace.run_id)
+    step_count = len(trace.steps)
+
+    return f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Agent Trace — {run_id_display}</title>
+<style>
+  * {{ box-sizing: border-box; margin: 0; padding: 0; }}
+  body {{ background: #0f172a; color: #e2e8f0; font-family: 'JetBrains Mono', 'Fira Code', monospace;
+          font-size: 13px; padding: 24px; }}
+  h1 {{ font-size: 16px; font-weight: 600; color: #f8fafc; margin-bottom: 4px; }}
+  .meta {{ color: #64748b; font-size: 12px; margin-bottom: 24px; }}
+  .stat {{ display: inline-block; margin-right: 24px; }}
+  .stat b {{ color: #e2e8f0; }}
+  table {{ width: 100%; border-collapse: collapse; }}
+  tr:hover td {{ background: #1a2744; }}
+  td {{ padding: 7px 4px; border-bottom: 1px solid #1e293b; vertical-align: middle; }}
+  code {{ background: #1e293b; padding: 1px 4px; border-radius: 3px; font-size: 11px; }}
+</style>
+</head>
+<body>
+<h1>Agent Trace</h1>
+<div class="meta">
+  <span class="stat"><b>run:</b> {run_id_display}</span>
+  <span class="stat"><b>steps:</b> {step_count}</span>
+  <span class="stat"><b>total:</b> {total_ms:.1f}ms</span>
+  <span class="stat"><b>llm:</b> {llm_ms:.1f}ms ({llm_pct})</span>
+  <span class="stat"><b>tools:</b> {tool_ms:.1f}ms ({tool_pct})</span>
+</div>
+<table>
+  <thead>
+    <tr>
+      <th style="color:#475569;text-align:right;padding-right:12px">#</th>
+      <th style="color:#475569;text-align:left">type</th>
+      <th style="color:#475569;padding:0 12px">duration</th>
+      <th style="color:#475569;text-align:right;padding-right:12px">ms</th>
+      <th style="color:#475569;text-align:left">label</th>
+    </tr>
+  </thead>
+  <tbody>
+{rows_html}
+  </tbody>
+</table>
+<script>
+function toggleDetail(id) {{
+  var el = document.getElementById(id);
+  el.style.display = el.style.display === 'none' ? 'table-row' : 'none';
+}}
+</script>
+</body>
+</html>"""
+
+
+__all__ = ["TraceStep", "AgentTrace", "StepType", "trace_to_html"]

{selectools-0.19.1 → selectools-0.19.2/src/selectools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: selectools
-Version: 0.19.1
+Version: 0.19.2
 Summary: Production-ready AI agents with tool calling, structured output, execution traces, and RAG. Provider-agnostic (OpenAI, Anthropic, Gemini, Ollama) with fallback chains, batch processing, tool policies, streaming, caching, and cost tracking.
 Author-email: John Nichev <johnnichev@gmail.com>
 Maintainer-email: NichevLabs <support@nichevlabs.com>
@@ -86,6 +86,32 @@ result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")
 
 ## What's New in v0.19
 
+### v0.19.2 — Enterprise Hardening
+
+```python
+from selectools.stability import stable, beta, deprecated
+from selectools import trace_to_html
+
+# Mark your own extensions with stability levels
+@stable
+class MyProductionAgent: ...
+
+@beta
+class MyExperimentalFeature: ...
+
+@deprecated(since="0.19", replacement="MyProductionAgent")
+class MyOldAgent: ...
+
+# Visualise any trace as a waterfall HTML timeline
+Path("trace.html").write_text(trace_to_html(result.trace))
+```
+
+- **Stability markers** — `@stable`, `@beta`, `@deprecated(since, replacement)` for public API signalling
+- **Trace HTML viewer** — `trace_to_html(trace)` renders a standalone waterfall timeline
+- **Deprecation policy** — 2-minor-version window, programmatic introspection via `.__stability__`
+- **Security audit** — all 41 `# nosec` annotations reviewed and published in `docs/SECURITY.md`
+- **Quality infrastructure** — property-based tests (Hypothesis), thread-safety smoke suite, 5 new production simulations (3135 tests total)
+
 ### v0.19.1 — Advanced Agent Patterns
 
 ```python
@@ -437,10 +463,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
-- **73 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions, entity memory, knowledge graph, eval framework, advanced agent patterns, and more
+- **75 Examples**: Multi-agent graphs, RAG, hybrid search, streaming, structured output, traces, batch, policy, observer, guardrails, audit, sessions, entity memory, knowledge graph, eval framework, advanced agent patterns, stability markers, HTML trace viewer, 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
-- **2918 Tests**: Unit, integration, regression, and E2E with real API calls
+- **3135 Tests**: Unit, integration, regression, and E2E with real API calls
 
 ## Install
 
@@ -1054,7 +1080,7 @@ pytest tests/ -x -q          # All tests
 pytest tests/ -k "not e2e"   # Skip E2E (no API keys needed)
 ```
 
-2918 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, and E2E integration with real API calls.
+3135 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, and E2E integration with real API calls.
 
 ## License
 

{selectools-0.19.1 → selectools-0.19.2}/src/selectools.egg-info/SOURCES.txt

@@ -28,6 +28,7 @@ src/selectools/pricing.py
 src/selectools/prompt.py
 src/selectools/security.py
 src/selectools/sessions.py
+src/selectools/stability.py
 src/selectools/structured.py
 src/selectools/token_estimation.py
 src/selectools/trace.py
@@ -210,6 +211,7 @@ tests/test_sessions_edge_cases.py
 tests/test_sessions_redis.py
 tests/test_simple_observer.py
 tests/test_simulation_evals.py
+tests/test_stability.py
 tests/test_structured.py
 tests/test_structured_config.py
 tests/test_structured_tool_results.py
@@ -218,6 +220,7 @@ tests/test_terminal_actions.py
 tests/test_token_estimation.py
 tests/test_tool_caching.py
 tests/test_trace.py
+tests/test_trace_html.py
 tests/test_v016_regression.py
 tests/test_v019_features.py
 tests/test_yaml_config.py