Track: Complete track ai_client_docs_20260613

This commit is contained in:
ed
2026-06-13 18:27:50 -04:00
parent 1ccef1685f
commit 4b4721ded4
3 changed files with 19 additions and 19 deletions
@@ -38,15 +38,15 @@
# Phase 2: Primary Provider Senders
## Task 2.1: Document Primary Provider Senders
- [~] **Step 1: Document `_send_anthropic` (ai_client.py:1188-1364)**
- [x] **Step 1: Document `_send_anthropic` (ai_client.py:1188-1364)**
Add docstring detailing cache control breakpoints, history pruning, and token tracking. SSDL trace: `[I:_ensure_anthropic_client] -> [I:_trim_anthropic_history] -> [I:client.messages.create] -> [T:Result]`.
- [ ] **Step 2: Document `_send_gemini` (ai_client.py:1431-1665)**
- [x] **Step 2: Document `_send_gemini` (ai_client.py:1431-1665)**
Document caching states, explicit server-side cache invalidation, and chat session creation. SSDL trace: `[I:_ensure_gemini_client] -> [B:Cache Changed?] -> [I:client.caches.create] -> [I:client.chats.create] -> [T:Result]`.
- [ ] **Step 3: Document `_send_gemini_cli` (ai_client.py:1667-1776)**
- [x] **Step 3: Document `_send_gemini_cli` (ai_client.py:1667-1776)**
Document the headless adapter, subprocess execution, and callback wrapper. SSDL trace: `[I:run_with_tool_loop] -> [I:GeminiCliAdapter.send] -> [T:Result]`.
- [ ] **Step 4: Document `_send_deepseek` (ai_client.py:1812-2067)**
- [x] **Step 4: Document `_send_deepseek` (ai_client.py:1812-2067)**
Document token limits, custom REST client calls, and history repair loops. SSDL trace: `[I:_ensure_deepseek_client] -> [I:_repair_deepseek_history] -> [I:requests.post] -> [T:Result]`.
- [ ] **Step 5: Verify syntax and run tests**
- [x] **Step 5: Verify syntax and run tests**
Run: `pytest tests/test_deepseek_provider.py tests/test_gemini_cli_integration.py`
Expected: Success.
@@ -55,16 +55,16 @@
# Phase 3: Secondary Provider Senders & Helpers
## Task 3.1: Document Secondary Senders & Context Helpers
- [ ] **Step 1: Document `_send_minimax` (ai_client.py:2209-2251)**
- [x] **Step 1: Document `_send_minimax` (ai_client.py:2209-2251)**
SSDL trace: `[I:_ensure_minimax_client] -> [I:_repair_minimax_history] -> [I:run_with_tool_loop] -> [T:Result]`.
- [ ] **Step 2: Document `_send_grok` (ai_client.py:2157-2203)**
- [x] **Step 2: Document `_send_grok` (ai_client.py:2157-2203)**
SSDL trace: `[I:_ensure_grok_client] -> [I:run_with_tool_loop] -> [T:Result]`.
- [ ] **Step 3: Document `_send_qwen` (ai_client.py:2330-2363)**
- [x] **Step 3: Document `_send_qwen` (ai_client.py:2330-2363)**
SSDL trace: `[I:_ensure_qwen_client] -> [I:dashscope.Generation.call] -> [T:Result]`.
- [ ] **Step 4: Document `_send_llama` & `_send_llama_native` (ai_client.py:2381-2478)**
- [x] **Step 4: Document `_send_llama` & `_send_llama_native` (ai_client.py:2381-2478)**
SSDL trace: `[I:_ensure_llama_client] -> [I:run_with_tool_loop] -> [T:Result]`.
- [ ] **Step 5: Document `_reread_file_items` & `_build_file_diff_text` (ai_client.py:869-927)**
- [x] **Step 5: Document `_reread_file_items` & `_build_file_diff_text` (ai_client.py:869-927)**
SSDL trace: `o-> [I:get_mtime] -> [B:changed?] -> [I:read_file] -> [T:diff_text]`.
- [ ] **Step 6: Verify syntax and run all tests**
- [x] **Step 6: Verify syntax and run all tests**
Run: `pytest tests/` (full batch run check)
Expected: All green.