adp-agent 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ADP Working Group
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+<div align="center">
+  <h1>
+    <br>
+    <br>
+    🤖 Agent Discovery Protocol (ADP)
+    <br>
+    <br>
+  </h1>
+</div>
+
+<div align="center">
+
+[![npm version](https://img.shields.io/npm/v/adp-agent.svg?style=flat-square)](https://www.npmjs.com/package/adp-agent)
+[![GitHub license](https://img.shields.io/github/license/mengzhuowei/AgentDiscoveryProtocol.svg?style=flat-square)](https://github.com/mengzhuowei/AgentDiscoveryProtocol/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.4%2B-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
+[![protocol version](https://img.shields.io/badge/protocol-adp%2F0.2-orange.svg?style=flat-square)](docs/README.md)
+[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-green.svg?style=flat-square)](https://modelcontextprotocol.io/)
+
+</div>
+
+<div align="center">
+  <strong>让智能体（Agent）能够互相发现、通信，无需中心化平台</strong>
+</div>
+
+<br>
+
+<div align="center">
+  <a href="#-特性">特性</a> •
+  <a href="#-快速开始">快速开始</a> •
+  <a href="#-安装">安装</a> •
+  <a href="#-使用示例">示例</a> •
+  <a href="#-架构">架构</a> •
+  <a href="#-文档">文档</a>
+</div>
+
+<br>
+
+---
+
+## 特性
+
+- **自认证密码学身份** — Agent ID 嵌入 Ed25519 公钥，持有私钥即拥有 ID
+- **去中心化优先** — 局域网 mDNS 零配置发现，Registry/Relay 可选
+- **强制签名验证** — 所有消息 Ed25519 签名
+- **模块化架构** — Gateway、Registry、Relay 独立部署
+- **MCP 兼容** — 直接作为 MCP（Model Context Protocol）服务运行
+- **开箱即用** — TypeScript 完整实现，含示例和测试
+
+## 快速开始
+
+```bash
+git clone https://github.com/mengzhuowei/AgentDiscoveryProtocol.git
+cd AgentDiscoveryProtocol
+npm install
+npm start agent1          # 终端 1
+npm start agent2          # 终端 2，自动发现 agent1
+```
+
+## 安装
+
+```bash
+npm install adp-agent             # 作为库
+npm install -g adp-agent          # 全局安装，获得 adp 命令
+```
+
+## 使用示例
+
+```typescript
+import { Gateway, loadOrCreateIdentity } from 'adp-agent';
+
+const { identity } = loadOrCreateIdentity('local', 'my-agent', 'My Agent');
+const gateway = new Gateway({
+  port: 9900,
+  host: '0.0.0.0',
+  secretKey: identity.secretKey,
+  agentId: identity.agentId,
+  displayName: 'My Agent',
+  capabilities: ['adp:ping', 'adp:capability.query'],
+});
+```
+
+详细的启动参数、配置、MCP Server 集成等见 [USAGE.md](USAGE.md)。
+
+## 架构
+
+```
+┌───────────────────────────────────┐
+│              应用层               │
+│  自定义能力（视频生成、计算等）   │
+└──────────────┬────────────────────┘
+               │
+┌──────────────▼────────────────────┐
+│             消息层                │
+│  Envelope + Ed25519 签名 + 任务   │
+└──────────────┬────────────────────┘
+               │
+┌──────────────▼────────────────────┐
+│             传输层                │
+│  WebSocket 直连 ── Relay 中继    │
+└──────────────┬────────────────────┘
+               │
+┌──────────────▼────────────────────┐
+│             发现层                │
+│  mDNS ── Registry 目录（可选）   │
+└───────────────────────────────────┘
+```
+
+## 开发
+
+```bash
+npm test                    # 核心测试
+npm run test:integration    # 集成测试
+npm run relay               # 启动 Relay
+npm run registry            # 启动 Registry
+npm run build               # 编译到 dist/
+```
+
+## 文档
+
+| 文档 | 说明 |
+|------|------|
+| [Docker 部署指南](docs/docker.md) | 使用 Docker 部署 |
+| [身份与 Manifest](docs/01-identity.md) | Agent ID、能力声明 |
+| [消息格式](docs/02-message.md) | Envelope、签名、错误码 |
+| [发现机制](docs/03-discovery.md) | mDNS、Registry |
+| [传输层](docs/04-transport.md) | WebSocket、Relay |
+| [安全与信任](docs/05-security.md) | TOFU、签名验证 |
+| [实现检查清单](docs/implementation-checklist.md) | 协议合规性 |
+
+## 路线图
+
+- [x] **v0.2** — 自认证身份、签名验证、TOFU
+- [x] **Registry** — 中心化目录服务
+- [x] **MCP 集成** — 作为 MCP 服务运行
+- [ ] **任务委派** — 跨 Agent 任务调度
+- [ ] **端到端加密** — 可选 E2EE
+- [ ] **更多语言实现** — Python、Rust
+
+## 许可证
+
+MIT © [ADP Working Group](https://github.com/mengzhuowei/AgentDiscoveryProtocol)

package/config.example.json

@@ -0,0 +1,32 @@
+{
+  "port": 3000,
+  "host": "0.0.0.0",
+  "mysql": {
+    "host": "127.0.0.1",
+    "port": 3306,
+    "user": "root",
+    "password": "your-password",
+    "database": "adp_registry"
+  },
+  "redis": {
+    "host": "127.0.0.1",
+    "port": 6379
+  },
+  "registration": {
+    "ttlSeconds": 86400,
+    "maxAgents": 10000
+  },
+  "token": {
+    "enabled": false,
+    "tokens": {
+      "your-secret-token": {
+        "namespace": "home.io",
+        "capabilities": ["read", "write"]
+      }
+    }
+  },
+  "cors": {
+    "enabled": false,
+    "origins": ["*"]
+  }
+}

package/dist/agent-id.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedAgentId {
+    publicKey: Uint8Array;
+    namespace: string;
+    agentName: string;
+}
+export declare function parseAgentId(agentId: string): ParsedAgentId;
+export declare function buildAgentId(publicKey: Uint8Array, namespace: string, agentName: string): string;
+export declare function extractPublicKey(agentId: string): Uint8Array;
+export declare function extractVisualCode(publicKey: Uint8Array): string;

package/dist/agent-id.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAgentId = parseAgentId;
+exports.buildAgentId = buildAgentId;
+exports.extractPublicKey = extractPublicKey;
+exports.extractVisualCode = extractVisualCode;
+const crypto_1 = require("./crypto");
+function parseAgentId(agentId) {
+    const match = agentId.match(/^adp:\/\/([^@]+)@([^/]+)\/(.+)$/);
+    if (!match) {
+        throw new Error('Invalid Agent ID format');
+    }
+    const [, pubkeyB64URL, namespace, agentName] = match;
+    if (pubkeyB64URL.length !== 43) {
+        throw new Error('Invalid public key length: must be 43 characters');
+    }
+    const publicKey = (0, crypto_1.decodeBase64URL)(pubkeyB64URL);
+    if (publicKey.length !== 32) {
+        throw new Error('Invalid public key: must decode to 32 bytes');
+    }
+    if (!/^[a-z0-9.-]+$/.test(namespace)) {
+        throw new Error('Invalid namespace: must be lowercase letters, digits, dots, and hyphens');
+    }
+    if (!/^[a-z0-9_-]{1,32}$/.test(agentName)) {
+        throw new Error('Invalid agent name: must be lowercase letters, digits, underscores, and hyphens, max 32 characters');
+    }
+    return { publicKey, namespace, agentName };
+}
+function buildAgentId(publicKey, namespace, agentName) {
+    if (publicKey.length !== 32) {
+        throw new Error('Public key must be 32 bytes');
+    }
+    const pubkeyB64URL = (0, crypto_1.encodeBase64URL)(publicKey);
+    return `adp://${pubkeyB64URL}@${namespace}/${agentName}`;
+}
+function extractPublicKey(agentId) {
+    return parseAgentId(agentId).publicKey;
+}
+function extractVisualCode(publicKey) {
+    const hash = blake2b(publicKey, 6);
+    return (0, crypto_1.encodeBase64URL)(hash);
+}
+function blake2b(data, outputBytes) {
+    const result = new Uint8Array(outputBytes);
+    const blockSize = 64;
+    const key = new Uint8Array(0);
+    const h = new Uint32Array([
+        0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a,
+        0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
+    ]);
+    const sigma = [
+        0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
+        14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3,
+        11, 8, 12, 0, 5, 2, 15, 13, 10, 14, 3, 6, 7, 1, 9, 4,
+        7, 9, 3, 1, 13, 12, 11, 14, 2, 6, 5, 10, 4, 0, 15, 8,
+        9, 0, 5, 7, 2, 4, 10, 15, 14, 1, 11, 12, 6, 8, 3, 13,
+        2, 12, 6, 10, 0, 11, 8, 3, 4, 13, 7, 5, 15, 14, 1, 9,
+        12, 5, 1, 15, 14, 13, 4, 10, 0, 7, 6, 3, 9, 2, 8, 11,
+        13, 11, 7, 14, 12, 1, 3, 9, 5, 0, 15, 4, 8, 6, 2, 10,
+        6, 15, 14, 9, 11, 3, 0, 8, 12, 2, 13, 7, 1, 4, 10, 5,
+        10, 2, 8, 4, 7, 6, 1, 5, 15, 11, 9, 14, 3, 12, 13, 0,
+        0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
+        14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3,
+    ];
+    const dataLength = data.length;
+    const blocks = Math.ceil((dataLength + key.length) / blockSize);
+    for (let blockIdx = 0; blockIdx < blocks; blockIdx++) {
+        const block = new Uint8Array(blockSize);
+        const offset = blockIdx * blockSize;
+        for (let i = 0; i < blockSize; i++) {
+            const dataIdx = offset - key.length + i;
+            if (dataIdx >= 0 && dataIdx < dataLength) {
+                block[i] = data[dataIdx];
+            }
+            else if (dataIdx < 0 && i < key.length) {
+                block[i] = key[i];
+            }
+            else {
+                block[i] = 0;
+            }
+        }
+        const m = new Uint32Array(16);
+        for (let i = 0; i < 16; i++) {
+            m[i] = (block[i * 4 + 3] << 24) | (block[i * 4 + 2] << 16) | (block[i * 4 + 1] << 8) | block[i * 4];
+        }
+        const v = new Uint32Array(16);
+        for (let i = 0; i < 8; i++) {
+            v[i] = h[i];
+            v[i + 8] = 0xffffffff;
+        }
+        for (let round = 0; round < 12; round++) {
+            const s = sigma.slice(round * 16, (round + 1) * 16);
+            for (let i = 0; i < 16; i += 2) {
+                const a = s[i];
+                const b = s[i + 1];
+                v[a] = v[a] + v[b] + m[a];
+                v[b] = rot64(v[b] ^ v[a], 32);
+                v[a] = rot64(v[a], 24);
+                v[a] = v[a] + v[b];
+                v[b] = rot64(v[b] ^ v[a], 16);
+                v[a] = rot64(v[a], 63);
+            }
+        }
+        for (let i = 0; i < 8; i++) {
+            h[i] = h[i] ^ v[i] ^ v[i + 8];
+        }
+    }
+    for (let i = 0; i < outputBytes; i++) {
+        const idx = i >> 2;
+        const shift = (i & 3) * 8;
+        result[i] = (h[idx] >> shift) & 0xff;
+    }
+    return result;
+}
+function rot64(x, n) {
+    return ((x << n) | (x >>> (32 - n))) >>> 0;
+}
+//# sourceMappingURL=agent-id.js.map

package/dist/agent-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.js","sourceRoot":"","sources":["../src/agent-id.ts"],"names":[],"mappings":"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AAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACpD,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACpD,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACpD,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACpD,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACpD,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;QACpD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACpD,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACrD,CAAC;IAEF,MAAM,UAAU,GAAG,IAA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"}

package/dist/agent-id.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/agent-id.test.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const agent_id_1 = require("./agent-id");
+const crypto_1 = require("./crypto");
+describe('Agent ID', () => {
+    it('should parse valid agent ID', () => {
+        const keypair = (0, crypto_1.generateKeyPair)();
+        const pubkeyB64URL = (0, crypto_1.encodeBase64URL)(keypair.publicKey);
+        const agentId = `adp://${pubkeyB64URL}@home.io/claude`;
+        const parsed = (0, agent_id_1.parseAgentId)(agentId);
+        expect(parsed.publicKey).toEqual(keypair.publicKey);
+        expect(parsed.namespace).toBe('home.io');
+        expect(parsed.agentName).toBe('claude');
+    });
+    it('should build agent ID from parts', () => {
+        const keypair = (0, crypto_1.generateKeyPair)();
+        const namespace = 'example.com';
+        const agentName = 'hermes';
+        const agentId = (0, agent_id_1.buildAgentId)(keypair.publicKey, namespace, agentName);
+        expect(agentId).toMatch(/^adp:\/\/[A-Za-z0-9_-]{43}@example\.com\/hermes$/);
+        const parsed = (0, agent_id_1.parseAgentId)(agentId);
+        expect(parsed.publicKey).toEqual(keypair.publicKey);
+    });
+    it('should extract public key from agent ID', () => {
+        const keypair = (0, crypto_1.generateKeyPair)();
+        const agentId = (0, agent_id_1.buildAgentId)(keypair.publicKey, 'test.io', 'agent');
+        const extracted = (0, agent_id_1.extractPublicKey)(agentId);
+        expect(extracted).toEqual(keypair.publicKey);
+    });
+    it('should reject invalid agent ID', () => {
+        expect(() => (0, agent_id_1.parseAgentId)('invalid')).toThrow();
+        expect(() => (0, agent_id_1.parseAgentId)('adp://short@home.io/agent')).toThrow();
+        expect(() => (0, agent_id_1.parseAgentId)('adp://mLq3x9Z1KfR7tNwP2bVsQ8cJ5hG4mF6aY0dL3kX1yZIB@invalid domain/agent')).toThrow();
+    });
+});
+//# sourceMappingURL=agent-id.test.js.map

package/dist/agent-id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.test.js","sourceRoot":"","sources":["../src/agent-id.test.ts"],"names":[],"mappings":";;AAAA,yCAA0E;AAC1E,qCAA4D;AAE5D,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,IAAA,wBAAe,GAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAA,wBAAe,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,SAAS,YAAY,iBAAiB,CAAC;QAEvD,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC,OAAO,CAAC,CAAC;QAErC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG,IAAA,wBAAe,GAAE,CAAC;QAClC,MAAM,SAAS,GAAG,aAAa,CAAC;QAChC,MAAM,SAAS,GAAG,QAAQ,CAAC;QAE3B,MAAM,OAAO,GAAG,IAAA,uBAAY,EAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAEtE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC;QAE5E,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG,IAAA,wBAAe,GAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAA,uBAAY,EAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAEpE,MAAM,SAAS,GAAG,IAAA,2BAAgB,EAAC,OAAO,CAAC,CAAC;QAE5C,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,uBAAY,EAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,uBAAY,EAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAClE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,uBAAY,EAAC,yEAAyE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAClH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/canonical.d.ts

@@ -0,0 +1,5 @@
+export declare function canonicalize(obj: unknown): string;
+export declare function testVectors(): {
+    input: unknown;
+    expected: string;
+}[];

package/dist/canonical.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalize = canonicalize;
+exports.testVectors = testVectors;
+function sortObjectKeys(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(sortObjectKeys);
+    }
+    if (obj && typeof obj === 'object' && obj !== null) {
+        const sorted = {};
+        const keys = Object.keys(obj).sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' }));
+        for (const key of keys) {
+            const value = obj[key];
+            if (value !== undefined) {
+                sorted[key] = sortObjectKeys(value);
+            }
+        }
+        return sorted;
+    }
+    return obj;
+}
+function canonicalize(obj) {
+    const sorted = sortObjectKeys(obj);
+    return JSON.stringify(sorted);
+}
+function testVectors() {
+    return [
+        { input: { b: 2, a: 1 }, expected: '{"a":1,"b":2}' },
+        { input: { z: { b: 2, a: 1 }, a: 1 }, expected: '{"a":1,"z":{"a":1,"b":2}}' },
+        { input: [3, 1, 2], expected: '[3,1,2]' },
+        { input: { key: 'value\nwith"quotes' }, expected: '{"key":"value\\nwith\\"quotes"}' },
+        { input: { a: 1, b: null, c: 3 }, expected: '{"a":1,"b":null,"c":3}' },
+    ];
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":";;AAoBA,oCAGC;AAED,kCAQC;AAjCD,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACnD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrE,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAClD,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,YAAY,CAAC,GAAY;IACvC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,WAAW;IACzB,OAAO;QACL,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE;QACpD,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,2BAA2B,EAAE;QAC7E,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE;QACzC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,QAAQ,EAAE,iCAAiC,EAAE;QACrF,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE;KACvE,CAAC;AACJ,CAAC"}

package/dist/canonical.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/canonical.test.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const canonical_1 = require("./canonical");
+describe('Canonical JSON', () => {
+    it('should pass all test vectors', () => {
+        const vectors = (0, canonical_1.testVectors)();
+        for (const { input, expected } of vectors) {
+            const result = (0, canonical_1.canonicalize)(input);
+            expect(result).toBe(expected);
+        }
+    });
+    it('should sort object keys', () => {
+        const input = { z: 1, a: 2, m: 3 };
+        const result = (0, canonical_1.canonicalize)(input);
+        expect(result).toBe('{"a":2,"m":3,"z":1}');
+    });
+    it('should preserve array order', () => {
+        const input = { arr: [3, 1, 2] };
+        const result = (0, canonical_1.canonicalize)(input);
+        expect(result).toBe('{"arr":[3,1,2]}');
+    });
+    it('should handle nested objects', () => {
+        const input = { outer: { b: 2, a: 1 }, top: 0 };
+        const result = (0, canonical_1.canonicalize)(input);
+        expect(result).toBe('{"outer":{"a":1,"b":2},"top":0}');
+    });
+    it('should skip undefined values', () => {
+        const input = { a: 1, b: undefined, c: 3 };
+        const result = (0, canonical_1.canonicalize)(input);
+        expect(result).toBe('{"a":1,"c":3}');
+    });
+});
+//# sourceMappingURL=canonical.test.js.map

package/dist/canonical.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.test.js","sourceRoot":"","sources":["../src/canonical.test.ts"],"names":[],"mappings":";;AAAA,2CAAwD;AAExD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG,IAAA,uBAAW,GAAE,CAAC;QAE9B,KAAK,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAA4C,CAAC;QACrF,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/capability-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/capability-test.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const src_1 = require("./src");
+const crypto_1 = require("./src/crypto");
+const agent_id_1 = require("./src/agent-id");
+const crypto_2 = require("./src/crypto");
+const canonical_1 = require("./src/canonical");
+const envelope_1 = require("./src/envelope");
+const src_2 = require("./src");
+const capabilities_1 = require("./src/capabilities");
+async function run() {
+    console.log('═══════════════════════════════════════');
+    console.log('  ADP — 自定义 Capability 测试');
+    console.log('═══════════════════════════════════════\n');
+    const PORT_A = 9870;
+    const PORT_B = 9871;
+    const kpA = (0, crypto_1.generateKeyPair)();
+    const agentAId = (0, agent_id_1.buildAgentId)(kpA.publicKey, 'test.local', 'agenta');
+    console.log(`🔑  Agent A: ${agentAId.slice(0, 50)}...`);
+    const kpB = (0, crypto_1.generateKeyPair)();
+    const agentBId = (0, agent_id_1.buildAgentId)(kpB.publicKey, 'test.local', 'agentb');
+    console.log(`🔑  Agent B: ${agentBId.slice(0, 50)}...\n`);
+    let echoResult = null;
+    let chatResult = null;
+    const gA = new src_1.Gateway({
+        port: PORT_A, host: 'localhost',
+        secretKey: kpA.secretKey, agentId: agentAId,
+        displayName: 'Agent A', capabilities: [...src_2.STANDARD_CAPABILITIES],
+        skipVerification: false,
+    });
+    gA.registerCapability('custom:echo', (0, capabilities_1.createEchoHandler)(agentAId, kpA.secretKey));
+    gA.registerCapability('custom:chat', (0, capabilities_1.createChatHandler)(agentAId, kpA.secretKey));
+    const gB = new src_1.Gateway({
+        port: PORT_B, host: 'localhost',
+        secretKey: kpB.secretKey, agentId: agentBId,
+        displayName: 'Agent B', capabilities: [...src_2.STANDARD_CAPABILITIES],
+        skipVerification: false,
+    });
+    await sleep(300);
+    console.log('--- Test 1: custom:echo (Agent B → Agent A) ---\n');
+    const ws = await (0, src_1.connectToAgent)(agentAId, `localhost:${PORT_A}`, agentBId);
+    console.log('✅  Agent B connected to A\n');
+    ws.on('message', (raw) => {
+        const env = JSON.parse(raw.toString());
+        if (env.action === 'custom:echo') {
+            echoResult = env.params;
+        }
+        if (env.action === 'custom:chat') {
+            chatResult = env.params;
+        }
+    });
+    console.log('📤  Agent B → Agent A: custom:echo { word: "hello" }');
+    ws.send(JSON.stringify((0, crypto_2.signEnvelope)({
+        protocol: 'adp/0.2', id: (0, envelope_1.generateMessageId)(),
+        from: agentBId, to: agentAId,
+        action: 'custom:echo',
+        params: { word: 'hello' },
+        timestamp: new Date().toISOString(),
+    }, kpB.secretKey, canonical_1.canonicalize)));
+    await sleep(800);
+    console.log(`📩  Agent B received echo: ${JSON.stringify(echoResult)}`);
+    const echoPass = echoResult && echoResult.word === 'hello';
+    console.log(`   ${echoPass ? '✅ PASS' : '❌ FAIL — expected {word:"hello"}'}\n`);
+    console.log('--- Test 2: custom:chat (Agent B → Agent A) ---\n');
+    console.log('📤  Agent B → Agent A: custom:chat { text: "你好" }');
+    ws.send(JSON.stringify((0, crypto_2.signEnvelope)({
+        protocol: 'adp/0.2', id: (0, envelope_1.generateMessageId)(),
+        from: agentBId, to: agentAId,
+        action: 'custom:chat',
+        params: { text: '你好' },
+        timestamp: new Date().toISOString(),
+    }, kpB.secretKey, canonical_1.canonicalize)));
+    await sleep(800);
+    console.log(`📩  Agent B received chat ACK: ${JSON.stringify(chatResult)}`);
+    const chatPass = chatResult && chatResult.ok === true;
+    console.log(`   ${chatPass ? '✅ PASS' : '❌ FAIL — expected {ok:true}'}\n`);
+    console.log('--- Test 3: UNKNOWN_ACTION rejected ---\n');
+    echoResult = null;
+    ws.send(JSON.stringify((0, crypto_2.signEnvelope)({
+        protocol: 'adp/0.2', id: (0, envelope_1.generateMessageId)(),
+        from: agentBId, to: agentAId,
+        action: 'custom:nonexistent',
+        params: {},
+        timestamp: new Date().toISOString(),
+    }, kpB.secretKey, canonical_1.canonicalize)));
+    await sleep(800);
+    console.log(`   Agent B saw echo: ${echoResult === null ? 'no (correctly rejected)' : 'yes (UNEXPECTED)'}`);
+    console.log('\n═══════════════════════════════════════');
+    if (echoPass && chatPass) {
+        console.log('  ✅ 自定义 Capability 测试全部通过!');
+        console.log('  ✅ custom:echo — 原样返回');
+        console.log('  ✅ custom:chat — ACK ok');
+        console.log('  ✅ UNKNOWN_ACTION — 正确拒绝');
+    }
+    else {
+        console.log('  ❌ 部分测试失败');
+    }
+    console.log('═══════════════════════════════════════\n');
+    ws.close();
+    gA.close();
+    gB.close();
+    process.exit(0);
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+run().catch(err => { console.error('❌', err); process.exit(1); });
+//# sourceMappingURL=capability-test.js.map

package/dist/capability-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-test.js","sourceRoot":"","sources":["../capability-test.ts"],"names":[],"mappings":"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"}

package/dist/chat.d.ts

@@ -0,0 +1 @@
+export {};