extensions/python/message_loop_result/AGENTS.md

# Message Loop Result Extensions DOX

## Purpose

- Own normalization and policy handling after a model turn completes, before default assistant-history and tool-dispatch processing.

## Ownership

- Extensions receive mutable `result_data` with `llm_result` and may set `skip_default_processing` after fully handling the turn.
- `_20_empty_response.py` retries turns with neither response nor reasoning, counts them toward the unusable-response limit without adding a warning to model history, and uses `fw.msg_empty_response.md` for agent-prefixed UI warning text only.
- `_30_repeat_response.py` retries response content that exactly matches `loop_data.last_response`, regardless of reasoning, using `fw.msg_repeat.md` for history and `fw.msg_repeat_response.md` for the agent-prefixed UI warning text.

## Local Contracts

- Files run in deterministic filename order.
- A handler that sets `skip_default_processing` owns needed history and UI side effects for that turn.
- Handlers that should not add side effects after an earlier extension has handled the result must return when `skip_default_processing` is set.
- Do not use this point to mutate streamed partial content.

## Work Guidance

- Normalize a completed result before policy extensions compare or persist it.
- Keep loop-control policy independent from optional plugins.

## Verification

- Run message-loop and unusable-response regression tests.

## Child DOX Index

No child DOX files.