keep-kp-runtime-python-native.md

规则： KP 借鉴或引入外部 agent 框架能力时，必须按照 KP 现有 Python 语言与后端模块结构原生实现；不得引入 TypeScript、Node.js、npm 运行依赖或跨语言 sidecar。

触发/症状： 方案准备直接安装 TypeScript/JavaScript 框架包、增加 Node runtime，或用跨进程桥接把外部 runtime 接入 KP 主链。

Why: 双语言 runtime 会扩大供应链、部署、调试、审计和维护面，并破坏 KP 现有 Python contract、测试、治理与运维结构的一致性。外部实现可以用于设计审阅和行为参考，但不应成为 KP 的运行依赖。

How to apply: 先识别外部框架中真正有价值的接口、状态机和测试模式，再用 Python Protocol、Pydantic/frozen dataclass、asyncio、现有 httpx 调用链及 KP artifact/ledger 原生实现；实验必须比较 Python baseline 与 Python contender。若某项能力只能依赖非 Python runtime 才能获得，则当前 KP 采用结论为 REJECT。

相关：[[test-native-attribution-control-before-framework-adoption]]