From d2b2cad045db9c0713c1ba2377becc7280c1b6de Mon Sep 17 00:00:00 2001
From: Suzumiya <suzmii@qq.com>
Date: Tue, 6 Oct 2026 18:18:49 +0800
Subject: [PATCH] =?UTF-8?q?refactor(agc):=20=E8=A1=A5=E9=BD=90=20llm=5Freq?=
 =?UTF-8?q?uest=20=E6=94=B9=E5=90=8D=E7=9A=84=20plumbing=20=E4=B8=8E?=
 =?UTF-8?q?=E6=A8=A1=E5=9D=97=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

上一条提交（0a735ec0d）因 git add 命令里带了已不存在的旧路径而返回 128，只带上了文件重命名；本提交补齐同一改名所需的另外两处：

src/agent/generation.rs:6 mod loop_orchestration; → mod llm_request;，:52 pub(crate) use loop_orchestration::{ → llm_request::{。

src/agent/generation/llm_request.rs 顶部新增 //! 模块文档（LLM 文本请求与额度/进度错误面，注明循环编排已退役）。

两者与已提交的重命名构成完整改名；0a735ec0d 单独不可编译，本分支最终 tip 不受影响。

验证（在本 tip 上复测）：bin 口径 0 warning / EXIT=0；--all-targets EXIT=0（test 实例 339 条）；测试 runtime_prompt_bundle_build 17、prompt_source_boundaries 6、thread_manager 72、manifest_invalidation 1、agent_db 65、redaction 4 全 passed；cargo fmt --all --check、npm run check:encoding、git diff --check 全 rc=0；零新增 #[allow]。
---
 .../ai-game-creator-shell/src-tauri/src/agent/generation.rs | 4 ++--
 .../src-tauri/src/agent/generation/llm_request.rs           | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
index abf1ad1a2..cc98da28b 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
@@ -3,7 +3,7 @@ use super::*;
 mod canvas_generation;
 mod external_generation_state;
 mod game_html_validation;
-mod loop_orchestration;
+mod llm_request;
 mod prompt_context;
 mod trace;
 
@@ -49,7 +49,7 @@ pub(in crate::agent) use external_generation_state::{
 pub(crate) use game_html_validation::{
     contains_any, fnv1a64, strip_llm_thinking_blocks, validate_game_html_smoke,
 };
-pub(crate) use loop_orchestration::{
+pub(crate) use llm_request::{
     game_creator_agent_llm_error_is_mud_points_insufficient,
     game_creator_agent_llm_error_public_summary, request_game_creator_llm_text,
 };
diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs
index caed1a652..d47ccfef5 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/generation/llm_request.rs
@@ -1,3 +1,9 @@
+//! LLM 文本请求与其额度 / 进度错误面：`request_game_creator_llm_text`、
+//! `emit_agent_progress` / `AgentProgressEmitter`，以及泥点（mud points）不足的判定、
+//! 消息构造与公开摘要。
+//!
+//! 多 pass 循环编排已随 Agent Runtime 退役删除，本模块只剩请求与错误面。
+
 use super::*;
 
 pub(crate) async fn request_game_creator_llm_text(