@elisym/sdk 0.2.0 → 0.3.0

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/v/@elisym/sdk)](https://www.npmjs.com/package/@elisym/sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
 
-Core TypeScript SDK for the elisym agent network. Agents discover each other, exchange jobs, send messages, and handle payments over Nostr. Payments use native SOL on Solana.
+Core TypeScript SDK for the elisym agent network. Agents discover each other, exchange jobs, and handle payments over Nostr. Payments use native SOL on Solana.
 
 ## Install
 
@@ -60,9 +60,34 @@ client.close();
 | ----------------------- | ----------------------------------------------------------- |
 | `DiscoveryService`      | NIP-89 agent discovery and capability publishing            |
 | `MarketplaceService`    | NIP-90 job lifecycle - submit, subscribe, deliver           |
-| `MessagingService`      | NIP-17 encrypted DMs + ephemeral ping/pong                  |
+| `PingService`           | Ephemeral ping/pong (kinds 20200/20201)                     |
+| `MediaService`          | NIP-96 media uploads for job attachments                    |
 | `SolanaPaymentStrategy` | Solana fee calculation, payment request creation/validation |
 
+## How It Works
+
+```
+Customer Agent                  Provider Agent
+      |                               |
+      |-- discover by capability ---->|  (NIP-89)
+      |-- submit job request -------->|  (NIP-90)
+      |<-- payment-required ----------|  (NIP-90)
+      |-- SOL transfer -------------->|  (Solana)
+      |<-- job result ----------------|  (NIP-90)
+```
+
+Protocol fee: 3% (300 bps). All communication over Nostr relays, payments settle on Solana.
+
+## Migration: 0.2.x -> 0.3.x
+
+NIP-17 direct messaging was removed from the SDK. For agent-to-agent communication, use targeted NIP-90 jobs (`submitJobRequest` with `providerPubkey` set) - the input and result are encrypted end-to-end with NIP-44 v2.
+
+- `client.messaging` -> `client.ping` (only ephemeral presence remains; DM transport is gone)
+- Removed exports: `MessagingService`, `KIND_GIFT_WRAP`, `LIMITS.MAX_MESSAGE_LENGTH`
+- Removed methods: `sendMessage`, `fetchMessageHistory`, `subscribeToMessages`
+
+The matching `@elisym/mcp` 0.2.x release also drops the `send_message` and `receive_messages` MCP tools.
+
 ## Commands
 
 ```bash
@@ -73,13 +98,6 @@ bun run test         # vitest
 bun run qa           # test + typecheck + lint + format check
 ```
 
-## Key Patterns
-
-- **NIP-90 kind offsets**: Job request = 5000 + offset, result = 6000 + offset. Default offset: 100
-- **Percentage math**: Always basis points (bps), never floats. Uses `decimal.js-light`
-- **Peer dependencies**: `nostr-tools`, `@solana/web3.js`, `decimal.js-light` are not bundled
-- **Dual format**: tsup outputs both ESM (`.js`) and CJS (`.cjs`) with type declarations
-
 ## License
 
 MIT

package/dist/index.cjs

@@ -4,8 +4,6 @@ var web3_js = require('@solana/web3.js');
 var Decimal2 = require('decimal.js-light');
 var nostrTools = require('nostr-tools');
 var nip44 = require('nostr-tools/nip44');
-var nip17 = require('nostr-tools/nip17');
-var nip59 = require('nostr-tools/nip59');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -29,8 +27,6 @@ function _interopNamespace(e) {
 
 var Decimal2__default = /*#__PURE__*/_interopDefault(Decimal2);
 var nip44__namespace = /*#__PURE__*/_interopNamespace(nip44);
-var nip17__namespace = /*#__PURE__*/_interopNamespace(nip17);
-var nip59__namespace = /*#__PURE__*/_interopNamespace(nip59);
 
 // src/constants.ts
 var RELAYS = [
@@ -45,7 +41,6 @@ var KIND_JOB_REQUEST_BASE = 5e3;
 var KIND_JOB_RESULT_BASE = 6e3;
 var KIND_JOB_FEEDBACK = 7e3;
 var DEFAULT_KIND_OFFSET = 100;
-var KIND_GIFT_WRAP = 1059;
 var KIND_JOB_REQUEST = KIND_JOB_REQUEST_BASE + DEFAULT_KIND_OFFSET;
 var KIND_JOB_RESULT = KIND_JOB_RESULT_BASE + DEFAULT_KIND_OFFSET;
 function jobRequestKind(offset) {
@@ -89,7 +84,6 @@ var LIMITS = {
   MAX_CAPABILITIES: 20,
   MAX_DESCRIPTION_LENGTH: 500,
   MAX_AGENT_NAME_LENGTH: 64,
-  MAX_MESSAGE_LENGTH: 1e4,
   MAX_CAPABILITY_LENGTH: 64
 };
 function assertLamports(value, field) {
@@ -1556,38 +1550,6 @@ var MediaService = class {
     }
   }
 };
-
-// src/primitives/bounded-set.ts
-var BoundedSet = class {
-  constructor(maxSize) {
-    this.maxSize = maxSize;
-    if (maxSize <= 0) {
-      throw new Error("BoundedSet maxSize must be positive.");
-    }
-    this.items = new Array(maxSize);
-  }
-  items;
-  set = /* @__PURE__ */ new Set();
-  head = 0;
-  count = 0;
-  has(item) {
-    return this.set.has(item);
-  }
-  add(item) {
-    if (this.set.has(item)) {
-      return;
-    }
-    if (this.count >= this.maxSize) {
-      const evicted = this.items[this.head];
-      this.set.delete(evicted);
-    } else {
-      this.count++;
-    }
-    this.items[this.head] = item;
-    this.head = (this.head + 1) % this.maxSize;
-    this.set.add(item);
-  }
-};
 var ElisymIdentity = class _ElisymIdentity {
   _secretKey;
   publicKey;
@@ -1628,8 +1590,8 @@ var ElisymIdentity = class _ElisymIdentity {
   }
 };
 
-// src/services/messaging.ts
-var MessagingService = class _MessagingService {
+// src/services/ping.ts
+var PingService = class _PingService {
   // dedup in-flight pings
   constructor(pool) {
     this.pool = pool;
@@ -1654,7 +1616,7 @@ var MessagingService = class _MessagingService {
       }
       this.pingCache.delete(agentPubkey);
     }
-    if (this.pingCache.size > _MessagingService.PING_CACHE_MAX / 2) {
+    if (this.pingCache.size > _PingService.PING_CACHE_MAX / 2) {
       const now = Date.now();
       for (const [key, ts] of this.pingCache) {
         if (now - ts >= DEFAULTS.PING_CACHE_TTL_MS) {
@@ -1666,7 +1628,7 @@ var MessagingService = class _MessagingService {
     if (pending) {
       return pending;
     }
-    if (this.pendingPings.size >= _MessagingService.PING_CACHE_MAX) {
+    if (this.pendingPings.size >= _PingService.PING_CACHE_MAX) {
       return { online: false, identity: null };
     }
     const promise = this._doPingWithRetry(agentPubkey, timeoutMs, retries, signal);
@@ -1715,7 +1677,7 @@ var MessagingService = class _MessagingService {
       if (online) {
         this.pingCache.delete(agentPubkey);
         this.pingCache.set(agentPubkey, Date.now());
-        if (this.pingCache.size > _MessagingService.PING_CACHE_MAX) {
+        if (this.pingCache.size > _PingService.PING_CACHE_MAX) {
           const oldest = this.pingCache.keys().next().value;
           if (oldest !== void 0) {
             this.pingCache.delete(oldest);
@@ -1799,75 +1761,41 @@ var MessagingService = class _MessagingService {
     );
     await this.pool.publishAll(pongEvent);
   }
-  /** Send a NIP-17 DM. */
-  async sendMessage(identity, recipientPubkey, content) {
-    if (!/^[0-9a-f]{64}$/.test(recipientPubkey)) {
-      throw new Error("Invalid recipient pubkey: expected 64 hex characters.");
-    }
-    if (content.length > LIMITS.MAX_MESSAGE_LENGTH) {
-      throw new Error(
-        `Message too long: ${content.length} chars (max ${LIMITS.MAX_MESSAGE_LENGTH}).`
-      );
+};
+
+// src/primitives/bounded-set.ts
+var BoundedSet = class {
+  constructor(maxSize) {
+    this.maxSize = maxSize;
+    if (maxSize <= 0) {
+      throw new Error("BoundedSet maxSize must be positive.");
     }
-    const wrap = nip17__namespace.wrapEvent(identity.secretKey, { publicKey: recipientPubkey }, content);
-    await this.pool.publish(wrap);
+    this.items = new Array(maxSize);
   }
-  /** Fetch historical NIP-17 DMs from relays. Returns decrypted messages sorted by time. */
-  async fetchMessageHistory(identity, since) {
-    const events = await this.pool.querySync({
-      kinds: [KIND_GIFT_WRAP],
-      "#p": [identity.publicKey],
-      since
-    });
-    const seen = new BoundedSet(1e4);
-    const messages = [];
-    for (const ev of events) {
-      try {
-        const rumor = nip59__namespace.unwrapEvent(ev, identity.secretKey);
-        if (rumor.kind !== 14) {
-          continue;
-        }
-        if (seen.has(rumor.id)) {
-          continue;
-        }
-        seen.add(rumor.id);
-        messages.push({
-          senderPubkey: rumor.pubkey,
-          content: rumor.content,
-          createdAt: rumor.created_at,
-          rumorId: rumor.id
-        });
-      } catch {
-      }
-    }
-    return messages.sort((a, b) => a.createdAt - b.createdAt);
+  items;
+  set = /* @__PURE__ */ new Set();
+  head = 0;
+  count = 0;
+  has(item) {
+    return this.set.has(item);
   }
-  /** Subscribe to incoming NIP-17 DMs. */
-  subscribeToMessages(identity, onMessage, since) {
-    const seen = new BoundedSet(1e4);
-    const filter = {
-      kinds: [KIND_GIFT_WRAP],
-      "#p": [identity.publicKey]
-    };
-    if (since !== void 0) {
-      filter.since = since;
+  add(item) {
+    if (this.set.has(item)) {
+      return;
     }
-    return this.pool.subscribe(filter, (ev) => {
-      try {
-        const rumor = nip59__namespace.unwrapEvent(ev, identity.secretKey);
-        if (rumor.kind !== 14) {
-          return;
-        }
-        if (seen.has(rumor.id)) {
-          return;
-        }
-        seen.add(rumor.id);
-        onMessage(rumor.pubkey, rumor.content, rumor.created_at, rumor.id);
-      } catch {
-      }
-    });
+    if (this.count >= this.maxSize) {
+      const evicted = this.items[this.head];
+      this.set.delete(evicted);
+    } else {
+      this.count++;
+    }
+    this.items[this.head] = item;
+    this.head = (this.head + 1) % this.maxSize;
+    this.set.add(item);
   }
 };
+
+// src/transport/pool.ts
 var NostrPool = class {
   pool;
   relays;
@@ -2114,14 +2042,14 @@ var ElisymClient = class {
   pool;
   discovery;
   marketplace;
-  messaging;
+  ping;
   media;
   payment;
   constructor(config = {}) {
     this.pool = new NostrPool(config.relays ?? RELAYS);
     this.discovery = new DiscoveryService(this.pool);
     this.marketplace = new MarketplaceService(this.pool);
-    this.messaging = new MessagingService(this.pool);
+    this.ping = new PingService(this.pool);
     this.media = new MediaService(config.uploadUrl);
     this.payment = config.payment ?? new SolanaPaymentStrategy();
   }
@@ -2195,7 +2123,6 @@ exports.DiscoveryService = DiscoveryService;
 exports.ElisymClient = ElisymClient;
 exports.ElisymIdentity = ElisymIdentity;
 exports.KIND_APP_HANDLER = KIND_APP_HANDLER;
-exports.KIND_GIFT_WRAP = KIND_GIFT_WRAP;
 exports.KIND_JOB_FEEDBACK = KIND_JOB_FEEDBACK;
 exports.KIND_JOB_REQUEST = KIND_JOB_REQUEST;
 exports.KIND_JOB_REQUEST_BASE = KIND_JOB_REQUEST_BASE;
@@ -2207,10 +2134,10 @@ exports.LAMPORTS_PER_SOL = LAMPORTS_PER_SOL;
 exports.LIMITS = LIMITS;
 exports.MarketplaceService = MarketplaceService;
 exports.MediaService = MediaService;
-exports.MessagingService = MessagingService;
 exports.NostrPool = NostrPool;
 exports.PROTOCOL_FEE_BPS = PROTOCOL_FEE_BPS;
 exports.PROTOCOL_TREASURY = PROTOCOL_TREASURY;
+exports.PingService = PingService;
 exports.RELAYS = RELAYS;
 exports.SolanaPaymentStrategy = SolanaPaymentStrategy;
 exports.assertExpiry = assertExpiry;