adp-agent 0.2.0

package/dist/discovery.js

@@ -0,0 +1,291 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Discovery = void 0;
+exports.getSharedMdns = getSharedMdns;
+const os = __importStar(require("os"));
+const multicast_dns_1 = __importDefault(require("multicast-dns"));
+let sharedMdns = null;
+function getSharedMdns() {
+    if (!sharedMdns) {
+        sharedMdns = (0, multicast_dns_1.default)({ loopback: true });
+    }
+    return sharedMdns;
+}
+class Discovery {
+    constructor(agentId, port, callbacks = {}, mdnsInstance) {
+        this.peers = new Map();
+        this.announceTimer = null;
+        this.browseTimer = null;
+        this.staleTimer = null;
+        this.running = false;
+        this.agentId = agentId;
+        this.port = port;
+        this.callbacks = callbacks;
+        const shortId = agentId.split('@')[0].replace('adp://', '').slice(0, 12);
+        this.instanceName = `${shortId}._adp._tcp.local`;
+        this.hostname = `${shortId}.local`;
+        if (mdnsInstance) {
+            this.mdns = mdnsInstance;
+            this.ownsMdns = false;
+        }
+        else {
+            this.mdns = (0, multicast_dns_1.default)({ loopback: true });
+            this.ownsMdns = true;
+        }
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.mdns.on('query', (query) => {
+            for (const q of query.questions) {
+                if (q.type === 'PTR' && q.name === '_adp._tcp.local') {
+                    this.mdns.respond({
+                        answers: [{
+                                name: '_adp._tcp.local',
+                                type: 'PTR',
+                                ttl: 120,
+                                data: this.instanceName,
+                            }],
+                        additionals: [
+                            {
+                                name: this.instanceName,
+                                type: 'SRV',
+                                ttl: 120,
+                                data: { target: this.hostname, port: this.port },
+                            },
+                            {
+                                name: this.instanceName,
+                                type: 'TXT',
+                                ttl: 120,
+                                data: Buffer.from(`agent_id=${this.agentId}\x00protocol=adp/0.2`),
+                            },
+                            {
+                                name: this.hostname,
+                                type: 'A',
+                                ttl: 120,
+                                data: this.getLocalIP(),
+                            },
+                        ],
+                    });
+                }
+                if (q.type === 'SRV' && q.name === this.instanceName) {
+                    this.mdns.respond({
+                        answers: [{
+                                name: this.instanceName,
+                                type: 'SRV',
+                                ttl: 120,
+                                data: { target: this.hostname, port: this.port },
+                            }],
+                    });
+                }
+                if (q.type === 'TXT' && q.name === this.instanceName) {
+                    this.mdns.respond({
+                        answers: [{
+                                name: this.instanceName,
+                                type: 'TXT',
+                                ttl: 120,
+                                data: Buffer.from(`agent_id=${this.agentId}\x00protocol=adp/0.2`),
+                            }],
+                    });
+                }
+                if ((q.type === 'A' || q.type === 'AAAA') && q.name === this.hostname) {
+                    this.mdns.respond({
+                        answers: [{
+                                name: this.hostname,
+                                type: 'A',
+                                ttl: 120,
+                                data: this.getLocalIP(),
+                            }],
+                    });
+                }
+            }
+        });
+        this.mdns.on('response', (response) => {
+            const srvRecords = {};
+            const txtRecords = {};
+            const allRecords = [
+                ...(response.answers || []),
+                ...(response.additionals || []),
+            ];
+            for (const a of allRecords) {
+                if (a.type === 'SRV' && typeof a.data === 'object') {
+                    srvRecords[a.name] = a.data;
+                }
+                if (a.type === 'TXT') {
+                    if (Buffer.isBuffer(a.data)) {
+                        txtRecords[a.name] = a.data;
+                    }
+                    else if (Array.isArray(a.data) && a.data.length > 0) {
+                        try {
+                            txtRecords[a.name] = Buffer.concat(a.data.map(b => Buffer.isBuffer(b) ? b : Buffer.from(b)));
+                        }
+                        catch { }
+                    }
+                }
+            }
+            for (const a of response.answers) {
+                if (a.type === 'PTR' && a.name === '_adp._tcp.local') {
+                    const instanceName = a.data;
+                    if (instanceName === this.instanceName)
+                        continue;
+                    const srv = srvRecords[instanceName];
+                    const txtBuf = txtRecords[instanceName];
+                    if (srv && txtBuf) {
+                        const txt = this.parseTXT(txtBuf);
+                        if (txt.agent_id) {
+                            const peer = {
+                                agentId: txt.agent_id,
+                                host: srv.target,
+                                port: srv.port,
+                                protocol: txt.protocol || 'adp/0.2',
+                                lastSeen: Date.now(),
+                            };
+                            const existing = this.peers.get(txt.agent_id);
+                            this.peers.set(txt.agent_id, peer);
+                            if (!existing) {
+                                this.callbacks.onPeerDiscovered?.(peer);
+                            }
+                        }
+                    }
+                }
+            }
+        });
+        this.proactiveAnnounce();
+        this.announceTimer = setInterval(() => this.proactiveAnnounce(), 60000);
+        this.browseTimer = setInterval(() => this.browse(), 30000);
+        this.staleTimer = setInterval(() => this.cleanStale(), 30000);
+        this.browse();
+    }
+    proactiveAnnounce() {
+        this.mdns.respond({
+            answers: [
+                {
+                    name: '_adp._tcp.local',
+                    type: 'PTR',
+                    ttl: 120,
+                    data: this.instanceName,
+                },
+                {
+                    name: this.instanceName,
+                    type: 'SRV',
+                    ttl: 120,
+                    data: { target: this.hostname, port: this.port },
+                },
+                {
+                    name: this.instanceName,
+                    type: 'TXT',
+                    ttl: 120,
+                    data: Buffer.from(`agent_id=${this.agentId}\x00protocol=adp/0.2`),
+                },
+                {
+                    name: this.hostname,
+                    type: 'A',
+                    ttl: 120,
+                    data: this.getLocalIP(),
+                },
+            ],
+        });
+    }
+    browse() {
+        this.mdns.query({
+            questions: [{ name: '_adp._tcp.local', type: 'PTR' }],
+        });
+    }
+    cleanStale() {
+        const now = Date.now();
+        for (const [id, peer] of this.peers) {
+            if (now - peer.lastSeen > 120000) {
+                this.peers.delete(id);
+                this.callbacks.onPeerLost?.(id);
+            }
+        }
+    }
+    parseTXT(buf) {
+        const result = {};
+        const text = buf.toString();
+        for (const kv of text.split('\x00')) {
+            const eq = kv.indexOf('=');
+            if (eq > 0) {
+                result[kv.slice(0, eq)] = kv.slice(eq + 1);
+            }
+        }
+        return result;
+    }
+    getLocalIP() {
+        const nets = os.networkInterfaces();
+        for (const iface of Object.values(nets)) {
+            if (!iface)
+                continue;
+            for (const addr of iface) {
+                if (addr.family === 'IPv4' && !addr.internal) {
+                    return addr.address;
+                }
+            }
+        }
+        return '127.0.0.1';
+    }
+    getPeers() {
+        return Array.from(this.peers.values());
+    }
+    shutdown() {
+        this.running = false;
+        if (this.announceTimer)
+            clearInterval(this.announceTimer);
+        if (this.browseTimer)
+            clearInterval(this.browseTimer);
+        if (this.staleTimer)
+            clearInterval(this.staleTimer);
+        this.mdns.respond({
+            answers: [
+                { name: '_adp._tcp.local', type: 'PTR', ttl: 0, data: this.instanceName },
+                { name: this.instanceName, type: 'SRV', ttl: 0, data: { target: this.hostname, port: this.port } },
+                { name: this.instanceName, type: 'TXT', ttl: 0, data: Buffer.from('') },
+            ],
+            additionals: [
+                { name: this.hostname, type: 'A', ttl: 0, data: this.getLocalIP() },
+            ],
+        });
+        if (this.ownsMdns) {
+            setTimeout(() => this.mdns.destroy(), 500);
+        }
+    }
+}
+exports.Discovery = Discovery;
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/envelope.d.ts

@@ -0,0 +1,42 @@
+import { TrustStore } from './trust-store';
+export interface Envelope {
+    protocol: string;
+    id: string;
+    from: string;
+    to: string;
+    action: string;
+    params: unknown;
+    timestamp: string;
+    sig: string;
+    reply_to?: string;
+    error?: {
+        code: string;
+        message: string;
+        data?: unknown;
+    };
+    trace_id?: string;
+    span_id?: string;
+    encoding?: string;
+    expires_at?: string;
+}
+export interface VerificationResult {
+    valid: boolean;
+    error?: string;
+    message?: string;
+}
+export declare class MessageVerifier {
+    private trustStore;
+    constructor(trustStore: TrustStore);
+    verify(envelope: Envelope): Promise<VerificationResult>;
+}
+export declare function generateMessageId(): string;
+export declare function buildEnvelope(from: string, to: string, action: string, params?: unknown, options?: {
+    reply_to?: string;
+    error?: {
+        code: string;
+        message: string;
+        data?: unknown;
+    };
+    trace_id?: string;
+    span_id?: string;
+}): Omit<Envelope, 'sig'>;

package/dist/envelope.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageVerifier = void 0;
+exports.generateMessageId = generateMessageId;
+exports.buildEnvelope = buildEnvelope;
+const crypto_1 = require("./crypto");
+const canonical_1 = require("./canonical");
+const agent_id_1 = require("./agent-id");
+const TIMESTAMP_TOLERANCE_MS = 300000;
+class MessageVerifier {
+    constructor(trustStore) {
+        this.trustStore = trustStore;
+    }
+    async verify(envelope) {
+        if (!envelope.sig) {
+            return { valid: false, error: 'INVALID_SIGNATURE', message: 'Signature missing' };
+        }
+        const sigBytes = (0, crypto_1.decodeBase64URL)(envelope.sig);
+        if (sigBytes.length !== 64) {
+            return { valid: false, error: 'INVALID_SIGNATURE', message: 'Invalid signature length' };
+        }
+        const timestamp = new Date(envelope.timestamp).getTime();
+        const now = Date.now();
+        if (Math.abs(now - timestamp) > TIMESTAMP_TOLERANCE_MS) {
+            return { valid: false, error: 'INVALID_PARAMS', message: 'Timestamp too old or in future' };
+        }
+        const publicKey = (0, agent_id_1.extractPublicKey)(envelope.from);
+        if (!this.trustStore.has(envelope.from)) {
+            this.trustStore.pin(envelope.from, publicKey, 'tofu');
+        }
+        const { sig, ...unsigned } = envelope;
+        const canonical = (0, canonical_1.canonicalize)(unsigned);
+        const messageBytes = new TextEncoder().encode(canonical);
+        const isValid = (0, crypto_1.verify)(publicKey, messageBytes, sigBytes);
+        if (isValid) {
+            this.trustStore.updateLastVerified(envelope.from);
+            return { valid: true };
+        }
+        return { valid: false, error: 'INVALID_SIGNATURE', message: 'Signature verification failed' };
+    }
+}
+exports.MessageVerifier = MessageVerifier;
+function generateMessageId() {
+    return 'msg_' + Math.random().toString(36).slice(2, 10);
+}
+function buildEnvelope(from, to, action, params = {}, options) {
+    return {
+        protocol: 'adp/0.2',
+        id: generateMessageId(),
+        from,
+        to,
+        action,
+        params,
+        timestamp: new Date().toISOString(),
+        ...options,
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":";;;AAsEA,8CAEC;AAED,sCAsBC;AAhGD,qCAAmD;AACnD,2CAA2C;AAC3C,yCAA8C;AA0B9C,MAAM,sBAAsB,GAAG,MAAO,CAAC;AAEvC,MAAa,eAAe;IAC1B,YAAoB,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAE9C,KAAK,CAAC,MAAM,CAAC,QAAkB;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,wBAAe,EAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;QAC3F,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,sBAAsB,EAAE,CAAC;YACvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;QAC9F,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,2BAAgB,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC;QACtC,MAAM,SAAS,GAAG,IAAA,wBAAY,EAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,IAAA,eAAM,EAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QAE1D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAChG,CAAC;CACF;AAtCD,0CAsCC;AAED,SAAgB,iBAAiB;IAC/B,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,aAAa,CAC3B,IAAY,EACZ,EAAU,EACV,MAAc,EACd,SAAkB,EAAE,EACpB,OAKC;IAED,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,EAAE,EAAE,iBAAiB,EAAE;QACvB,IAAI;QACJ,EAAE;QACF,MAAM;QACN,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,OAAO;KACX,CAAC;AACJ,CAAC"}

package/dist/gateway.d.ts

@@ -0,0 +1,44 @@
+import { WebSocket } from 'ws';
+import { Manifest, Capability, Route } from './manifest';
+export interface GatewayOptions {
+    host?: string;
+    port: number;
+    path?: string;
+    secretKey: Uint8Array;
+    agentId: string;
+    displayName: string;
+    capabilities: (string | Capability)[];
+    routes?: Route[];
+    tls?: {
+        cert: string;
+        key: string;
+    };
+    skipVerification?: boolean;
+}
+export declare class Gateway {
+    private server;
+    private wss;
+    private secretKey;
+    private agentId;
+    private manifest;
+    private trustStore;
+    private verifier;
+    private messageIdCache;
+    private skipVerification;
+    constructor(options: GatewayOptions);
+    private handleConnection;
+    private processMessage;
+    private handleMessage;
+    private handlePing;
+    private handleCapabilityQuery;
+    private handleInfo;
+    private sendError;
+    private signAndBuildEnvelope;
+    getManifest(): Manifest;
+    getAgentId(): string;
+    processRelayMessage(rawEnvelope: unknown): Promise<void>;
+    private processMessageDirect;
+    private handleMessageDirect;
+    close(): void;
+}
+export declare function connectToAgent(agentId: string, address: string, localAgentId: string): Promise<WebSocket>;