adp-agent 0.2.0

package/dist/relay.js

@@ -0,0 +1,277 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelayClient = exports.Relay = void 0;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+const ws_1 = require("ws");
+class Relay {
+    constructor(options) {
+        this.sessions = new Map();
+        this.agentSessions = new Map();
+        this.offlineCache = [];
+        this.heartbeatTimer = null;
+        this.maxConnections = options.maxConnections ?? 10000;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? 15000;
+        this.heartbeatTimeoutMs = options.heartbeatTimeoutMs ?? 45000;
+        this.offlineMaxAgeMs = options.offlineMaxAgeMs ?? 24 * 60 * 60 * 1000;
+        this.offlineMaxPerAgent = options.offlineMaxPerAgent ?? 500;
+        if (options.tls) {
+            this.server = https.createServer({ cert: options.tls.cert, key: options.tls.key });
+        }
+        else {
+            this.server = http.createServer();
+        }
+        this.server.on('request', (_req, res) => {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                status: 'ok',
+                sessions: this.sessions.size,
+                cached: this.offlineCache.length,
+            }));
+        });
+        this.wss = new ws_1.WebSocketServer({ server: this.server, path: '/adp/relay' });
+        this.wss.on('connection', (ws, req) => this.handleConnection(ws, req));
+        this.server.listen(options.port, options.host);
+        this.startHeartbeat();
+    }
+    handleConnection(ws, req) {
+        const url = new URL(req.url || '/', `http://localhost`);
+        const agentId = url.searchParams.get('agent_id') || '';
+        if (this.sessions.size >= this.maxConnections) {
+            ws.send(JSON.stringify({ type: 'busy' }));
+            ws.close();
+            return;
+        }
+        const sessionId = 'sess_' + Math.random().toString(36).slice(2, 10);
+        const now = Date.now();
+        const session = { ws, agentId, connectedAt: now, lastHeartbeat: now };
+        this.sessions.set(sessionId, session);
+        if (!this.agentSessions.has(agentId)) {
+            this.agentSessions.set(agentId, new Set());
+        }
+        this.agentSessions.get(agentId).add(sessionId);
+        ws.send(JSON.stringify({ type: 'welcome', session_id: sessionId }));
+        this.deliverOfflineMessages(agentId, sessionId);
+        ws.on('message', (data) => this.handleMessage(sessionId, agentId, data));
+        ws.on('close', () => {
+            this.sessions.delete(sessionId);
+            const set = this.agentSessions.get(agentId);
+            if (set) {
+                set.delete(sessionId);
+                if (set.size === 0)
+                    this.agentSessions.delete(agentId);
+            }
+        });
+        ws.on('error', () => { });
+    }
+    handleMessage(sessionId, fromAgentId, data) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        try {
+            const msg = JSON.parse(data);
+            if (msg.type === 'pong') {
+                session.lastHeartbeat = Date.now();
+                return;
+            }
+            if (msg.type === 'relay' && msg.to && msg.payload) {
+                const targetSessions = this.agentSessions.get(msg.to);
+                if (targetSessions && targetSessions.size > 0) {
+                    for (const targetSessionId of targetSessions) {
+                        const target = this.sessions.get(targetSessionId);
+                        if (target && target.ws.readyState === ws_1.WebSocket.OPEN) {
+                            target.ws.send(JSON.stringify(msg.payload));
+                        }
+                    }
+                }
+                else {
+                    this.cacheMessage(fromAgentId, msg.to, msg.payload);
+                }
+                return;
+            }
+        }
+        catch {
+        }
+    }
+    cacheMessage(from, to, payload) {
+        this.offlineCache.push({ to, payload, storedAt: Date.now() });
+        const perAgent = this.offlineCache.filter(m => m.to === to);
+        while (perAgent.length > this.offlineMaxPerAgent) {
+            const oldest = this.offlineCache.findIndex(m => m.to === to);
+            if (oldest >= 0)
+                this.offlineCache.splice(oldest, 1);
+        }
+    }
+    deliverOfflineMessages(agentId, sessionId) {
+        const now = Date.now();
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        const pending = this.offlineCache.filter(m => m.to === agentId && (now - m.storedAt) < this.offlineMaxAgeMs);
+        for (const msg of pending) {
+            if (session.ws.readyState === ws_1.WebSocket.OPEN) {
+                session.ws.send(JSON.stringify(msg.payload));
+            }
+        }
+        this.offlineCache = this.offlineCache.filter(m => m.to !== agentId);
+    }
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => {
+            const now = Date.now();
+            for (const [id, session] of this.sessions) {
+                if (now - session.lastHeartbeat > this.heartbeatTimeoutMs) {
+                    session.ws.close();
+                    this.sessions.delete(id);
+                    continue;
+                }
+                if (session.ws.readyState === ws_1.WebSocket.OPEN) {
+                    session.ws.ping();
+                }
+            }
+            this.offlineCache = this.offlineCache.filter(m => now - m.storedAt < this.offlineMaxAgeMs);
+        }, this.heartbeatIntervalMs);
+    }
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    close() {
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        this.wss.close();
+        this.server.close();
+    }
+}
+exports.Relay = Relay;
+class RelayClient {
+    constructor(relayUrl, agentId, callbacks, options) {
+        this.ws = null;
+        this.heartbeatTimer = null;
+        this.relayUrl = relayUrl;
+        this.agentId = agentId;
+        this.callbacks = callbacks;
+        this.reconnect = options?.reconnect ?? true;
+        this.heartbeatIntervalMs = options?.heartbeatIntervalMs ?? 15000;
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            const url = `${this.relayUrl}?agent_id=${encodeURIComponent(this.agentId)}`;
+            const ws = new ws_1.WebSocket(url);
+            this.ws = ws;
+            const timeout = setTimeout(() => {
+                reject(new Error('Relay connection timeout'));
+            }, 10000);
+            ws.on('open', () => {
+                clearTimeout(timeout);
+            });
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if (msg.type === 'welcome') {
+                        clearTimeout(timeout);
+                        this.callbacks.onWelcome?.(msg.session_id);
+                        this.startHeartbeat();
+                        resolve();
+                        return;
+                    }
+                    if (msg.type === 'busy') {
+                        clearTimeout(timeout);
+                        this.callbacks.onBusy?.();
+                        ws.close();
+                        reject(new Error('Relay busy'));
+                        return;
+                    }
+                    if (msg.type === 'ping') {
+                        ws.send(JSON.stringify({ type: 'pong' }));
+                        return;
+                    }
+                    if (msg.type === 'pong') {
+                        return;
+                    }
+                    this.callbacks.onMessage?.(msg);
+                }
+                catch {
+                }
+            });
+            ws.on('close', () => {
+                this.stopHeartbeat();
+                this.callbacks.onClose?.();
+                if (this.reconnect && this.ws === ws) {
+                    setTimeout(() => this.reconnectToRelay(), 3000);
+                }
+            });
+            ws.on('error', () => { });
+        });
+    }
+    send(to, envelope) {
+        if (this.ws && this.ws.readyState === ws_1.WebSocket.OPEN) {
+            this.ws.send(JSON.stringify({ type: 'relay', to, payload: envelope }));
+        }
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            if (this.ws && this.ws.readyState === ws_1.WebSocket.OPEN) {
+                this.ws.ping();
+            }
+        }, this.heartbeatIntervalMs);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    async reconnectToRelay() {
+        try {
+            await this.connect();
+        }
+        catch {
+        }
+    }
+    isConnected() {
+        return this.ws !== null && this.ws.readyState === ws_1.WebSocket.OPEN;
+    }
+    close() {
+        this.reconnect = false;
+        this.stopHeartbeat();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+}
+exports.RelayClient = RelayClient;
+//# sourceMappingURL=relay.js.map

package/dist/relay.js.map

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

package/dist/src/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/src/agent-id.js

@@ -0,0 +1,44 @@
+"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");
+const crypto_2 = 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 = (0, crypto_2.createHash)('blake2b512').update(publicKey).digest().slice(0, 6);
+    return (0, crypto_1.encodeBase64URL)(hash);
+}
+//# sourceMappingURL=agent-id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.js","sourceRoot":"","sources":["../../src/agent-id.ts"],"names":[],"mappings":";;AASA,oCA0BC;AAED,oCAMC;AAED,4CAEC;AAED,8CAGC;AApDD,qCAA4D;AAC5D,mCAAoC;AAQpC,SAAgB,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;IAErD,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,SAAS,GAAG,IAAA,wBAAe,EAAC,YAAY,CAAC,CAAC;IAChD,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IACxH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC7C,CAAC;AAED,SAAgB,YAAY,CAAC,SAAqB,EAAE,SAAiB,EAAE,SAAiB;IACtF,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,YAAY,GAAG,IAAA,wBAAe,EAAC,SAAS,CAAC,CAAC;IAChD,OAAO,SAAS,YAAY,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;AAC3D,CAAC;AAED,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,SAAgB,iBAAiB,CAAC,SAAqB;IACrD,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,YAAY,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,IAAA,wBAAe,EAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

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

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

package/dist/src/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/src/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/src/canonical.d.ts

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

package/dist/src/canonical.js

@@ -0,0 +1,37 @@
+"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 (typeof obj === 'object' && obj !== null) {
+        const sorted = {};
+        const keys = Object.keys(obj).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+        for (const key of keys) {
+            const value = obj[key];
+            // undefined values are stripped for canonical consistency —
+            // {a: undefined, b:1} and {b:1} MUST produce the same signature.
+            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/src/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/canonical.ts"],"names":[],"mappings":";;AAsBA,oCAGC;AAED,kCAQC;AAnCD,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,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,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,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3B,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;YACpD,4DAA4D;YAC5D,iEAAiE;YACjE,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/src/canonical.test.d.ts

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

package/dist/src/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/src/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/src/capabilities.d.ts

@@ -0,0 +1,3 @@
+import { ActionHandler } from './gateway';
+export declare function createEchoHandler(agentId: string, secretKey: Uint8Array): ActionHandler;
+export declare function createChatHandler(agentId: string, secretKey: Uint8Array, onMessage?: (from: string, text: string) => void): ActionHandler;

package/dist/src/capabilities.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEchoHandler = createEchoHandler;
+exports.createChatHandler = createChatHandler;
+const crypto_1 = require("./crypto");
+const canonical_1 = require("./canonical");
+const envelope_1 = require("./envelope");
+function createEchoHandler(agentId, secretKey) {
+    return async (ws, envelope) => {
+        const reply = (0, crypto_1.signEnvelope)({
+            protocol: 'adp/0.2',
+            id: (0, envelope_1.generateMessageId)(),
+            from: agentId,
+            to: envelope.from,
+            action: 'custom:echo',
+            params: envelope.params,
+            timestamp: new Date().toISOString(),
+        }, secretKey, canonical_1.canonicalize);
+        ws.send(JSON.stringify(reply));
+    };
+}
+function createChatHandler(agentId, secretKey, onMessage) {
+    return async (ws, envelope) => {
+        const params = envelope.params;
+        const text = params.text || '';
+        onMessage?.(envelope.from, text);
+        const reply = (0, crypto_1.signEnvelope)({
+            protocol: 'adp/0.2',
+            id: (0, envelope_1.generateMessageId)(),
+            from: agentId,
+            to: envelope.from,
+            action: 'custom:chat',
+            params: { ok: true },
+            timestamp: new Date().toISOString(),
+        }, secretKey, canonical_1.canonicalize);
+        ws.send(JSON.stringify(reply));
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/src/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/capabilities.ts"],"names":[],"mappings":";;AAOA,8CAcC;AAED,8CAuBC;AA5CD,qCAAwC;AACxC,2CAA2C;AAC3C,yCAA+C;AAG/C,SAAgB,iBAAiB,CAAC,OAAe,EAAE,SAAqB;IACtE,OAAO,KAAK,EAAE,EAAa,EAAE,QAAkB,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,IAAA,qBAAY,EAAC;YACzB,QAAQ,EAAE,SAAS;YACnB,EAAE,EAAE,IAAA,4BAAiB,GAAE;YACvB,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,QAAQ,CAAC,IAAI;YACjB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,EAAE,SAAS,EAAE,wBAAY,CAAC,CAAC;QAE5B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,OAAe,EACf,SAAqB,EACrB,SAAgD;IAEhD,OAAO,KAAK,EAAE,EAAa,EAAE,QAAkB,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAA2B,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAE/B,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEjC,MAAM,KAAK,GAAG,IAAA,qBAAY,EAAC;YACzB,QAAQ,EAAE,SAAS;YACnB,EAAE,EAAE,IAAA,4BAAiB,GAAE;YACvB,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,QAAQ,CAAC,IAAI;YACjB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,EAAE,SAAS,EAAE,wBAAY,CAAC,CAAC;QAE5B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,35 @@
+import { Capability, Route } from './manifest';
+export interface RetryConfig {
+    maxAttempts: number;
+    backoffMs: number;
+}
+export interface WebhookConfig {
+    enabled: boolean;
+    url: string;
+    secret: string;
+    timeout?: number;
+    retry?: RetryConfig;
+}
+export interface CommunicationConfig {
+    mode: 'websocket' | 'webhook' | 'hybrid';
+    webhook?: WebhookConfig;
+}
+export interface AgentConfig {
+    agentId: string;
+    displayName: string;
+    capabilities: (string | Capability)[];
+    routes?: Route[];
+    communication?: CommunicationConfig;
+    description?: string;
+}
+export interface GatewayConfig extends AgentConfig {
+    port: number;
+    host?: string;
+    secretKey: Uint8Array;
+    tls?: {
+        cert: string;
+        key: string;
+    };
+    skipVerification?: boolean;
+    tofuEnabled?: boolean;
+}

package/dist/src/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":""}

package/dist/src/contacts.d.ts

@@ -0,0 +1,28 @@
+import { Route } from './manifest';
+import { TrustStore } from './trust-store';
+export interface ContactEntry {
+    routes: Route[];
+    trust?: 'pinned';
+    public_key?: string;
+}
+export interface ContactsData {
+    [agentId: string]: ContactEntry;
+}
+export declare class ContactStore {
+    private data;
+    private filePath;
+    constructor(filePath?: string);
+    load(): Promise<void>;
+    save(): Promise<void>;
+    getRoutes(agentId: string): Route[] | null;
+    isPinned(agentId: string): Uint8Array | null;
+    set(agentId: string, entry: ContactEntry): void;
+    remove(agentId: string): void;
+    has(agentId: string): boolean;
+    getAll(): ContactsData;
+    listAgentIds(): string[];
+    pinTrustedKeys(trustStore: TrustStore): {
+        pinned: string[];
+        conflicts: string[];
+    };
+}