智能体实例状态合同整理

适用场景

把每次 Agent 运行的实例范围、会话、可变状态和 reset hook 整理为可核验合同。

输入与输出

输入：脱敏 executors 数组，含 executorid、runid、sessionid、instancescope、mutablestatekeys、resethook、resetobserved 和 statesnapshotref。 输出：agent-executor-state-contract.json，含规范化实例合同、发现项和 contract_hash。

安装与执行

1. 1. 使用 Python 3.10 或更高版本，无第三方依赖。
2. 运行 scripts/normalize_executor_state_contract.py，按 docs/usage.md 传参。
3. 检查 status、findings、哈希和 externalactionexecuted。

执行规则

共享实例必须声明 reset hook；缺少实例范围、会话或状态快照引用时进入 REVIEW。

错误恢复

JSON 无法解析、字段缺失、实例范围异常或状态污染时保留发现项并进入 REVIEW；不默默清除旧状态。

权限与隐私边界

只读脱敏 JSON，不连接运行时、数据库、队列或网络，不保存密码、Cookie、Token 或真实客户记录。

验收方式

使用 examples 中的脱敏样例运行，确认输出字段、阻断原因和 externalactionexecuted=false。