qlogicagent-runtime-contracts

小智 Claw 体系的共享 runtime contract 层，承载跨消费者复用的 runtime state contract 和少量 canonical runtime core。

它不是工具编排层，也不是消费者私有平台接线层；职责是把多个消费者共享的 runtime state contract 和少量 canonical runtime core 稳定下来。

当前职责

1. Agent RPC: JSON-RPC 2.0 wire types、error codes、handshake protocol (agent-rpc.ts)
2. Session contract: session identity、runtime session、pending prompt (session.ts)
3. Capability manifest helpers: snapshot clone / diff / merge、namespace / workspace id 派生 (capability-manifest.ts)
4. Memory lifecycle contract: memory block、observation envelope、write-access 和 canonical hook/source 枚举 (memory-provider-lifecycle.ts)
5. Runtime resource manifest: assets、profiles、legacy compatibility entry 和纯 helper (resource-manifest.ts)
6. Provider runtime boundary contract: auth/model/profile capability 边界接口与极小型 compat helper (provider-runtime-contract.ts)
7. Provider runtime core: provider capability、auth resolution、pi auth/model discovery 的 shared canonical 逻辑 (provider-runtime-core.ts)
8. Checkpoint runtime core: mutation checkpoint snapshot / restore 的 shared canonical 逻辑 (checkpoint-runtime.ts)
9. Transport / execution / channel: 传输枚举、计费、执行生命周期载荷、频道绑定 (transport.ts, execution.ts, channel.ts, channel-ingress.ts)
10. Gateway / hook protocol / web capability: gateway 认证消息、Hub-Client hook 协议、浏览器能力描述 (gateway.ts, hook-protocol.ts, web-capability.ts)
11. 极小型纯辅助函数与状态常量

明确不负责

1. 会话存储实现
2. Tool orchestration policy
3. 消费者私有数据库、缓存、配置适配、鉴权/平台密钥接线
4. 鉴权、订阅、计费的消费者私有多租逻辑

文档入口

1. docs/package-contract.md — 包契约与 breaking-change 规则
2. docs/api-surface-map.md — 导出面清单
3. CONTRIBUTING.md — 贡献指南
4. docs/releasing.md — 发布流程

导入规则

稳定入口（仅允许从以下路径导入）：

import { ... } from "qlogicagent-runtime-contracts";
import { ... } from "qlogicagent-runtime-contracts/resource-manifest";
import { ... } from "qlogicagent-runtime-contracts/provider-runtime-contract";
import { ... } from "qlogicagent-runtime-contracts/provider-runtime-core";
import { ... } from "qlogicagent-runtime-contracts/checkpoint-runtime";
import { ... } from "qlogicagent-runtime-contracts/agent-rpc";

禁止深层导入 dist/* 或 src/*。

构建

npm run check    # tsc --noEmit 类型检查
npm run build    # dual ESM/CJS 构建
npm run release  # 发版 (tag + publish)