from __future__ import annotations from typing import Any def _role(item: Any) -> str: if not isinstance(item, dict): return "" return str(item.get("role") or "").strip().lower() def _is_tool_result(item: Any) -> bool: return _role(item) == "tool" def _tool_call_ids(tool_calls: Any) -> list[str] | None: """Return strict OpenAI-style tool-call IDs, or None for malformed calls.""" if not isinstance(tool_calls, list) or not tool_calls: return None identifiers: list[str] = [] for call in tool_calls: if not isinstance(call, dict): return None call_id = str(call.get("id") or "").strip() if not call_id or call_id in identifiers: return None identifiers.append(call_id) return identifiers def _tool_result_ids(items: list[Any]) -> list[str] | None: identifiers: list[str] = [] for item in items: if not isinstance(item, dict): return None call_id = str(item.get("tool_call_id") or "").strip() if not call_id: return None identifiers.append(call_id) return identifiers def sanitize_openai_tool_history(contexts: Any) -> tuple[Any, dict[str, int]]: """Remove only malformed OpenAI tool-call groups from a generic history list. The function does not inspect content or mutate retained entries. A no-op returns the original list object so ordinary history remains untouched. """ stats = { "changed": 0, "removed_groups": 0, "removed_assistants": 0, "removed_tool_results": 0, "removed_orphans": 0, } if not isinstance(contexts, list) or not contexts: return contexts, stats kept: list[Any] = [] index = 0 while index < len(contexts): item = contexts[index] role = _role(item) if role == "tool": stats["changed"] = 1 stats["removed_tool_results"] += 1 stats["removed_orphans"] += 1 index += 1 continue raw_calls = item.get("tool_calls") if isinstance(item, dict) and role == "assistant" else None has_effective_calls = raw_calls not in (None, []) if not has_effective_calls: kept.append(item) index += 1 continue next_index = index + 1 result_items: list[Any] = [] while next_index < len(contexts) and _is_tool_result(contexts[next_index]): result_items.append(contexts[next_index]) next_index += 1 call_ids = _tool_call_ids(raw_calls) result_ids = _tool_result_ids(result_items) valid = bool( call_ids and result_ids is not None and len(result_ids) == len(call_ids) and len(set(result_ids)) == len(result_ids) and set(result_ids) == set(call_ids) ) if valid: kept.append(item) kept.extend(result_items) else: stats["changed"] = 1 stats["removed_groups"] += 1 stats["removed_assistants"] += 1 stats["removed_tool_results"] += len(result_items) index = next_index if not stats["changed"]: return contexts, stats return kept, stats