docs(guides): fix vendor_capabilities.py, mma_exec.py, audit_optional_returns drift

- Readme.md AI Client row: '5 providers' -> 8; added VendorCapabilities
  inlining note + Result[str] send() API note.
- guide_ai_client.md: src/vendor_capabilities.py refs -> src/ai_client.py
  #region: Vendor Capabilities (2 sites: the capabilities param
  comment + the V2 Capability Matrix section).
- docs/AGENTS.md: audit_optional_returns.py -> audit_optional_in_3_files.py
  (the live script; the successor is not yet built).
- guide_mma.md SubConversationRunner sketch: 'Reuses mma_exec.py' ->
  'Would reuse the WorkerPool internal subprocess template (NOT the
  deprecated mma_exec.py)'.
- guide_multi_agent_conductor.md: architecture diagram box
  'Workers call mma_exec.py' -> 'Workers run via the internal
  subprocess template (run_worker_lifecycle; NOT the deprecated
  meta-tooling mma_exec.py)'; the mma_exec.py box relabeled to
  run_worker_lifecycle; See Also 'scripts/mma_exec.py — sub-agent
  entry point' -> 'src/multi_agent_conductor.py:run_worker_lifecycle
  (NOT the deprecated meta-tooling mma_exec.py)'.
This commit is contained in:
ed
2026-07-02 19:39:43 -04:00
parent 3423cc35a0
commit 444ee13f7f
5 changed files with 14 additions and 10 deletions
+2 -2
View File
@@ -559,7 +559,7 @@ class OpenAICompatibleRequest:
def send_openai_compatible(
client: Any, # openai.OpenAI client with vendor-specific base_url + auth
request: OpenAICompatibleRequest,
*, capabilities: "VendorCapabilities", # from src/vendor_capabilities.py
*, capabilities: "VendorCapabilities", # from src/ai_client.py #region: Vendor Capabilities
) -> NormalizedResponse:
```
@@ -664,7 +664,7 @@ For OpenRouter, custom URLs, and other cloud Llama endpoints, the existing OpenA
### V2 Capability Matrix (Phase 4)
Added 2026-06-11. The `VendorCapabilities` dataclass in `src/vendor_capabilities.py` now has 12 v2 fields beyond the original 7 v1 fields:
Added 2026-06-11. The `VendorCapabilities` dataclass (now inlined in `src/ai_client.py` `#region: Vendor Capabilities`; moved from the deleted `src/vendor_capabilities.py` per `module_taxonomy_refactor_20260627` Phase 2.1) has 12 v2 fields beyond the original 7 v1 fields:
**V1 fields** (unchanged):
- `vision`, `tool_calling`, `caching`, `streaming`, `model_discovery`, `context_window`, `cost_tracking`