@rookdaemon/agora 0.1.0

package/dist/message/envelope.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Message types on the Agora network.
+ * Every piece of data flowing between agents is wrapped in an envelope.
+ */
+export type MessageType = 'announce' | 'discover' | 'request' | 'response' | 'publish' | 'subscribe' | 'verify' | 'ack' | 'error';
+/**
+ * The signed envelope that wraps every message on the network.
+ * Content-addressed: the ID is the hash of the canonical payload.
+ * Signed: every envelope carries a signature from the sender's private key.
+ */
+export interface Envelope<T = unknown> {
+    /** Content-addressed ID: SHA-256 hash of canonical payload */
+    id: string;
+    /** Message type */
+    type: MessageType;
+    /** Sender's public key (hex-encoded ed25519) */
+    sender: string;
+    /** Unix timestamp (ms) when the message was created */
+    timestamp: number;
+    /** Optional: ID of the message this is responding to */
+    inReplyTo?: string;
+    /** The actual payload */
+    payload: T;
+    /** ed25519 signature over the canonical form (hex-encoded) */
+    signature: string;
+}
+/**
+ * Canonical form of an envelope for signing/hashing.
+ * Deterministic JSON serialization: recursively sorted keys, no whitespace.
+ */
+export declare function canonicalize(type: MessageType, sender: string, timestamp: number, payload: unknown, inReplyTo?: string): string;
+/**
+ * Compute the content-addressed ID for a message.
+ */
+export declare function computeId(canonical: string): string;
+/**
+ * Create a signed envelope.
+ * @param type - Message type
+ * @param sender - Sender's public key (hex)
+ * @param privateKey - Sender's private key (hex) for signing
+ * @param payload - The message payload
+ * @param inReplyTo - Optional ID of the message being replied to
+ * @returns A signed Envelope
+ */
+export declare function createEnvelope<T>(type: MessageType, sender: string, privateKey: string, payload: T, inReplyTo?: string): Envelope<T>;
+/**
+ * Verify an envelope's integrity and authenticity.
+ * Checks:
+ * 1. Canonical form matches the ID (content-addressing)
+ * 2. Signature is valid for the sender's public key
+ *
+ * @returns Object with `valid` boolean and optional `reason` for failure
+ */
+export declare function verifyEnvelope(envelope: Envelope): {
+    valid: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/message/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/message/envelope.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,GACR,KAAK,GACL,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/H;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,EACV,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAAC,CAAC,CAAC,CAeb;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAmBtF"}

package/dist/message/envelope.js

@@ -0,0 +1,83 @@
+import { createHash } from 'node:crypto';
+import { signMessage, verifySignature } from '../identity/keypair.js';
+/**
+ * Deterministic JSON serialization with recursively sorted keys.
+ */
+function stableStringify(value) {
+    if (value === null || value === undefined)
+        return JSON.stringify(value);
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return '[' + value.map(stableStringify).join(',') + ']';
+    }
+    const keys = Object.keys(value).sort();
+    const pairs = keys.map(k => JSON.stringify(k) + ':' + stableStringify(value[k]));
+    return '{' + pairs.join(',') + '}';
+}
+/**
+ * Canonical form of an envelope for signing/hashing.
+ * Deterministic JSON serialization: recursively sorted keys, no whitespace.
+ */
+export function canonicalize(type, sender, timestamp, payload, inReplyTo) {
+    const obj = { payload, sender, timestamp, type };
+    if (inReplyTo !== undefined) {
+        obj.inReplyTo = inReplyTo;
+    }
+    return stableStringify(obj);
+}
+/**
+ * Compute the content-addressed ID for a message.
+ */
+export function computeId(canonical) {
+    return createHash('sha256').update(canonical).digest('hex');
+}
+/**
+ * Create a signed envelope.
+ * @param type - Message type
+ * @param sender - Sender's public key (hex)
+ * @param privateKey - Sender's private key (hex) for signing
+ * @param payload - The message payload
+ * @param inReplyTo - Optional ID of the message being replied to
+ * @returns A signed Envelope
+ */
+export function createEnvelope(type, sender, privateKey, payload, inReplyTo) {
+    const timestamp = Date.now();
+    const canonical = canonicalize(type, sender, timestamp, payload, inReplyTo);
+    const id = computeId(canonical);
+    const signature = signMessage(canonical, privateKey);
+    return {
+        id,
+        type,
+        sender,
+        timestamp,
+        ...(inReplyTo !== undefined ? { inReplyTo } : {}),
+        payload,
+        signature,
+    };
+}
+/**
+ * Verify an envelope's integrity and authenticity.
+ * Checks:
+ * 1. Canonical form matches the ID (content-addressing)
+ * 2. Signature is valid for the sender's public key
+ *
+ * @returns Object with `valid` boolean and optional `reason` for failure
+ */
+export function verifyEnvelope(envelope) {
+    const { id, type, sender, timestamp, payload, signature, inReplyTo } = envelope;
+    // Reconstruct canonical form
+    const canonical = canonicalize(type, sender, timestamp, payload, inReplyTo);
+    // Check content-addressed ID
+    const expectedId = computeId(canonical);
+    if (id !== expectedId) {
+        return { valid: false, reason: 'id_mismatch' };
+    }
+    // Check signature
+    const sigValid = verifySignature(canonical, signature, sender);
+    if (!sigValid) {
+        return { valid: false, reason: 'signature_invalid' };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/message/envelope.js.map

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

package/dist/registry/capability.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A capability describes something an agent can do
+ */
+export interface Capability {
+    /** Unique ID (content-addressed hash of name + version + schema) */
+    id: string;
+    /** Human-readable name: 'code-review', 'summarization', 'translation' */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** What the capability does */
+    description: string;
+    /** JSON Schema for expected input */
+    inputSchema?: object;
+    /** JSON Schema for expected output */
+    outputSchema?: object;
+    /** Discovery tags: ['code', 'typescript', 'review'] */
+    tags: string[];
+}
+/**
+ * Creates a capability with a content-addressed ID.
+ *
+ * @param name - Human-readable capability name
+ * @param version - Semantic version string
+ * @param description - Description of what the capability does
+ * @param options - Optional input/output schemas and tags
+ * @returns A Capability object with computed ID
+ */
+export declare function createCapability(name: string, version: string, description: string, options?: {
+    inputSchema?: object;
+    outputSchema?: object;
+    tags?: string[];
+}): Capability;
+/**
+ * Validates that a capability has all required fields.
+ *
+ * @param capability - The capability to validate
+ * @returns Object with `valid` boolean and optional `errors` array
+ */
+export declare function validateCapability(capability: unknown): {
+    valid: boolean;
+    errors?: string[];
+};
+//# sourceMappingURL=capability.d.ts.map

package/dist/registry/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/registry/capability.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACZ,GACL,UAAU,CAcZ;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA4C7F"}

package/dist/registry/capability.js

@@ -0,0 +1,94 @@
+import { createHash } from 'node:crypto';
+/**
+ * Deterministic JSON serialization for capability hashing.
+ * Recursively sorts object keys.
+ */
+function stableStringify(value) {
+    if (value === null || value === undefined)
+        return JSON.stringify(value);
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return '[' + value.map(stableStringify).join(',') + ']';
+    }
+    const keys = Object.keys(value).sort();
+    const pairs = keys.map(k => JSON.stringify(k) + ':' + stableStringify(value[k]));
+    return '{' + pairs.join(',') + '}';
+}
+/**
+ * Compute content-addressed ID for a capability based on name, version, and schemas.
+ */
+function computeCapabilityId(name, version, inputSchema, outputSchema) {
+    const data = {
+        name,
+        version,
+        ...(inputSchema !== undefined ? { inputSchema } : {}),
+        ...(outputSchema !== undefined ? { outputSchema } : {}),
+    };
+    const canonical = stableStringify(data);
+    return createHash('sha256').update(canonical).digest('hex');
+}
+/**
+ * Creates a capability with a content-addressed ID.
+ *
+ * @param name - Human-readable capability name
+ * @param version - Semantic version string
+ * @param description - Description of what the capability does
+ * @param options - Optional input/output schemas and tags
+ * @returns A Capability object with computed ID
+ */
+export function createCapability(name, version, description, options = {}) {
+    const { inputSchema, outputSchema, tags = [] } = options;
+    const id = computeCapabilityId(name, version, inputSchema, outputSchema);
+    return {
+        id,
+        name,
+        version,
+        description,
+        ...(inputSchema !== undefined ? { inputSchema } : {}),
+        ...(outputSchema !== undefined ? { outputSchema } : {}),
+        tags,
+    };
+}
+/**
+ * Validates that a capability has all required fields.
+ *
+ * @param capability - The capability to validate
+ * @returns Object with `valid` boolean and optional `errors` array
+ */
+export function validateCapability(capability) {
+    const errors = [];
+    if (!capability || typeof capability !== 'object') {
+        return { valid: false, errors: ['Capability must be an object'] };
+    }
+    const cap = capability;
+    if (!cap.id || typeof cap.id !== 'string') {
+        errors.push('Missing or invalid field: id (must be a string)');
+    }
+    if (!cap.name || typeof cap.name !== 'string') {
+        errors.push('Missing or invalid field: name (must be a string)');
+    }
+    if (!cap.version || typeof cap.version !== 'string') {
+        errors.push('Missing or invalid field: version (must be a string)');
+    }
+    if (!cap.description || typeof cap.description !== 'string') {
+        errors.push('Missing or invalid field: description (must be a string)');
+    }
+    if (!Array.isArray(cap.tags)) {
+        errors.push('Missing or invalid field: tags (must be an array)');
+    }
+    else if (!cap.tags.every(tag => typeof tag === 'string')) {
+        errors.push('Invalid field: tags (all elements must be strings)');
+    }
+    if (cap.inputSchema !== undefined && (typeof cap.inputSchema !== 'object' || cap.inputSchema === null)) {
+        errors.push('Invalid field: inputSchema (must be an object)');
+    }
+    if (cap.outputSchema !== undefined && (typeof cap.outputSchema !== 'object' || cap.outputSchema === null)) {
+        errors.push('Invalid field: outputSchema (must be an object)');
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=capability.js.map

package/dist/registry/capability.js.map

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

package/dist/registry/messages.d.ts

@@ -0,0 +1,50 @@
+import type { Capability } from './capability.js';
+/**
+ * Payload for 'announce' messages.
+ * An agent publishes its capabilities and metadata to the network.
+ */
+export interface AnnouncePayload {
+    /** Capabilities this agent offers */
+    capabilities: Capability[];
+    /** Optional metadata about the agent */
+    metadata?: {
+        /** Human-readable agent name */
+        name?: string;
+        /** Agent software version */
+        version?: string;
+    };
+}
+/**
+ * Payload for 'discover' messages.
+ * An agent queries the network to find peers with specific capabilities.
+ */
+export interface DiscoverPayload {
+    /** Query parameters for discovery */
+    query: {
+        /** Filter by capability name */
+        capabilityName?: string;
+        /** Filter by capability tag */
+        tag?: string;
+    };
+}
+/**
+ * Payload for responses to 'discover' messages.
+ * Returns a list of peers matching the discovery query.
+ */
+export interface DiscoverResponsePayload {
+    /** Peers matching the discovery query */
+    peers: Array<{
+        /** Public key of the peer */
+        publicKey: string;
+        /** Capabilities the peer offers */
+        capabilities: Capability[];
+        /** Optional metadata about the peer */
+        metadata?: {
+            /** Human-readable peer name */
+            name?: string;
+            /** Peer software version */
+            version?: string;
+        };
+    }>;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/registry/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/registry/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,EAAE;QACT,gCAAgC;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,6BAA6B;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,KAAK,EAAE;QACL,gCAAgC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,+BAA+B;QAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,KAAK,EAAE,KAAK,CAAC;QACX,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,mCAAmC;QACnC,YAAY,EAAE,UAAU,EAAE,CAAC;QAC3B,uCAAuC;QACvC,QAAQ,CAAC,EAAE;YACT,+BAA+B;YAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,4BAA4B;YAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC,CAAC;CACJ"}

package/dist/registry/messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/registry/messages.js.map

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

package/dist/registry/peer-store.d.ts

@@ -0,0 +1,56 @@
+import type { Peer } from './peer.js';
+/**
+ * In-memory store for known peers on the network
+ */
+export declare class PeerStore {
+    private peers;
+    /**
+     * Add or update a peer in the store.
+     * If a peer with the same publicKey exists, it will be updated.
+     *
+     * @param peer - The peer to add or update
+     */
+    addOrUpdatePeer(peer: Peer): void;
+    /**
+     * Remove a peer from the store.
+     *
+     * @param publicKey - The public key of the peer to remove
+     * @returns true if the peer was removed, false if it didn't exist
+     */
+    removePeer(publicKey: string): boolean;
+    /**
+     * Get a peer by their public key.
+     *
+     * @param publicKey - The public key of the peer to retrieve
+     * @returns The peer if found, undefined otherwise
+     */
+    getPeer(publicKey: string): Peer | undefined;
+    /**
+     * Find all peers that offer a specific capability by name.
+     *
+     * @param name - The capability name to search for
+     * @returns Array of peers that have a capability with the given name
+     */
+    findByCapability(name: string): Peer[];
+    /**
+     * Find all peers that have capabilities with a specific tag.
+     *
+     * @param tag - The tag to search for
+     * @returns Array of peers that have at least one capability with the given tag
+     */
+    findByTag(tag: string): Peer[];
+    /**
+     * Get all peers in the store.
+     *
+     * @returns Array of all peers
+     */
+    allPeers(): Peer[];
+    /**
+     * Remove peers that haven't been seen within the specified time window.
+     *
+     * @param maxAgeMs - Maximum age in milliseconds. Peers older than this will be removed.
+     * @returns Number of peers removed
+     */
+    prune(maxAgeMs: number): number;
+}
+//# sourceMappingURL=peer-store.d.ts.map

package/dist/registry/peer-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-store.d.ts","sourceRoot":"","sources":["../../src/registry/peer-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAgC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAI5C;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE;IAatC;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE;IAa9B;;;;OAIG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAchC"}

package/dist/registry/peer-store.js

@@ -0,0 +1,92 @@
+/**
+ * In-memory store for known peers on the network
+ */
+export class PeerStore {
+    peers = new Map();
+    /**
+     * Add or update a peer in the store.
+     * If a peer with the same publicKey exists, it will be updated.
+     *
+     * @param peer - The peer to add or update
+     */
+    addOrUpdatePeer(peer) {
+        this.peers.set(peer.publicKey, peer);
+    }
+    /**
+     * Remove a peer from the store.
+     *
+     * @param publicKey - The public key of the peer to remove
+     * @returns true if the peer was removed, false if it didn't exist
+     */
+    removePeer(publicKey) {
+        return this.peers.delete(publicKey);
+    }
+    /**
+     * Get a peer by their public key.
+     *
+     * @param publicKey - The public key of the peer to retrieve
+     * @returns The peer if found, undefined otherwise
+     */
+    getPeer(publicKey) {
+        return this.peers.get(publicKey);
+    }
+    /**
+     * Find all peers that offer a specific capability by name.
+     *
+     * @param name - The capability name to search for
+     * @returns Array of peers that have a capability with the given name
+     */
+    findByCapability(name) {
+        const result = [];
+        for (const peer of this.peers.values()) {
+            const hasCapability = peer.capabilities.some(cap => cap.name === name);
+            if (hasCapability) {
+                result.push(peer);
+            }
+        }
+        return result;
+    }
+    /**
+     * Find all peers that have capabilities with a specific tag.
+     *
+     * @param tag - The tag to search for
+     * @returns Array of peers that have at least one capability with the given tag
+     */
+    findByTag(tag) {
+        const result = [];
+        for (const peer of this.peers.values()) {
+            const hasTag = peer.capabilities.some(cap => cap.tags.includes(tag));
+            if (hasTag) {
+                result.push(peer);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get all peers in the store.
+     *
+     * @returns Array of all peers
+     */
+    allPeers() {
+        return Array.from(this.peers.values());
+    }
+    /**
+     * Remove peers that haven't been seen within the specified time window.
+     *
+     * @param maxAgeMs - Maximum age in milliseconds. Peers older than this will be removed.
+     * @returns Number of peers removed
+     */
+    prune(maxAgeMs) {
+        const now = Date.now();
+        const cutoff = now - maxAgeMs;
+        let removed = 0;
+        for (const [publicKey, peer] of this.peers.entries()) {
+            if (peer.lastSeen < cutoff) {
+                this.peers.delete(publicKey);
+                removed++;
+            }
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=peer-store.js.map

package/dist/registry/peer-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-store.js","sourceRoot":"","sources":["../../src/registry/peer-store.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,SAAS;IACZ,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,IAAU;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,SAAiB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,IAAY;QAC3B,MAAM,MAAM,GAAW,EAAE,CAAC;QAE1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACvE,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,GAAW;QACnB,MAAM,MAAM,GAAW,EAAE,CAAC;QAE1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAgB;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC;QAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACrD,IAAI,IAAI,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC7B,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/registry/peer.d.ts

@@ -0,0 +1,20 @@
+import type { Capability } from './capability.js';
+/**
+ * A peer is an agent on the network
+ */
+export interface Peer {
+    /** Identity (hex-encoded ed25519 public key) */
+    publicKey: string;
+    /** Capabilities this peer offers */
+    capabilities: Capability[];
+    /** Unix timestamp (ms) when this peer was last seen */
+    lastSeen: number;
+    /** Optional metadata about the peer */
+    metadata?: {
+        /** Human-readable alias */
+        name?: string;
+        /** Agent software version */
+        version?: string;
+    };
+}
+//# sourceMappingURL=peer.d.ts.map

package/dist/registry/peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../src/registry/peer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE;QACT,2BAA2B;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,6BAA6B;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}

package/dist/registry/peer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=peer.js.map

package/dist/registry/peer.js.map

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

package/dist/transport/http.d.ts

@@ -0,0 +1,41 @@
+import { type Envelope, type MessageType } from '../message/envelope.js';
+export interface PeerConfig {
+    /** Peer's webhook URL, e.g. http://localhost:18790/hooks */
+    url: string;
+    /** Peer's webhook auth token */
+    token: string;
+    /** Peer's public key (hex) for verifying responses */
+    publicKey: string;
+}
+export interface TransportConfig {
+    /** This agent's keypair */
+    identity: {
+        publicKey: string;
+        privateKey: string;
+    };
+    /** Known peers */
+    peers: Map<string, PeerConfig>;
+}
+/**
+ * Send a signed envelope to a peer via HTTP webhook.
+ * Creates the envelope, signs it, and POSTs to the peer's /hooks/agent endpoint.
+ * Returns the HTTP status code.
+ */
+export declare function sendToPeer(config: TransportConfig, peerPublicKey: string, type: MessageType, payload: unknown, inReplyTo?: string): Promise<{
+    ok: boolean;
+    status: number;
+    error?: string;
+}>;
+/**
+ * Decode and verify an inbound Agora envelope from a webhook message.
+ * Expects the message to start with [AGORA_ENVELOPE] followed by base64.
+ * Returns the verified envelope or an error.
+ */
+export declare function decodeInboundEnvelope(message: string, knownPeers: Map<string, PeerConfig>): {
+    ok: true;
+    envelope: Envelope;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEzG,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,kBAAkB;IAClB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmD1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiDlE"}