@nekzus/liop 1.2.0-alpha.10

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./bridge/index.js";
+export * from "./client/index.js";
+export * from "./economy/index.js";
+export * from "./gateway/hybrid.js";
+export * from "./mesh/node.js";
+export * from "./prompts/adapters.js";
+export * from "./rpc/client.js";
+export * from "./rpc/server.js";
+export * from "./sandbox/wasi.js";
+export * from "./server/index.js";
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from "./bridge/index.js";
+export * from "./client/index.js";
+export * from "./economy/index.js";
+export * from "./gateway/hybrid.js";
+export * from "./mesh/node.js";
+export * from "./prompts/adapters.js";
+export * from "./rpc/client.js";
+export * from "./rpc/server.js";
+export * from "./sandbox/wasi.js";
+export * from "./server/index.js";
+export * from "./types.js";

package/dist/mesh/index.d.ts

@@ -0,0 +1 @@
+export * from "./node.js";

package/dist/mesh/index.js

@@ -0,0 +1 @@
+export * from "./node.js";

package/dist/mesh/node.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Manifest describing a node's capabilities in the LIOP Mesh.
+ * Exchanged via the /liop/manifest/1.0.0 protocol stream.
+ */
+export interface LiopManifest {
+    peerId: string;
+    grpcPort: number;
+    tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+    resources: Array<{
+        name: string;
+        uri: string;
+        description?: string;
+        mimeType?: string;
+        text?: string;
+    }>;
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+    taxonomy?: {
+        domain: string;
+        clearanceTier: number;
+        executionTypes: string[];
+    };
+}
+export interface MeshNodeConfig {
+    listenAddresses?: string[];
+    bootstrapNodes?: string[];
+    identityPath?: string;
+    enableWAN?: boolean;
+    dhtStoragePath?: string;
+    /** Optional function to translate multiaddrs (e.g. for Docker NAT traversal). Return null to drop an address. */
+    addressMapper?: (addr: string) => string | null;
+}
+/**
+ * P2P Mesh Node backed by libp2p + Kademlia DHT.
+ *
+ * Provides capability advertisement via CID-based content routing
+ * and decentralized peer discovery.
+ */
+export declare class MeshNode {
+    private node;
+    private config;
+    private manifestDialFailureState;
+    private static readonly MANIFEST_DIAL_BASE_COOLDOWN_MS;
+    private static readonly MANIFEST_DIAL_MAX_COOLDOWN_MS;
+    private static readonly MANIFEST_DIAL_SKIP_LOG_THROTTLE_MS;
+    /**
+     * Buffer of capability hashes that have been announced.
+     * Used to re-announce capabilities when new peers connect
+     * (critical for small / isolated clusters where the initial
+     * provide() finds zero peers in the routing table).
+     */
+    private announcedCapabilities;
+    /** Guards against concurrent re-announcement storms. */
+    private reannouncing;
+    /** Callback that returns the local node's manifest on request. */
+    private manifestProvider;
+    /** Flag to ensure the manifest protocol is only registered once. */
+    private manifestProtocolRegistered;
+    /** Local Ed25519 Private Key for protocol signatures */
+    private localPrivateKey;
+    constructor(config?: MeshNodeConfig);
+    private shouldSkipManifestDial;
+    private recordManifestDialFailure;
+    private clearManifestDialFailure;
+    /**
+     * Loads a persistent identity from disk or generates a new Ed25519 keypair.
+     * Uses privateKeyToProtobuf/privateKeyFromProtobuf (libp2p v3.x official API).
+     */
+    private loadOrCreateIdentity;
+    /**
+     * Persists the private key to disk using protobuf serialization (libp2p v3.x).
+     */
+    private saveIdentity;
+    /**
+     * Creates a CID v1 (raw codec 0x55) from a SHA-256 hash of the capability string.
+     * Required by @libp2p/kad-dht v16+ for provide/findProviders.
+     */
+    private capabilityToCID;
+    /**
+     * Re-announces all buffered capabilities after a new peer connects.
+     * Uses a small delay to allow the DHT protocol handshake to complete.
+     */
+    private reannounceAll;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private loadRoutingTable;
+    private saveRoutingTable;
+    /**
+     * Internal logic to register protocol handlers against the libp2p node.
+     * Can be called multiple times; handles idempotent registration.
+     */
+    private applyHandlers;
+    /**
+     * Registers a callback as the manifest provider.
+     * Will be applied immediately if the node is already initialized.
+     */
+    registerManifestHandler(provider: () => LiopManifest): void;
+    /**
+     * Queries a remote peer's manifest by opening a /liop/manifest/1.0.0 stream.
+     * Returns null if the peer doesn't support the protocol or is unreachable.
+     */
+    queryManifest(peerIdStr: string): Promise<LiopManifest | null>;
+    /**
+     * Discovers all peers in the DHT that have announced "liop:manifest".
+     * Returns their PeerIDs for subsequent manifest queries.
+     */
+    discoverManifestProviders(): Promise<string[]>;
+    /**
+     * Announces this node as a manifest provider in the DHT.
+     * Should be called after tools/resources have been registered.
+     */
+    announceManifest(): Promise<void>;
+    /**
+     * Returns the current size of the routing table for diagnostic purposes.
+     */
+    getRoutingTableSize(): number;
+    getPeerId(): string;
+    sign(data: Uint8Array): Promise<Uint8Array>;
+    getMultiaddrs(): string[];
+    announceCapability(hash: string): Promise<void>;
+    findProviders(hash: string): Promise<string[]>;
+    resolvePeer(peerIdStr: string): Promise<string[]>;
+}