@twinsearth/agent-universe 2.3.6 → 2.5.6

package/index.js

@@ -1,71 +1,7 @@
-// index.js
-// Agent Universe（智能体宇宙）主入口
+// Agent Universe - 智能体宇宙
 // 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络
+//
+// 根入口：re-export js/ 完整 SDK 实现。
+// 另有 Rust 核心库 gsn-core（cd gsn-core && cargo build）与 Python SDK (aip-sdk-py)。
 
-const { Keypair } = require('./lib/keychain');
-const { AgentCard, Task, TaskStatus } = require('./lib/models');
-const { MemoryDHT, ShardedIndex, shardOf } = require('./lib/dht');
-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 = '2.3.6';
-
-/**
- * AgentUniverse 门面：聚合身份、网络、市场能力
- */
-class AgentUniverse {
-  constructor() {
-    this.identity = Keypair.generate();
-    this.dht = new MemoryDHT();
-    this.market = new AgentMarket();
-  }
-
-  get did() {
-    return this.identity.did;
-  }
-
-  /** 注册一张 AgentCard 到本地网络 */
-  register(card) {
-    this.dht.put(card.did, card);
-    return card;
-  }
-
-  /** 发现某能力的 Agent */
-  discover(capability) {
-    return this.market.discoverBySkill(capability);
-  }
-}
-
-module.exports = {
-  version,
-  AgentUniverse,
-  Keypair,
-  AgentCard,
-  Task,
-  TaskStatus,
-  MemoryDHT,
-  ShardedIndex,
-  shardOf,
-  AgentMarket,
-  Bid,
-  Reputation,
-  MIN_STAKE,
-  // MCP
-  McpHttpClient,
-  McpError,
-  MCP_PROTOCOL_VERSION,
-  // ACA（跨语言对齐身份与协议对象）
-  AipIdentity: aca.AipIdentity,
-  buildManifest: aca.buildManifest,
-  buildEnvelope: aca.buildEnvelope,
-  buildMessage: aca.buildMessage,
-  buildReceipt: aca.buildReceipt,
-  handshakeMessage: aca.handshakeMessage,
-  proposalMessage: aca.proposalMessage,
-  receiptMessage: aca.receiptMessage,
-  verifyManifest: aca.verifyManifest,
-  verifyMessage: aca.verifyMessage,
-  verifyReceipt: aca.verifyReceipt,
-  verifyReceiptResult: aca.verifyReceiptResult,
-};
+module.exports = require('./js');

package/js/index.d.ts

@@ -0,0 +1,209 @@
+// Type definitions for @twinsearth/agent-universe
+
+export const version: string;
+export const MIN_STAKE: number;
+
+export class Keypair {
+  publicKey: string;
+  privateKey: string;
+  did: string;
+  static generate(): Keypair;
+  sign(message: string | Buffer): string;
+  verify(message: string | Buffer, signatureHex: string): boolean;
+}
+
+export class AgentCard {
+  did: string;
+  name: string;
+  capabilities: string[];
+  skills: string[];
+  version: string;
+  stake: number;
+  reputation: number;
+  static new(opts: { did: string; name: string }): AgentCard;
+  withCapability(cap: string): this;
+  withSkill(skill: string): this;
+  hasCapability(cap: string): boolean;
+}
+
+export const TaskStatus: Record<string, string>;
+
+export class Task {
+  taskId: string;
+  goal: string;
+  status: string;
+  assignee: string | null;
+  history: string[];
+  constructor(taskId: string, goal: string);
+  assign(did: string): this;
+  start(): this;
+  complete(): this;
+  verify(passed: boolean): this;
+  settle(): this;
+  readonly isTerminal: boolean;
+}
+
+export class MemoryDHT {
+  put(key: string, value: unknown): void;
+  get(key: string): unknown;
+  has(key: string): boolean;
+  remove(key: string): boolean;
+  readonly size: number;
+}
+
+export class ShardedIndex {
+  constructor(numShards?: number);
+  put(key: string, value: unknown): number;
+  get(key: string): unknown;
+  has(key: string): boolean;
+  remove(key: string): boolean;
+  readonly size: number;
+  distribution(): number[];
+}
+
+export function shardOf(key: string, numShards: number): number;
+
+export class Bid {
+  agentId: string;
+  price: number;
+}
+
+export class Reputation {
+  quality: number;
+  speed: number;
+  honesty: number;
+  availability: number;
+  overall(): number;
+}
+
+export class AgentMarket {
+  agents: Map<string, unknown>;
+  tasks: Map<string, Task>;
+  deposit(account: string, amount: number): void;
+  balance(account: string): number;
+  registerAgent(card: AgentCard, stake: number): boolean;
+  publishTask(taskId: string, goal: string, budget: number, requester: string): Task;
+  submitBid(taskId: string, agentId: string, price: number): boolean;
+  matchTask(taskId: string): Bid;
+  completeTask(taskId: string, passed?: boolean): Task;
+  settle(taskId: string): { paid: number; reason: string };
+  slash(agentId: string, amount: number, reason: string): unknown;
+  discoverBySkill(skill: string): AgentCard[];
+  leaderboard(limit?: number): unknown[];
+  conservationCheck(totalDeposits: number): {
+    conserved: boolean;
+    balanceSum: number;
+    totalSlashed: number;
+    expected: number;
+  };
+}
+
+export class AgentUniverse {
+  identity: Keypair;
+  dht: MemoryDHT;
+  market: AgentMarket;
+  readonly did: string;
+  register(card: AgentCard): AgentCard;
+  discover(capability: string): AgentCard[];
+}
+
+// ── MCP ──
+export const MCP_PROTOCOL_VERSION: string;
+
+export class McpError extends Error {
+  code: number;
+}
+
+export class McpHttpClient {
+  initialized: boolean;
+  constructor(baseUrl?: string, path?: string, timeout?: number);
+  initialize(): Promise<{
+    protocolVersion: string;
+    serverInfo: { name: string; version: string };
+  }>;
+  ping(): Promise<boolean>;
+  listTools(): Promise<
+    Array<{
+      name: string;
+      description?: string;
+      inputSchema: Record<string, unknown>;
+    }>
+  >;
+  callTool(
+    name: string,
+    args?: Record<string, unknown>
+  ): Promise<{ content: Array<{ type: string; text: string }>; isError?: boolean }>;
+}
+
+// ── ACA ──
+export class AipIdentity {
+  did: string;
+  readonly publicKey: Buffer;
+  static generate(): AipIdentity;
+  static fromSeed(seed: Buffer | Uint8Array): AipIdentity;
+  signObject(obj: Record<string, unknown>): string;
+  signInto(obj: Record<string, unknown>): Record<string, unknown>;
+  static verifyObject(obj: Record<string, unknown>, rawPub: Buffer): boolean;
+}
+
+export function buildManifest(
+  identity: AipIdentity,
+  name: string,
+  capabilities: string[],
+  opts?: Record<string, unknown>
+): Record<string, unknown>;
+
+export function buildEnvelope(
+  requesterDid: string,
+  capability: string,
+  outputSpec: string,
+  opts?: Record<string, unknown>
+): Record<string, unknown>;
+
+export function buildMessage(
+  identity: AipIdentity,
+  msgType: string,
+  toDid: string,
+  payload: unknown
+): Record<string, unknown>;
+
+export function buildReceipt(
+  identity: AipIdentity,
+  taskId: string,
+  result: Buffer,
+  opts?: Record<string, unknown>
+): Record<string, unknown>;
+
+export function handshakeMessage(
+  identity: AipIdentity,
+  manifest: Record<string, unknown>
+): Record<string, unknown>;
+
+export function proposalMessage(
+  identity: AipIdentity,
+  toDid: string,
+  envelope: Record<string, unknown>
+): Record<string, unknown>;
+
+export function receiptMessage(
+  identity: AipIdentity,
+  toDid: string,
+  receipt: Record<string, unknown>
+): Record<string, unknown>;
+
+export function verifyManifest(
+  manifest: Record<string, unknown>,
+  rawPub: Buffer
+): boolean;
+export function verifyMessage(
+  message: Record<string, unknown>,
+  rawPub: Buffer
+): boolean;
+export function verifyReceipt(
+  receipt: Record<string, unknown>,
+  rawPub: Buffer
+): boolean;
+export function verifyReceiptResult(
+  receipt: Record<string, unknown>,
+  result: Buffer
+): boolean;

package/js/index.js

@@ -0,0 +1,71 @@
+// index.js
+// Agent Universe（智能体宇宙）主入口
+// 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络
+
+const { Keypair } = require('./lib/keychain');
+const { AgentCard, Task, TaskStatus } = require('./lib/models');
+const { MemoryDHT, ShardedIndex, shardOf } = require('./lib/dht');
+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 = '2.5.6';
+
+/**
+ * AgentUniverse 门面：聚合身份、网络、市场能力
+ */
+class AgentUniverse {
+  constructor() {
+    this.identity = Keypair.generate();
+    this.dht = new MemoryDHT();
+    this.market = new AgentMarket();
+  }
+
+  get did() {
+    return this.identity.did;
+  }
+
+  /** 注册一张 AgentCard 到本地网络 */
+  register(card) {
+    this.dht.put(card.did, card);
+    return card;
+  }
+
+  /** 发现某能力的 Agent */
+  discover(capability) {
+    return this.market.discoverBySkill(capability);
+  }
+}
+
+module.exports = {
+  version,
+  AgentUniverse,
+  Keypair,
+  AgentCard,
+  Task,
+  TaskStatus,
+  MemoryDHT,
+  ShardedIndex,
+  shardOf,
+  AgentMarket,
+  Bid,
+  Reputation,
+  MIN_STAKE,
+  // MCP
+  McpHttpClient,
+  McpError,
+  MCP_PROTOCOL_VERSION,
+  // ACA（跨语言对齐身份与协议对象）
+  AipIdentity: aca.AipIdentity,
+  buildManifest: aca.buildManifest,
+  buildEnvelope: aca.buildEnvelope,
+  buildMessage: aca.buildMessage,
+  buildReceipt: aca.buildReceipt,
+  handshakeMessage: aca.handshakeMessage,
+  proposalMessage: aca.proposalMessage,
+  receiptMessage: aca.receiptMessage,
+  verifyManifest: aca.verifyManifest,
+  verifyMessage: aca.verifyMessage,
+  verifyReceipt: aca.verifyReceipt,
+  verifyReceiptResult: aca.verifyReceiptResult,
+};

package/{lib → js/lib}/aca.js

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

package/{lib → js/lib}/mcp.js

@@ -60,7 +60,7 @@ class McpHttpClient {
       method: 'initialize',
       params: {
         protocolVersion: MCP_PROTOCOL_VERSION,
-        clientInfo: { name: 'agent-universe-js', version: '2.3.6' },
+        clientInfo: { name: 'agent-universe-js', version: '2.5.6' },
         capabilities: {},
       },
     });

package/js/package-lock.json

@@ -0,0 +1,16 @@
+{
+  "name": "@twinsearth/agent-universe",
+  "version": "2.5.6",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@twinsearth/agent-universe",
+      "version": "2.5.6",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    }
+  }
+}

package/js/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@twinsearth/agent-universe",
+  "version": "2.5.6",
+  "description": "Agent Universe - 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。使命：让科技造福全人类！",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "test": "node test/test.js"
+  },
+  "keywords": [
+    "agi",
+    "agent",
+    "p2p",
+    "decentralized",
+    "swarm",
+    "dht",
+    "mcp",
+    "a2a",
+    "agent-market"
+  ],
+  "author": "TwinsEarth",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TwinsEarth/agent-universe.git",
+    "directory": "js"
+  },
+  "homepage": "https://github.com/TwinsEarth/agent-universe#readme",
+  "bugs": {
+    "url": "https://github.com/TwinsEarth/agent-universe/issues"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "lib"
+  ]
+}

package/js/test/test.js

@@ -0,0 +1,224 @@
+// test/test.js
+// Agent Universe JS SDK 测试（8 项）
+
+const assert = require('node:assert');
+const {
+  version,
+  AgentUniverse,
+  Keypair,
+  AgentCard,
+  Task,
+  TaskStatus,
+  MemoryDHT,
+  ShardedIndex,
+  shardOf,
+  AgentMarket,
+  MIN_STAKE,
+  AipIdentity,
+  buildManifest,
+  buildEnvelope,
+  proposalMessage,
+  buildReceipt,
+  verifyManifest,
+  verifyMessage,
+  verifyReceipt,
+  verifyReceiptResult,
+} = require('../index');
+
+let passed = 0;
+function test(name, fn) {
+  try {
+    fn();
+    passed++;
+    console.log(`  ✓ ${name}`);
+  } catch (e) {
+    console.error(`  ✗ ${name}`);
+    console.error(`    ${e.message}`);
+    process.exitCode = 1;
+  }
+}
+
+console.log('Agent Universe JS SDK 测试\n');
+
+// 1. 版本号
+test('版本号为 2.5.6', () => {
+  assert.strictEqual(version, '2.5.6');
+});
+
+// 2. 密钥对 + DID + 签名验证
+test('Keypair 生成 DID 且签名可验证', () => {
+  const kp = Keypair.generate();
+  assert.ok(kp.did.startsWith('did:au:'), 'DID 前缀');
+  assert.strictEqual(kp.did.length, 'did:au:'.length + 32);
+  const msg = 'hello agent universe';
+  const sig = kp.sign(msg);
+  assert.ok(kp.verify(msg, sig), '签名验证通过');
+  assert.ok(!kp.verify('tampered', sig), '篡改消息验证失败');
+});
+
+// 3. AgentCard
+test('AgentCard 能力与技能', () => {
+  const card = AgentCard.new({ did: 'did:au:abc', name: 'writer' })
+    .withCapability('writing')
+    .withSkill('translation');
+  assert.ok(card.hasCapability('writing'));
+  assert.deepStrictEqual(card.toJSON().skills, ['translation']);
+});
+
+// 4. Task 状态机
+test('Task 状态机合法流转且拒绝非法转移', () => {
+  const t = new Task('t1', 'write doc');
+  t.transition(TaskStatus.OPEN);
+  t.assign('did:au:worker');
+  t.start();
+  t.complete();
+  t.verify(true);
+  t.settle();
+  assert.strictEqual(t.status, TaskStatus.SETTLED);
+  assert.ok(t.isTerminal);
+
+  const t2 = new Task('t2', 'bad');
+  assert.throws(() => t2.start(), /非法状态转移/);
+});
+
+// 5. MemoryDHT
+test('MemoryDHT 存取与前缀查找', () => {
+  const dht = new MemoryDHT();
+  dht.put('/aip/agent/1', { name: 'a' });
+  dht.put('/aip/agent/2', { name: 'b' });
+  assert.strictEqual(dht.size, 2);
+  assert.strictEqual(dht.get('/aip/agent/1').name, 'a');
+  assert.strictEqual(dht.findByPrefix('/aip/agent').length, 2);
+});
+
+// 6. ShardedIndex 分片
+test('ShardedIndex 分片落盘且分片号合法', () => {
+  const idx = new ShardedIndex(16);
+  for (let i = 0; i < 100; i++) {
+    const s = idx.put(`key-${i}`, i);
+    assert.ok(s >= 0 && s < 16);
+  }
+  assert.strictEqual(idx.size, 100);
+  assert.strictEqual(shardOf('key-0', 16), shardOf('key-0', 16));
+  // 分布：100 key 到 16 片，不应有大片为空（概率性，至少覆盖 8 片）
+  const nonEmpty = idx.distribution().filter((n) => n > 0).length;
+  assert.ok(nonEmpty >= 8, `非空分片 ${nonEmpty} >= 8`);
+});
+
+// 7. AgentMarket 端到端 + 守恒
+test('AgentMarket 端到端：注册→发布→投标→匹配→完成→结算→守恒', () => {
+  const market = new AgentMarket();
+  const owner = 'did:au:owner';
+  const requester = 'did:au:requester';
+
+  // 充值（owner 质押 100，requester 预算 50）
+  market.deposit(owner, 100);
+  market.deposit(requester, 50);
+  const totalDeposits = 150;
+
+  const card = AgentCard.new({ did: owner, name: 'worker' })
+    .withSkill('writing');
+  market.registerAgent(card, MIN_STAKE);
+
+  market.publishTask('task-1', 'write an article', 50, requester);
+  market.submitBid('task-1', owner, 40);
+  const winner = market.matchTask('task-1');
+  assert.strictEqual(winner.agentId, owner);
+
+  market.completeTask('task-1', true);
+  const result = market.settle('task-1');
+  assert.strictEqual(result.paid, 40);
+
+  // 重复结算短路
+  const again = market.settle('task-1');
+  assert.strictEqual(again.reason, 'already_paid');
+
+  // 守恒：无罚没，总余额 = 总充值
+  const check = market.conservationCheck(totalDeposits);
+  assert.ok(check.conserved, `守恒: ${JSON.stringify(check)}`);
+});
+
+// 8. 罚没守恒
+test('罚没后守恒：总余额 = 总充值 − 罚没', () => {
+  const market = new AgentMarket();
+  const owner = 'did:au:bad';
+  market.deposit(owner, 200);
+  const card = AgentCard.new({ did: owner, name: 'bad' });
+  market.registerAgent(card, MIN_STAKE); // 质押 100
+
+  const slashResult = market.slash(owner, 60, 'fraud');
+  assert.strictEqual(slashResult.slashed, 60);
+
+  const check = market.conservationCheck(200);
+  assert.ok(check.conserved, `罚没守恒: ${JSON.stringify(check)}`);
+  assert.strictEqual(check.balanceSum, 140);
+});
+
+// 9. AipIdentity DID 与签名往返
+test('AipIdentity 生成 did:aip 且签名可验证', () => {
+  const id = AipIdentity.generate();
+  assert.ok(id.did.startsWith('did:aip:'), 'DID 前缀');
+  assert.strictEqual(id.publicKey.length, 32, '原始公钥 32 字节');
+  const obj = { did: id.did, name: 't' };
+  id.signInto(obj);
+  assert.ok(AipIdentity.verifyObject(obj, id.publicKey), '验签通过');
+  const tampered = { ...obj, name: 'x' };
+  assert.ok(!AipIdentity.verifyObject(tampered, id.publicKey), '篡改拒绝');
+});
+
+// 10. 跨语言基准（与 Rust/Python 固定种子一致）
+test('AipIdentity.fromSeed 复算 Rust/Python 基准', () => {
+  const id = AipIdentity.fromSeed(Buffer.alloc(32, 1));
+  assert.strictEqual(
+    id.publicKey.toString('hex'),
+    '8a88e3dd7409f195fd52db2d3cba5d72ca6709bf1d94121bf3748801b40f6f5c'
+  );
+  assert.strictEqual(id.did, 'did:aip:34750f98bd59fcfc');
+  const obj = {
+    did: id.did,
+    name: 'CrossLang',
+    capabilities: ['text-generation', 'mcp'],
+    stake: 100,
+  };
+  const sig = id.signObject(obj);
+  assert.strictEqual(
+    sig,
+    'e14d3f9e8204ea185ea4ba32a8117f262095ab9dac1352e1a7964ce36d3355c288dd6804ffa7daeb5f6eba9f30428f52702a75fd3efbb6a62555a7f24665da0e'
+  );
+});
+
+// 11. ACA manifest/message 构造与验签
+test('ACA manifest 与 proposal message 可验签、篡改拒绝', () => {
+  const owner = AipIdentity.generate();
+  const peer = AipIdentity.generate();
+  const manifest = buildManifest(owner, 'Agent1', ['text-generation'], {
+    stake: 100,
+    mcpToolCount: 3,
+  });
+  assert.ok(verifyManifest(manifest, owner.publicKey));
+  assert.ok(!verifyManifest({ ...manifest, name: 'Fake' }, owner.publicKey));
+
+  const envelope = buildEnvelope(owner.did, 'text-generation', 'out', {
+    budget: 10,
+  });
+  const message = proposalMessage(owner, peer.did, envelope);
+  assert.ok(verifyMessage(message, owner.publicKey));
+  assert.ok(!verifyMessage(message, peer.publicKey), '他人公钥拒绝');
+});
+
+// 12. Receipt 签名与结果哈希
+test('ACA receipt 签名、结果哈希正反例', () => {
+  const owner = AipIdentity.generate();
+  const result = Buffer.from('hello result');
+  const receipt = buildReceipt(owner, 'task-1', result);
+  assert.ok(verifyReceipt(receipt, owner.publicKey));
+  assert.ok(verifyReceiptResult(receipt, result));
+  assert.ok(!verifyReceiptResult(receipt, Buffer.from('other')));
+});
+
+console.log(`\n${passed} 项测试通过`);
+if (process.exitCode === 1) {
+  console.error('存在失败测试');
+} else {
+  console.log('全部通过');
+}