luna-agent-bridge 0.1.1__tar.gz

luna_agent_bridge-0.1.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,15 @@
+# 行为准则
+
+## 我们的承诺
+
+为了营造开放、友善和安全的协作环境，参与者应尊重不同经验、背景和观点，并以建设性方式讨论技术取舍。
+
+## 不可接受的行为
+
+- 人身攻击、骚扰、歧视、威胁或公开他人私人信息。
+- 发布凭据、恶意载荷或未经授权的第三方数据。
+- 在代码审查、Issue 或社区讨论中持续扰乱协作。
+
+## 执行
+
+请通过仓库维护者提供的私有渠道报告问题。维护者可以删除不当内容、限制参与权限，或在必要时终止参与资格。所有处理都会尽量保密并保持一致性。

luna_agent_bridge-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# 贡献指南
+
+感谢参与 Luna Agent Bridge。项目包含两个有意分离的发布面：
+
+- `packages/native-luna-subagents`：只指导 Codex 原生子 Agent 的 Skill。
+- `plugins/luna-agent-bridge`：用户主动选择的 Windows 外部桥接插件。
+
+## 开发约束
+
+1. 不把外部 Broker、SQLite 持久化或 `luna-agent` CLI 描述为 Codex 原生能力。
+2. 原生 Skill 不得启动后台进程、修改 PATH、保存凭据或绕过沙箱。
+3. 外部桥接器的进程、Named Pipe、自动批准和数据目录变更必须补充测试和安全说明。
+4. 修改 Python 代码后运行：
+
+   ```powershell
+   .\.venv\Scripts\python.exe -m unittest discover -s tests -q
+   ```
+
+5. 使用 `pip install -e ".[dev]"` 安装 `PyYAML` 后，修改 Skill 或插件清单时运行对应的官方校验脚本。
+
+## 提交内容
+
+提交说明应包含变更范围、测试命令和已知风险。不要提交 `.venv`、`build`、`dist`、`outputs`、`__pycache__` 或运行日志。

luna_agent_bridge-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luna Agent Bridge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

luna_agent_bridge-0.1.1/MANIFEST.in

@@ -0,0 +1,17 @@
+include README.md
+include LICENSE
+include CONTRIBUTING.md
+include SECURITY.md
+include CODE_OF_CONDUCT.md
+recursive-include src *.py
+recursive-include tests *.py
+recursive-include assets *
+recursive-include packages *
+recursive-include plugins *
+recursive-include docs *.md
+global-exclude *.py[cod]
+global-exclude *.log
+prune .venv
+prune build
+prune dist
+prune outputs

luna_agent_bridge-0.1.1/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: luna-agent-bridge
+Version: 0.1.1
+Summary: Cost-conscious local bridge for routing Codex sub-agent tasks to gpt-5.6-luna with optional cross-session persistence
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: PyYAML>=6.0; extra == "dev"
+Dynamic: license-file
+
+# Luna Agent Bridge
+
+让 Codex 用户把适合的子 Agent 任务路由到 `gpt-5.6-luna`，在主 Agent 保持高能力的同时，为高频、边界清晰的任务提供更可控的成本与质量选择；需要时再启用本地队列和跨会话恢复。
+
+## 为什么做这个项目
+
+Codex 主 Agent 通常负责需求理解、方案判断和最终整合。代码审查、测试执行、资料整理、局部搜索等子任务边界更清晰，用户可能希望用更适合高频任务的模型配置，而不是让每个子任务都沿用主 Agent 的配置。
+
+这个项目把两个概念明确分开：`gpt-5.6-luna` 是模型，`max` 是推理强度；本项目的桥接运行时会将这组配置传给 Codex CLI。这样做的目标是让用户可以对不同任务做有意识的模型路由，并据自己的任务、账号和运行环境测量成本、延迟与质量。它不承诺固定比例的省钱效果，也不保证所有 Codex 运行环境都开放该模型。
+
+可以把任务流理解为：
+
+```text
+主 Agent（负责规划、判断和整合）
+├─ 复杂或高风险任务 ───────────────→ 主 Agent 使用的高能力模型
+└─ 高频、边界清晰的子任务 ─────────→ gpt-5.6-luna + max
+                                      └─ 可选：本地队列与跨会话恢复
+```
+
+## 选择哪条路径
+
+| 需求 | 推荐路径 |
+| --- | --- |
+| 普通拆解、代码审查、测试或资料整理 | Codex 原生子 Agent + 本项目提供的 Skill |
+| 希望显式指定 `gpt-5.6-luna` 和 `max` | 外部桥接器（在运行环境允许时） |
+| 需要跨 Codex 会话保存、恢复或接管任务 | 外部桥接器 |
+| 只需要当前会话内的并发协作 | 优先使用 Codex 原生子 Agent |
+
+原生子 Agent 由 Codex 运行环境负责调度，通常是最轻量的路径。外部桥接器是可选兼容层，不是 Codex 官方原生功能；它不能把原生子 Agent 的内部通道、侧边栏展示或生命周期承诺扩展到所有环境。
+
+## 推荐路径：原生 Skill
+
+这是普通任务拆解的默认入口。Skill 只提供拆解、并发、文件归属、消息交接和验证规则，不启动 Broker、不修改 PATH、不保存凭据，也不承诺跨会话持久化。
+
+将 Skill 复制到用户级 Skill 目录（Windows PowerShell）：
+
+```powershell
+$skillRoot = if ($env:CODEX_HOME) { Join-Path $env:CODEX_HOME 'skills' } else { Join-Path $env:USERPROFILE '.codex\skills' }
+Copy-Item -Recurse -Force '.\packages\native-luna-subagents' (Join-Path $skillRoot 'native-luna-subagents')
+```
+
+若运行环境支持用户级 Agent 配置，可以将模型和推理强度设为：
+
+```toml
+[agents]
+enabled = true
+max_concurrent_threads_per_session = 4
+default_subagent_model = "gpt-5.6-luna"
+default_subagent_reasoning_effort = "max"
+```
+
+模型是否可用、子 Agent 是否显示在侧边栏，以及会话关闭后的生命周期，仍由 Codex 运行环境决定；本项目不把它们包装成持久化保证。
+
+## 可选路径：外部桥接器
+
+只有在用户明确要求跨 Codex 会话保存、恢复或接管任务，或需要在本地运行时强制路由到 `gpt-5.6-luna` + `max` 时，才考虑安装外部桥接器。它要求 Windows 和 Python 3.12 或更高版本：
+
+发布版本可直接从 PyPI 安装：
+
+```powershell
+python -m pip install luna-agent-bridge
+luna-agent install
+```
+
+也可以从 [GitHub Releases](https://github.com/ZaviWayne/luna-agent-bridge/releases/latest) 下载 Windows 单文件 `luna-agent.exe`，无需配置 Python。下载后可用 `.\luna-agent.exe --help` 查看命令；首次使用外部桥接器前运行 `.\luna-agent.exe install`。
+
+如果需要从源码开发或测试，再使用下面的可编辑安装方式：
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install -e ".[dev]"
+luna-agent install
+```
+
+激活成功后，当前 PowerShell 提示符会带有 `(.venv)`，后续可以直接使用 `luna-agent`。如果不希望激活虚拟环境，改用虚拟环境中的完整路径：
+
+```powershell
+.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
+.\.venv\Scripts\luna-agent.exe install
+```
+
+如果 PowerShell 阻止执行 `Activate.ps1`，可以在当前窗口临时放宽策略后重试，或直接使用上面的完整路径方式：
+
+```powershell
+Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
+```
+
+常用命令：
+
+以下命令假设虚拟环境已经激活；未激活时，请将命令前缀替换为 `.\.venv\Scripts\luna-agent.exe`。
+
+```powershell
+luna-agent spawn --name reviewer --cwd <workspace-path> --task "检查当前修改"
+luna-agent status <agent-id>
+luna-agent send <agent-id> "补充检查边界条件"
+luna-agent wait <agent-id> --timeout 300
+luna-agent result <agent-id>
+luna-agent interrupt <agent-id>
+luna-agent archive <agent-id>
+```
+
+桥接器通过本地 Codex CLI 启动任务，并传递：
+
+```text
+--model gpt-5.6-luna
+--config model_reasoning_effort="max"
+```
+
+本地状态默认保存到 `%LOCALAPPDATA%\CodexLunaAgent`，包括任务元数据、事件和恢复所需的队列状态。运行中的消息会排队到当前轮次边界，不能像原生内部通道一样即时注入模型生成过程。
+
+用户准备关闭 Codex 时，必须先中断仍在运行的外部 Agent，再执行：
+
+```powershell
+luna-agent broker shutdown
+```
+
+不要假设关闭 Codex 会自动回收外部 Broker。普通卸载保留数据库；只有用户明确确认后才执行：
+
+```powershell
+luna-agent uninstall --purge-data --yes
+```
+
+## 能力边界
+
+桥接器提供：
+
+- 面向本地 Codex CLI 的显式模型与推理强度路由。
+- SQLite 状态存储、任务事件、消息队列和恢复入口。
+- 在工作区切换或重新打开 Codex 后，通过任务 ID 查询、发送、等待和接管。
+- 最多 4 个本地 Worker，并在 Broker 关闭时停止其管理的进程。
+
+桥接器不提供：
+
+- Codex 官方原生子 Agent、官方侧边栏展示或官方生命周期保证。
+- 绕过账号权限、模型可用性、沙箱或批准策略的能力。
+- 固定的成本节省比例、固定延迟或跨账号的模型可用性承诺。
+- 远程 TCP 控制；状态和控制面默认只在本机 Named Pipe 上工作。
+
+## 插件入口
+
+`plugins/luna-agent-bridge` 包含 `.codex-plugin/plugin.json` 和一个明确标注为“可选兼容层”的 Skill。它不会自动安装可执行文件、修改全局配置或添加个人 Marketplace 条目；请通过 Codex 的本地插件安装流程显式添加。
+
+## 安全边界
+
+- 不开放 TCP 远程控制。
+- 不读取或保存 Codex 凭据。
+- 不提供完全绕过沙箱的模式。
+- Named Pipe、自动批准、用户数据目录和进程生命周期都属于外部桥接器的安全审查范围。
+- 不要把外部桥接器或其跨会话恢复能力描述为 Codex 官方原生 Luna。
+
+## 开发与测试
+
+```powershell
+.\.venv\Scripts\python.exe -m unittest discover -s tests -q
+```
+
+`tests/fixtures` 中的 JSONL 文件是确定性的 Codex CLI 响应样本，用于在不访问网络、不消耗模型调用额度的情况下覆盖解析、事件和恢复逻辑；它们是测试输入，不会被打包到运行时。
+
+发布前请移除 `.venv`、`build`、`dist`、`outputs`、`__pycache__` 和运行日志。Skill 与插件清单应通过对应的官方校验脚本。
+
+项目采用 MIT License，详见 [LICENSE](LICENSE)。

luna_agent_bridge-0.1.1/README.md

@@ -0,0 +1,162 @@
+# Luna Agent Bridge
+
+让 Codex 用户把适合的子 Agent 任务路由到 `gpt-5.6-luna`，在主 Agent 保持高能力的同时，为高频、边界清晰的任务提供更可控的成本与质量选择；需要时再启用本地队列和跨会话恢复。
+
+## 为什么做这个项目
+
+Codex 主 Agent 通常负责需求理解、方案判断和最终整合。代码审查、测试执行、资料整理、局部搜索等子任务边界更清晰，用户可能希望用更适合高频任务的模型配置，而不是让每个子任务都沿用主 Agent 的配置。
+
+这个项目把两个概念明确分开：`gpt-5.6-luna` 是模型，`max` 是推理强度；本项目的桥接运行时会将这组配置传给 Codex CLI。这样做的目标是让用户可以对不同任务做有意识的模型路由，并据自己的任务、账号和运行环境测量成本、延迟与质量。它不承诺固定比例的省钱效果，也不保证所有 Codex 运行环境都开放该模型。
+
+可以把任务流理解为：
+
+```text
+主 Agent（负责规划、判断和整合）
+├─ 复杂或高风险任务 ───────────────→ 主 Agent 使用的高能力模型
+└─ 高频、边界清晰的子任务 ─────────→ gpt-5.6-luna + max
+                                      └─ 可选：本地队列与跨会话恢复
+```
+
+## 选择哪条路径
+
+| 需求 | 推荐路径 |
+| --- | --- |
+| 普通拆解、代码审查、测试或资料整理 | Codex 原生子 Agent + 本项目提供的 Skill |
+| 希望显式指定 `gpt-5.6-luna` 和 `max` | 外部桥接器（在运行环境允许时） |
+| 需要跨 Codex 会话保存、恢复或接管任务 | 外部桥接器 |
+| 只需要当前会话内的并发协作 | 优先使用 Codex 原生子 Agent |
+
+原生子 Agent 由 Codex 运行环境负责调度，通常是最轻量的路径。外部桥接器是可选兼容层，不是 Codex 官方原生功能；它不能把原生子 Agent 的内部通道、侧边栏展示或生命周期承诺扩展到所有环境。
+
+## 推荐路径：原生 Skill
+
+这是普通任务拆解的默认入口。Skill 只提供拆解、并发、文件归属、消息交接和验证规则，不启动 Broker、不修改 PATH、不保存凭据，也不承诺跨会话持久化。
+
+将 Skill 复制到用户级 Skill 目录（Windows PowerShell）：
+
+```powershell
+$skillRoot = if ($env:CODEX_HOME) { Join-Path $env:CODEX_HOME 'skills' } else { Join-Path $env:USERPROFILE '.codex\skills' }
+Copy-Item -Recurse -Force '.\packages\native-luna-subagents' (Join-Path $skillRoot 'native-luna-subagents')
+```
+
+若运行环境支持用户级 Agent 配置，可以将模型和推理强度设为：
+
+```toml
+[agents]
+enabled = true
+max_concurrent_threads_per_session = 4
+default_subagent_model = "gpt-5.6-luna"
+default_subagent_reasoning_effort = "max"
+```
+
+模型是否可用、子 Agent 是否显示在侧边栏，以及会话关闭后的生命周期，仍由 Codex 运行环境决定；本项目不把它们包装成持久化保证。
+
+## 可选路径：外部桥接器
+
+只有在用户明确要求跨 Codex 会话保存、恢复或接管任务，或需要在本地运行时强制路由到 `gpt-5.6-luna` + `max` 时，才考虑安装外部桥接器。它要求 Windows 和 Python 3.12 或更高版本：
+
+发布版本可直接从 PyPI 安装：
+
+```powershell
+python -m pip install luna-agent-bridge
+luna-agent install
+```
+
+也可以从 [GitHub Releases](https://github.com/ZaviWayne/luna-agent-bridge/releases/latest) 下载 Windows 单文件 `luna-agent.exe`，无需配置 Python。下载后可用 `.\luna-agent.exe --help` 查看命令；首次使用外部桥接器前运行 `.\luna-agent.exe install`。
+
+如果需要从源码开发或测试，再使用下面的可编辑安装方式：
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install -e ".[dev]"
+luna-agent install
+```
+
+激活成功后，当前 PowerShell 提示符会带有 `(.venv)`，后续可以直接使用 `luna-agent`。如果不希望激活虚拟环境，改用虚拟环境中的完整路径：
+
+```powershell
+.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
+.\.venv\Scripts\luna-agent.exe install
+```
+
+如果 PowerShell 阻止执行 `Activate.ps1`，可以在当前窗口临时放宽策略后重试，或直接使用上面的完整路径方式：
+
+```powershell
+Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
+```
+
+常用命令：
+
+以下命令假设虚拟环境已经激活；未激活时，请将命令前缀替换为 `.\.venv\Scripts\luna-agent.exe`。
+
+```powershell
+luna-agent spawn --name reviewer --cwd <workspace-path> --task "检查当前修改"
+luna-agent status <agent-id>
+luna-agent send <agent-id> "补充检查边界条件"
+luna-agent wait <agent-id> --timeout 300
+luna-agent result <agent-id>
+luna-agent interrupt <agent-id>
+luna-agent archive <agent-id>
+```
+
+桥接器通过本地 Codex CLI 启动任务，并传递：
+
+```text
+--model gpt-5.6-luna
+--config model_reasoning_effort="max"
+```
+
+本地状态默认保存到 `%LOCALAPPDATA%\CodexLunaAgent`，包括任务元数据、事件和恢复所需的队列状态。运行中的消息会排队到当前轮次边界，不能像原生内部通道一样即时注入模型生成过程。
+
+用户准备关闭 Codex 时，必须先中断仍在运行的外部 Agent，再执行：
+
+```powershell
+luna-agent broker shutdown
+```
+
+不要假设关闭 Codex 会自动回收外部 Broker。普通卸载保留数据库；只有用户明确确认后才执行：
+
+```powershell
+luna-agent uninstall --purge-data --yes
+```
+
+## 能力边界
+
+桥接器提供：
+
+- 面向本地 Codex CLI 的显式模型与推理强度路由。
+- SQLite 状态存储、任务事件、消息队列和恢复入口。
+- 在工作区切换或重新打开 Codex 后，通过任务 ID 查询、发送、等待和接管。
+- 最多 4 个本地 Worker，并在 Broker 关闭时停止其管理的进程。
+
+桥接器不提供：
+
+- Codex 官方原生子 Agent、官方侧边栏展示或官方生命周期保证。
+- 绕过账号权限、模型可用性、沙箱或批准策略的能力。
+- 固定的成本节省比例、固定延迟或跨账号的模型可用性承诺。
+- 远程 TCP 控制；状态和控制面默认只在本机 Named Pipe 上工作。
+
+## 插件入口
+
+`plugins/luna-agent-bridge` 包含 `.codex-plugin/plugin.json` 和一个明确标注为“可选兼容层”的 Skill。它不会自动安装可执行文件、修改全局配置或添加个人 Marketplace 条目；请通过 Codex 的本地插件安装流程显式添加。
+
+## 安全边界
+
+- 不开放 TCP 远程控制。
+- 不读取或保存 Codex 凭据。
+- 不提供完全绕过沙箱的模式。
+- Named Pipe、自动批准、用户数据目录和进程生命周期都属于外部桥接器的安全审查范围。
+- 不要把外部桥接器或其跨会话恢复能力描述为 Codex 官方原生 Luna。
+
+## 开发与测试
+
+```powershell
+.\.venv\Scripts\python.exe -m unittest discover -s tests -q
+```
+
+`tests/fixtures` 中的 JSONL 文件是确定性的 Codex CLI 响应样本，用于在不访问网络、不消耗模型调用额度的情况下覆盖解析、事件和恢复逻辑；它们是测试输入，不会被打包到运行时。
+
+发布前请移除 `.venv`、`build`、`dist`、`outputs`、`__pycache__` 和运行日志。Skill 与插件清单应通过对应的官方校验脚本。
+
+项目采用 MIT License，详见 [LICENSE](LICENSE)。

luna_agent_bridge-0.1.1/SECURITY.md

@@ -0,0 +1,19 @@
+# 安全策略
+
+## 范围
+
+原生 Skill 不执行外部进程，也不提供持久化服务。安全风险主要位于可选的 `luna-agent-bridge` 外部桥接器：它会启动本地 Codex CLI 子进程、使用 Windows Named Pipe，并将 Agent、消息、轮次和恢复状态写入用户数据目录。
+
+## 当前边界
+
+- 不开放 TCP 监听或远程控制端口。
+- 不读取或保存 Codex 凭据。
+- 桥接器默认使用 `workspace-write` 和 Codex CLI 的显式批准参数，不提供完全绕过沙箱的模式。
+- `--purge-data --yes` 是显式的数据删除操作，普通卸载不应删除任务数据库。
+- 用户关闭 Codex 前必须显式中断外部 Agent 并关闭 Broker；不能把外部桥接器当作原生生命周期管理。
+
+## 报告漏洞
+
+请不要在公开 Issue 中发布凭据、Named Pipe 细节、可执行载荷或可复现的本地提权步骤。先通过仓库维护者提供的私有渠道报告，并附上受影响版本、Windows/Python 版本、复现步骤和最小化日志。
+
+在尚未配置专用安全邮箱前，维护者应在发布页提供私有报告渠道；安全修复发布前不公开利用细节。

luna_agent_bridge-0.1.1/assets/AGENTS.block.md

@@ -0,0 +1,8 @@
+<!-- 已弃用：不要将本文件复制为全局 AGENTS.md；仅由显式执行 luna-agent install 的旧版外部桥接器使用。 -->
+<!-- BEGIN CODEX LUNA AGENT BRIDGE -->
+## Luna 子 Agent（旧版外部桥接）
+
+仅当用户明确要求外部持久化时，使用用户级 `luna-agent` CLI；普通任务请使用 packages/native-luna-subagents。外部桥接默认使用 `gpt-5.6-luna`、`max`、`workspace-write`，最多 4 个并发 Agent。
+
+跨工作区或跨主会话通信使用全局 Agent ID。CLI 通过显式 `--session` 或 Codex Desktop 的 `CODEX_THREAD_ID` 区分主会话；新主会话接管时必须保留 Agent ID。关闭 Codex 前先中断外部 Agent，再执行 `luna-agent broker shutdown`。
+<!-- END CODEX LUNA AGENT BRIDGE -->

luna_agent_bridge-0.1.1/assets/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: luna-agent-bridge-legacy
+description: 已弃用的外部桥接 Skill，仅供用户明确安装旧版 luna-agent CLI 时使用；普通任务请使用 packages/native-luna-subagents。
+---
+
+# Luna Agent Bridge（已弃用兼容入口）
+
+<!--
+本文件只服务于显式执行 `luna-agent install` 的旧版外部桥接器。
+普通任务不得复制或启用本文件；请使用 packages/native-luna-subagents。
+-->
+
+需要跨会话持久化的外部桥接任务时，使用用户级 `luna-agent` CLI，不要将其描述为 Codex 原生子 Agent。固定策略为 `gpt-5.6-luna`、`max`、`workspace-write`，最多四个并发 Agent。
+
+常用命令：
+
+```powershell
+luna-agent spawn --name reviewer --cwd <workspace-path> --task "检查当前修改"
+luna-agent send reviewer "重点检查事务边界"
+luna-agent status reviewer
+luna-agent list --all-sessions
+luna-agent adopt <global-agent-id>
+luna-agent wait reviewer --timeout 300
+luna-agent result reviewer
+luna-agent interrupt reviewer
+luna-agent resume reviewer
+luna-agent archive reviewer
+```
+
+会话隔离规则：CLI 优先使用显式 `--session`，其次使用 Codex Desktop 注入的 `CODEX_THREAD_ID`，没有会话上下文时使用 `standalone`。跨项目或跨主会话操作使用全局 Agent ID；新主会话接管时应在交接信息中保留该 Agent ID。
+
+用户关闭 Codex 前必须先中断外部 Agent，再执行 `luna-agent broker shutdown`。消息会排队到轮次边界，不能在模型生成过程中即时注入。