@twinsearth/agent-universe 3.4.5 → 3.6.0

package/README.md

@@ -6,10 +6,18 @@
 
 [![CI](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml/badge.svg)](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/TwinsEarth/agent-universe)](https://github.com/TwinsEarth/agent-universe/releases)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/@twinsearth/agent-universe?color=red)](https://www.npmjs.com/package/@twinsearth/agent-universe)
+
+[![Platforms](https://img.shields.io/badge/platforms-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml)
 [![Rust](https://img.shields.io/badge/rust-2021%20edition-orange.svg)](https://www.rust-lang.org/)
+[![MSRV](https://img.shields.io/badge/MSRV-1.88%2B-orange)](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
-[![npm](https://img.shields.io/badge/npm-%40twinsearth%2Fagent--universe-red.svg)](https://github.com/TwinsEarth/agent-universe/packages)
+[![Node](https://img.shields.io/badge/node-18%2B-green.svg)](https://nodejs.org/)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Safety Gates](https://img.shields.io/badge/safety-no%20panic%20%E2%80%A2%20unsafe%20contained-success)](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml)
+[![Contributors](https://img.shields.io/github/contributors/TwinsEarth/agent-universe)](https://github.com/TwinsEarth/agent-universe/graphs/contributors)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
 ## 核心理念
 
@@ -87,6 +95,15 @@
 | `marketplace/` | **智能体市场 Agent Market**（v2.3.4）：注册/发现/匹配/BFT验证/结算/信誉 |
 | `bin/` | **gsn-daemon** 守护进程 |
 
+> **库面模块与运行面的区分（v3.5.9，DOC-05 / 自审 F-4）**：上表是 **gsn-core 代码库的
+> 模块清单**，不等于「守护进程实际构造运行的能力」。其中 `topology/`、`scheduler/`、
+> `memory/`、`swarm/`、`mesh/`、`nat/` 目前是 **library-only / 实验性模块**：它们的类型
+> 被 `lib.rs` re-export、有单元测试，但**不在 `gsn-daemon` 的启动运行图中构造**；节点实际的
+> 网络发现/广播/打洞走 **libp2p**（`net/` 的 Kademlia、GossipSub、AutoNAT、DCUtR、Relay），
+> 调度与群体涌现的运行能力由官方插件以各自实现提供。各模块头注释有逐条标注，「接线启用
+> 还是收敛删除」的待决记录与能力边界现状见
+> [`docs/CAPABILITY-STATUS.md`](docs/CAPABILITY-STATUS.md)。
+
 ### Python SDK（aip-sdk-py）
 
 - Agent Interop Protocol 客户端
@@ -167,7 +184,7 @@ cargo run --release --bin gsn-daemon -- \
 | `GET /tasks` | 任务列表 |
 | `POST /agents` | 注册 AgentCard（同时落 SQLite 与 DHT） |
 
-> **当前实现状态**：gsn-daemon 已是**真实网络节点**——libp2p（Noise 加密 + Kademlia DHT + GossipSub）真实 bind P2P 端口，HTTP API 真实 bind API 端口，agents/tasks 通过 SQLite 真实落盘并在重启后恢复。已真机验证：两端口 `LISTEN`、各 API 端点返回正确、POST 注册可查、404 路径正确转义、kill 重启后数据仍在。核心业务逻辑（Agent Market 结算守恒、BFT-lite 验证、信誉）由 155 个 Rust 测试 + 17 个 Python 测试 + 12 个 JS 测试守护，跨语言签名测试保证三端身份/签名互验。链上结算与跨主机多节点 DHT 联调为下一步目标。
+> **当前实现状态**：gsn-daemon 已是**真实网络节点**——libp2p（Noise 加密 + Kademlia DHT + GossipSub）真实 bind P2P 端口，HTTP API 真实 bind API 端口，agents/tasks 通过 SQLite 真实落盘并在重启后恢复。已真机验证：两端口 `LISTEN`、各 API 端点返回正确、POST 注册可查、404 路径正确转义、kill 重启后数据仍在。核心业务逻辑（Agent Market 结算守恒、BFT-lite 验证、信誉）由 618 个 Rust 测试 + 19 个 Python 测试 + 22 个 JS 测试守护（随版本增长，以发布时 cargo test / pytest / node 实测为准），跨语言签名测试保证三端身份/签名互验。链上结算与跨主机多节点 DHT 联调为下一步目标。
 
 ### 三大连接层：CLI · API · MCP（v2.3.5 引入，v2.3.6 深化）
 
@@ -219,14 +236,14 @@ gsn market stats                        # 市场统计
 
 业务错误返回 `422`，资源不存在返回 `404`，注册类成功返回 `201`，`OPTIONS` 返回 `204`。
 
-**③ MCP（18 个市场工具，支持 stdio 与 HTTP/SSE 两种传输）**
+**③ MCP（20 个市场工具，支持 stdio 与 HTTP/SSE 两种传输）**
 
 - stdio：`gsn mcp`，逐行读写 JSON-RPC（日志走 stderr），可直接接入 Claude Desktop / Cursor 等；
 - HTTP：`POST /api/v1/mcp` 无状态 JSON-RPC，`GET /api/v1/mcp` 返回 `text/event-stream` 初始化帧。
 
-工具命名 `market_*`，覆盖：`market_register_agent`、`market_discover_agents`、`market_publish_task`、`market_submit_bid`、`market_match_task`、`market_submit_result`、`market_verify_result`、`market_settle_task`、`market_open_dispute`、`market_arbitrate`、`market_deposit`、`market_balance`、`market_conservation`、`market_leaderboard`、`market_stats` 等共 18 个。`tools/call` 全部路由到市场 actor **真实执行**（非占位）。
+工具命名 `market_*`，覆盖：`market_register_agent`、`market_discover_agents`、`market_publish_task`、`market_submit_bid`、`market_match_task`、`market_submit_result`、`market_verify_result`、`market_settle_task`、`market_open_dispute`、`market_arbitrate`、`market_deposit`、`market_balance`、`market_conservation`、`market_leaderboard`、`market_stats` 等共 20 个。`tools/call` 全部路由到市场 actor **真实执行**（非占位）。
 
-> 三层均已真机验证：daemon 真实 bind P2P/API 端口，curl 走通「充值→注册→发布→投标→匹配→结果→验证→结算→守恒」完整闭环；MCP stdio 完成 `initialize` / `tools/list`（18 工具）/ `tools/call`；CLI 各子命令连接节点返回真实数据。由 155 个 Rust 测试守护，跨语言签名测试保证 Rust/Python/JS 三端身份、规范载荷与签名逐字节一致、可互验。
+> 三层均已真机验证：daemon 真实 bind P2P/API 端口，curl 走通「充值→注册→发布→投标→匹配→结果→验证→结算→守恒」完整闭环；MCP stdio 完成 `initialize` / `tools/list`（20 工具）/ `tools/call`；CLI 各子命令连接节点返回真实数据。由 618 个 Rust 测试守护，跨语言签名测试保证 Rust/Python/JS 三端身份、规范载荷与签名逐字节一致、可互验。
 
 ### Python SDK 使用
 
@@ -445,7 +462,7 @@ AipIdentity.verifyObject(manifest, id.publicKey);   // true
 const { McpHttpClient } = require('@twinsearth/agent-universe');
 const mcp = new McpHttpClient('http://127.0.0.1:4002');
 await mcp.initialize();
-const tools = await mcp.listTools();        // 18 个工具，字段为规范 inputSchema
+const tools = await mcp.listTools();        // 20 个工具，字段为规范 inputSchema
 await mcp.callTool('market_stats', {});    // 经 daemon 真实路由执行
 ```
 

package/js/index.js

@@ -9,7 +9,7 @@ const { AgentMarket, Bid, Reputation, MIN_STAKE } = require('./lib/market');
 const { McpHttpClient, McpError, MCP_PROTOCOL_VERSION } = require('./lib/mcp');
 const aca = require('./lib/aca');
 
-const version = '3.4.5';
+const version = '3.6.0';
 
 /**
  * AgentUniverse 门面：聚合身份、网络、市场能力

package/js/lib/aca.js

@@ -158,7 +158,7 @@ function buildManifest(identity, name, capabilities, opts = {}) {
   const manifest = {
     did: identity.did,
     name,
-    version: opts.version || '3.4.5',
+    version: opts.version || '3.6.0',
     capabilities: [...capabilities],
     endpoints: opts.endpoints || [],
     hardware: {

package/js/lib/mcp.js

@@ -18,12 +18,25 @@ class McpHttpClient {
   constructor(
     baseUrl = 'http://127.0.0.1:4002',
     path = '/api/v1/mcp',
-    timeout = 10000
+    timeout = 10000,
+    authToken = null
   ) {
     this.endpoint = baseUrl.replace(/\/$/, '') + path;
     this.timeout = timeout;
     this._id = 0;
     this.initialized = false;
+    // v3.5.3（AU-15）：可选 Bearer token。设置后所有 MCP 请求带
+    // `Authorization: Bearer <token>`；不设置则不发送该头（保持现状）。
+    this.authToken = authToken || null;
+  }
+
+  _headers() {
+    const h = {
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+    };
+    if (this.authToken) h['Authorization'] = `Bearer ${this.authToken}`;
+    return h;
   }
 
   async _post(payload, awaitResponse = true) {
@@ -33,10 +46,7 @@ class McpHttpClient {
     try {
       res = await fetch(this.endpoint, {
         method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          Accept: 'application/json',
-        },
+        headers: this._headers(),
         body: JSON.stringify(payload),
         signal: ctrl.signal,
       });
@@ -60,7 +70,7 @@ class McpHttpClient {
       method: 'initialize',
       params: {
         protocolVersion: MCP_PROTOCOL_VERSION,
-        clientInfo: { name: 'agent-universe-js', version: '3.4.5' },
+        clientInfo: { name: 'agent-universe-js', version: '3.6.0' },
         capabilities: {},
       },
     });

package/js/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "3.4.5",
+  "version": "3.6.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@twinsearth/agent-universe",
-      "version": "3.4.5",
+      "version": "3.6.0",
       "license": "MIT",
       "engines": {
         "node": ">=18"

package/js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "3.4.5",
+  "version": "3.6.0",
   "description": "Agent Universe - 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。使命：让科技造福全人类！",
   "main": "index.js",
   "types": "index.d.ts",

package/js/test/test.js

@@ -25,6 +25,7 @@ const {
   verifyMessage,
   verifyReceipt,
   verifyReceiptResult,
+  McpHttpClient,
 } = require('../index');
 
 let passed = 0;
@@ -43,8 +44,8 @@ function test(name, fn) {
 console.log('Agent Universe JS SDK 测试\n');
 
 // 1. 版本号
-test('版本号为 3.4.5', () => {
-  assert.strictEqual(version, '3.4.5');
+test('版本号为 3.6.0', () => {
+  assert.strictEqual(version, '3.6.0');
 });
 
 // 2. 密钥对 + DID + 签名验证
@@ -101,7 +102,11 @@ test('ShardedIndex 分片落盘且分片号合法', () => {
     assert.ok(s >= 0 && s < 16);
   }
   assert.strictEqual(idx.size, 100);
-  assert.strictEqual(shardOf('key-0', 16), shardOf('key-0', 16));
+  // v3.5.3（AU-39）：旧断言 shardOf('key-0',16) === shardOf('key-0',16) 恒真（自身比自身）。
+  // 改为有意义的不变量：①同一 key 分片结果确定（两次调用一致）；②结果落在合法区间 [0,16)。
+  const shard = shardOf('key-0', 16);
+  assert.strictEqual(shardOf('key-0', 16), shard);
+  assert.ok(Number.isInteger(shard) && shard >= 0 && shard < 16, `分片号合法: ${shard}`);
   // 分布：100 key 到 16 片，不应有大片为空（概率性，至少覆盖 8 片）
   const nonEmpty = idx.distribution().filter((n) => n > 0).length;
   assert.ok(nonEmpty >= 8, `非空分片 ${nonEmpty} >= 8`);
@@ -447,6 +452,17 @@ test('v2.7.1 stableStringify：undefined 键省略、BigInt/Date 显式拒绝、
   assert.strictEqual(stableStringify({ b: 1, a: 2 }), '{"a":2,"b":1}');
 });
 
+// 18. MCP Bearer 注入（v3.5.3，AU-15）
+test('McpHttpClient：带 token 发 Bearer 头、不带则不发', () => {
+  // 不设置 token → 不出现 Authorization 头。
+  const noAuth = new McpHttpClient();
+  assert.strictEqual(noAuth._headers().Authorization, undefined);
+  assert.strictEqual(noAuth._headers()['Content-Type'], 'application/json');
+  // 设置 token → 带正确的 Bearer 头。
+  const withAuth = new McpHttpClient('http://127.0.0.1:4002', '/api/v1/mcp', 10000, 'secret-xyz');
+  assert.strictEqual(withAuth._headers().Authorization, 'Bearer secret-xyz');
+});
+
 console.log(`\n${passed} 项测试通过`);
 if (process.exitCode === 1) {
   console.error('存在失败测试');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/agent-universe",
-  "version": "3.4.5",
+  "version": "3.6.0",
   "description": "Agent Universe - 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。使命：让科技造福全人类！",
   "main": "index.js",
   "types": "index.d.ts",