Node Command

nc-protocol

Node Command 的公开线协议、Model Context Protocol (MCP) 工具架构，以及 Agent 协议定义。

此仓库是 Node Command 公开契约的权威来源。它仅包含声明式架构和契约：不包含专有服务端代码、数据库架构或机密信息。

使用方——Node Command hub、nc-agent 运行时和客户端集成——会在固定的提交版本中引入此仓库，因此此处的契约变更都是明确且可审计的。

---

命名空间

agent/     Hub ↔ Agent wire protocol (hello / welcome / request / reply / heartbeat)
mcp/       Model-facing MCP surface (tool schemas + canonical tool manifest)
policy/    Public host-policy projection + capability names
browser/   Public browser and egress policy schemas
bindings/  Generated language bindings (JavaScript ESM)

---

使用契约

无需安装运行时依赖：使用方会在固定的提交 SHA 中引入此仓库，并从引入的目录树中导入内容。

git clone https://github.com/huseyincig/nc-protocol.git

直接导入 JavaScript 绑定：

import {
  MCP_TOOL_CONTRACT_VERSION,
  MCP_TOOL_MANIFEST_FINGERPRINT,
  MCP_TOOL_NAMES,
  HOST_POLICY_CAPABILITY_NAMES
} from './nc-protocol/bindings/javascript/contracts.mjs';

可以按路径导入 JSON 架构：

import helloSchema from './nc-protocol/agent/hello.schema.json' with { type: 'json' };
import toolsIndex from './nc-protocol/mcp/tools/index.json' with { type: 'json' };

当前的契约版本、指纹和功能列表分别固定在 mcp/contract-version、mcp/fingerprint 和 policy/capability-names 中；当前的生成和发布规则见 COMPATIBILITY.md。

---

测试与验证

nc-protocol 没有任何运行时依赖，并使用原生 Node.js 测试运行器：

# Clone the repository
git clone https://github.com/huseyincig/nc-protocol.git
cd nc-protocol

# Run test suite
npm test
# Or:
node --test tests/*.mjs

测试套件会验证：

1. 所有必需命名空间文件是否存在。
2. 工具定义、mcp/tools/index.json 和工具数量是否完全匹配。
3. 规范 sha256 清单指纹的加密一致性。
4. 架构解析有效性及架构草案的符合性。
5. 绑定与声明式契约文件是否一致。

---

贡献

有关如何提议新工具、更新架构、重新计算指纹以及提交拉取请求的详细指南，请参见 CONTRIBUTING.md。

---

版本控制与兼容性

• VERSIONING.md — SemVer 生命周期和破坏性变更政策。
• COMPATIBILITY.md — 当前契约代次和发布门槛。

---

相关仓库

• NodeCommand — 产品文档、客户端示例和清单。
• nc-agent — 实现这些契约的开源主机 Agent 和 CLI 安装程序。

---

许可证

Apache-2.0 — 参见 LICENSE。