Split teaagent/runner.py into a package with separated types module

- Extract ToolRequest, FinalAnswer, Decision, DecisionFn,
  ApprovalRequest, ApprovalHandler, and RunResult into _types.py
- Rename runner.py → _core.py, importing types from the
  sibling module
- Add __init__.py re-exporting all public symbols for
  backward-compatible imports

Author: johnteee

CHANGELOG.md

@@ -11,6 +11,7 @@ All notable changes to TeaAgent are tracked here.
 - Split `teaagent/cli/_handlers.py` into a `teaagent/cli/_handlers/` package and extracted agent-run lifecycle logic into `_agent.py` while preserving command handler imports.
 - Continued splitting `teaagent/cli/_handlers/` by moving doctor, memory, model, MCP, misc, and audit handlers into dedicated modules and keeping stable re-exports in `__init__.py`.
 - Split `teaagent/llm_conformance.py` into a `teaagent/llm_conformance/` package with `_types.py` and `_runner.py`, preserving existing imports.
+- Split `teaagent/runner.py` into a `teaagent/runner/` package with `_types.py` and `_core.py`, preserving existing `teaagent.runner` imports.
 - Made `teaagent.cli.main()` accept injectable `_adapter_factory`, `_serve_mcp_http`, `_check_graphqlite`, `_check_llm`, and `_run_model_conformance` keyword arguments, enabling handler extraction without breaking existing tests.
 - Split `teaagent/workspace_tools.py` into a `teaagent/workspace_tools/` package with four focused modules: `_config.py`, `_helpers.py`, `_shell.py`, `_files.py`. Backward-compatible public imports preserved via `__init__.py` re-exports.
 - Expanded audit string redaction with patterns for JWT tokens, AWS access keys (`AKIA...`), and GitHub personal access tokens (`ghp_...`, `github_pat_...`).

teaagent/runner/__init__.py

@@ -0,0 +1,21 @@
+from ._core import AgentRunner
+from ._types import (
+    ApprovalHandler,
+    ApprovalRequest,
+    Decision,
+    DecisionFn,
+    FinalAnswer,
+    RunResult,
+    ToolRequest,
+)
+
+__all__ = [
+    'AgentRunner',
+    'ApprovalHandler',
+    'ApprovalRequest',
+    'Decision',
+    'DecisionFn',
+    'FinalAnswer',
+    'RunResult',
+    'ToolRequest',
+]

teaagent/runner.py teaagent/runner/_core.pyteaagent/runner.py renamed to teaagent/runner/_core.py

@@ -1,11 +1,9 @@
 from __future__ import annotations
 
-from collections.abc import Callable
-from dataclasses import dataclass, field
-from typing import Any, Optional, Union
+from typing import Any, Optional
 from uuid import uuid4
 
-from teaagent.audit import AuditLogger, redact_tool_arguments
+from teaagent.audit import AuditLogger
 from teaagent.budget import RunBudget
 from teaagent.context import ContextCompactor
 from teaagent.errors import (
@@ -17,53 +15,7 @@
 from teaagent.policy import ApprovalPolicy, PermissionMode
 from teaagent.tools import ToolRegistry
 
-
-@dataclass(frozen=True)
-class ToolRequest:
-    tool_name: str
-    arguments: dict[str, Any]
-    call_id: str = field(default_factory=lambda: uuid4().hex)
-
-
-@dataclass(frozen=True)
-class FinalAnswer:
-    content: str
-    metadata: dict[str, Any] = field(default_factory=dict)
-
-
-Decision = Union[ToolRequest, FinalAnswer]
-DecisionFn = Callable[[dict[str, Any]], Decision]
-
-
-@dataclass(frozen=True)
-class ApprovalRequest:
-    call_id: str
-    tool_name: str
-    arguments: dict[str, Any]
-    reason: str
-    annotations: dict[str, bool]
-
-    def to_dict(self) -> dict[str, Any]:
-        return {
-            'call_id': self.call_id,
-            'tool_name': self.tool_name,
-            'arguments': redact_tool_arguments(self.arguments),
-            'reason': self.reason,
-            'annotations': self.annotations,
-        }
-
-
-ApprovalHandler = Callable[[ApprovalRequest], bool]
-
-
-@dataclass(frozen=True)
-class RunResult:
-    run_id: str
-    final_answer: Optional[FinalAnswer]
-    iterations: int
-    tool_calls: int
-    status: str
-    metadata: dict[str, Any] = field(default_factory=dict)
+from ._types import ApprovalHandler, ApprovalRequest, DecisionFn, FinalAnswer, RunResult
 
 
 class AgentRunner:

teaagent/runner/_types.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from typing import Any, Optional, Union
+from uuid import uuid4
+
+from teaagent.audit import redact_tool_arguments
+
+
+@dataclass(frozen=True)
+class ToolRequest:
+    tool_name: str
+    arguments: dict[str, Any]
+    call_id: str = field(default_factory=lambda: uuid4().hex)
+
+
+@dataclass(frozen=True)
+class FinalAnswer:
+    content: str
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+
+Decision = Union[ToolRequest, FinalAnswer]
+DecisionFn = Callable[[dict[str, Any]], Decision]
+
+
+@dataclass(frozen=True)
+class ApprovalRequest:
+    call_id: str
+    tool_name: str
+    arguments: dict[str, Any]
+    reason: str
+    annotations: dict[str, bool]
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            'call_id': self.call_id,
+            'tool_name': self.tool_name,
+            'arguments': redact_tool_arguments(self.arguments),
+            'reason': self.reason,
+            'annotations': self.annotations,
+        }
+
+
+ApprovalHandler = Callable[[ApprovalRequest], bool]
+
+
+@dataclass(frozen=True)
+class RunResult:
+    run_id: str
+    final_answer: Optional[FinalAnswer]
+    iterations: int
+    tool_calls: int
+    status: str
+    metadata: dict[str, Any] = field(default_factory=dict)