@elisym/mcp 0.8.11 → 0.8.13

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { LIMITS, DEFAULT_KIND_OFFSET, SolanaPaymentStrategy, makeCensor, DEFAULT_REDACT_PATHS, validateAgentName, RELAYS, toDTag, formatAssetAmount, USDC_SOLANA_DEVNET, estimateSolFeeLamports, formatFeeBreakdown, resolveAssetFromPaymentRequest as resolveAssetFromPaymentRequest$1, parseAssetAmount, ElisymIdentity, ElisymClient, NATIVE_SOL, resolveKnownAsset, estimateNetworkBaseline, formatNetworkBaseline, getProtocolProgramId, getProtocolConfig, assetKey, assetByKey, KNOWN_ASSETS } from '@elisym/sdk';
+import { LIMITS, DEFAULT_KIND_OFFSET, SolanaPaymentStrategy, makeCensor, DEFAULT_REDACT_PATHS, validateAgentName, RELAYS, toDTag, formatAssetAmount, estimateNetworkBaseline, formatSol as formatSol$1, USDC_SOLANA_DEVNET, estimateSolFeeLamports, formatFeeBreakdown, resolveAssetFromPaymentRequest as resolveAssetFromPaymentRequest$1, parseAssetAmount, ElisymIdentity, ElisymClient, NATIVE_SOL, resolveKnownAsset, formatNetworkBaseline, getProtocolProgramId, getProtocolConfig, assetKey, assetByKey, KNOWN_ASSETS } from '@elisym/sdk';
 import { listAgents, createAgentDir, writeYaml, writeSecrets, resolveAgent, loadAgent, globalConfigPath, writeFileAtomic as writeFileAtomic$1 } from '@elisym/sdk/agent-store';
 import { loadGlobalConfig, writeGlobalConfig } from '@elisym/sdk/node';
-import { getBase58Encoder, getBase58Decoder, generateKeyPairSigner, address, createSolanaRpcSubscriptions, sendAndConfirmTransactionFactory, getSignatureFromTransaction, pipe, createTransactionMessage, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, appendTransactionMessageInstructions, signTransactionMessageWithSigners, createKeyPairSignerFromBytes, createSolanaRpc, isAddress } from '@solana/kit';
+import { getBase58Encoder, getBase58Decoder, generateKeyPairSigner, createSolanaRpc, address, createSolanaRpcSubscriptions, sendAndConfirmTransactionFactory, getSignatureFromTransaction, pipe, createTransactionMessage, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, appendTransactionMessageInstructions, signTransactionMessageWithSigners, createKeyPairSignerFromBytes, isAddress } from '@solana/kit';
 import { Command } from 'commander';
 import { generateSecretKey, nip19, getPublicKey } from 'nostr-tools';
 import { readFile, writeFile, rename, unlink } from 'node:fs/promises';
@@ -2095,14 +2095,13 @@ var ContactSchema = z.object({
   name: z.string().max(200).optional(),
   addedAt: z.number().int().nonnegative(),
   lastJobAt: z.number().int().nonnegative().optional(),
-  jobCount: z.number().int().nonnegative(),
   lastCapability: z.string().max(200).optional(),
   note: z.string().max(500).optional()
-}).strict();
+});
 var ContactsSchema = z.object({
   version: z.literal(1),
   contacts: z.array(ContactSchema)
-}).strict();
+});
 var EMPTY2 = { version: 1, contacts: [] };
 var writeLocks2 = /* @__PURE__ */ new Map();
 function withLock2(path, fn) {
@@ -2157,8 +2156,7 @@ async function upsertContact(agentDir, input) {
         name: input.name ?? existing.name,
         note: input.note ?? existing.note,
         lastJobAt: input.lastJobAt ?? existing.lastJobAt,
-        lastCapability: input.lastCapability ?? existing.lastCapability,
-        jobCount: input.jobCount ?? existing.jobCount + 1
+        lastCapability: input.lastCapability ?? existing.lastCapability
       });
       data.contacts[index] = merged;
     } else {
@@ -2169,8 +2167,7 @@ async function upsertContact(agentDir, input) {
         note: input.note,
         addedAt: Date.now(),
         lastJobAt: input.lastJobAt,
-        lastCapability: input.lastCapability,
-        jobCount: input.jobCount ?? 0
+        lastCapability: input.lastCapability
       });
       data.contacts.push(merged);
     }
@@ -2339,7 +2336,7 @@ var GetIdentitySchema = z.object({});
 var discoveryTools = [
   defineTool({
     name: "search_agents",
-    description: "Search AI agents currently online on elisym. `capabilities` is a hard OR-filter of substring tokens from the user's request (never invent synonyms). `query` is optional re-ranking; omit if not needed. Offline agents are excluded by default - pass include_offline=true only when debugging.",
+    description: "Search AI agents currently online on elisym. `capabilities` is a hard OR-filter of substring tokens from the user's request (never invent synonyms). `query` is optional re-ranking; omit if not needed. Offline agents are excluded by default - pass include_offline=true only when debugging. Results that match a saved contact are sorted to the top and annotated with `is_contact`, `last_worked_at`, `last_capability`, and `contact_note` - surface this to the user (e.g. \"already in your contacts, last used <date>\") so they can prefer providers they've worked with before.",
     schema: SearchAgentsSchema,
     async handler(ctx, input) {
       const { capabilities, query, max_price_lamports, include_offline, contacts_only } = input;
@@ -2347,25 +2344,27 @@ var discoveryTools = [
         return errorResult(`Too many capabilities (max ${MAX_CAPABILITIES})`);
       }
       const agent = ctx.active();
-      let lastWorkedAtByPubkey = /* @__PURE__ */ new Map();
+      const contactByPubkey = /* @__PURE__ */ new Map();
+      if (agent.agentDir) {
+        const data = await readContacts(agent.agentDir);
+        for (const contact of data.contacts) {
+          contactByPubkey.set(contact.pubkey, contact);
+        }
+      }
       if (contacts_only) {
         if (!agent.agentDir) {
           return textResult(
             "contacts_only=true requires a persistent agent (no on-disk directory for the active agent)."
           );
         }
-        const data = await readContacts(agent.agentDir);
-        if (data.contacts.length === 0) {
+        if (contactByPubkey.size === 0) {
           return textResult(
             "No contacts saved yet. Use add_contact (or rate a job positively with submit_feedback and then add_contact) before searching with contacts_only=true."
           );
         }
-        lastWorkedAtByPubkey = new Map(
-          data.contacts.map((contact) => [contact.pubkey, contact.lastJobAt ?? contact.addedAt])
-        );
       }
       const agents = await agent.client.discovery.fetchAgents(agent.network);
-      let filtered = contacts_only ? agents.filter((a) => lastWorkedAtByPubkey.has(a.pubkey)) : agents;
+      let filtered = contacts_only ? agents.filter((a) => contactByPubkey.has(a.pubkey)) : agents;
       filtered = filtered.filter(
         (a) => a.cards.some(
           (card) => capabilities.some(
@@ -2408,38 +2407,89 @@ var discoveryTools = [
                 hits++;
               }
             }
-            return { agent: a, score: hits };
+            const contactBoost = contactByPubkey.has(a.pubkey) ? 0.5 : 0;
+            return { agent: a, score: hits + contactBoost };
           });
           filtered = scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score).map((s) => s.agent);
         }
+      } else if (contactByPubkey.size > 0) {
+        filtered = [...filtered].sort((left, right) => {
+          const leftContact = contactByPubkey.get(left.pubkey);
+          const rightContact = contactByPubkey.get(right.pubkey);
+          if (leftContact && !rightContact) {
+            return -1;
+          }
+          if (rightContact && !leftContact) {
+            return 1;
+          }
+          if (leftContact && rightContact) {
+            const leftTs = leftContact.lastJobAt ?? leftContact.addedAt;
+            const rightTs = rightContact.lastJobAt ?? rightContact.addedAt;
+            return rightTs - leftTs;
+          }
+          return 0;
+        });
       }
       if (filtered.length === 0) {
         return textResult(
           include_offline ? "No agents found matching those capabilities." : "No online agents found matching those capabilities. Retry shortly or pass include_offline=true to see unreachable matches."
         );
       }
-      const results = filtered.map((a) => ({
-        npub: a.npub,
-        name: sanitizeField(a.name || "", 200),
-        cards: a.cards.map((card) => {
-          const asset = assetFromCardPayment(card.payment);
-          const price = card.payment?.job_price;
-          return {
-            name: sanitizeField(card.name || "", 200),
-            description: sanitizeField(card.description || "", 500),
-            capabilities: card.capabilities,
-            job_price_subunits: price,
-            price_display: price ? formatAssetAmount(asset, BigInt(price)) : "free",
-            asset_token: asset.token,
-            asset_symbol: asset.symbol,
-            asset_mint: asset.mint,
-            chain: card.payment?.chain,
-            network: card.payment?.network
-          };
-        }),
-        supported_kinds: a.supportedKinds,
-        last_worked_at: contacts_only ? lastWorkedAtByPubkey.get(a.pubkey) : void 0
-      }));
+      const needsAtaSeen = /* @__PURE__ */ new Set();
+      for (const a of filtered) {
+        for (const card of a.cards) {
+          if ((card.payment?.chain ?? "solana") !== "solana") {
+            continue;
+          }
+          if (!card.payment?.job_price) {
+            continue;
+          }
+          needsAtaSeen.add(assetFromCardPayment(card.payment).mint !== void 0);
+        }
+      }
+      const gasByAtaNeed = /* @__PURE__ */ new Map();
+      if (needsAtaSeen.size > 0) {
+        try {
+          const rpc = createSolanaRpc(rpcUrlFor(agent.network));
+          await Promise.all(
+            Array.from(needsAtaSeen).map(async (needsAta) => {
+              const baseline = await estimateNetworkBaseline(rpc, { includeAtaRent: needsAta });
+              gasByAtaNeed.set(needsAta, formatSol$1(Number(baseline.totalLamports)));
+            })
+          );
+        } catch {
+        }
+      }
+      const results = filtered.map((a) => {
+        const contact = contactByPubkey.get(a.pubkey);
+        return {
+          npub: a.npub,
+          name: sanitizeField(a.name || "", 200),
+          cards: a.cards.map((card) => {
+            const asset = assetFromCardPayment(card.payment);
+            const price = card.payment?.job_price;
+            const gasEstimate = price ? gasByAtaNeed.get(asset.mint !== void 0) : void 0;
+            return {
+              name: sanitizeField(card.name || "", 200),
+              description: sanitizeField(card.description || "", 500),
+              capabilities: card.capabilities,
+              job_price_subunits: price,
+              price_display: price ? formatAssetAmount(asset, BigInt(price)) : "free",
+              asset_token: asset.token,
+              asset_symbol: asset.symbol,
+              asset_mint: asset.mint,
+              chain: card.payment?.chain,
+              network: card.payment?.network,
+              network_fee_estimate_sol: gasEstimate
+            };
+          }),
+          supported_kinds: a.supportedKinds,
+          is_contact: contact ? true : void 0,
+          last_worked_at: contact ? contact.lastJobAt ?? contact.addedAt : void 0,
+          last_capability: contact?.lastCapability,
+          contact_note: contact?.note ? sanitizeField(contact.note, 500) : void 0
+        };
+      });
       const { text } = sanitizeUntrusted(JSON.stringify(results, null, 2), "structured");
       return textResult(text);
     }
@@ -2571,7 +2621,7 @@ var feedbackContactsTools = [
   }),
   defineTool({
     name: "add_contact",
-    description: "Add a provider to the active agent's contacts list (.contacts.json). When the provider has prior jobs in the local history, the contact is enriched with jobCount, lastJobAt, and lastCapability. Idempotent: re-calling with the same npub updates name/note in place without duplicating the entry.",
+    description: "Add a provider to the active agent's contacts list (.contacts.json). When the provider has prior jobs in the local history, the contact is enriched with lastJobAt and lastCapability. Idempotent: re-calling with the same npub updates name/note in place without duplicating the entry.",
     schema: AddContactSchema,
     async handler(ctx, input) {
       ctx.toolRateLimiter.check();
@@ -2599,14 +2649,12 @@ var feedbackContactsTools = [
         name: cleanName ?? fallbackProviderName,
         note: cleanNote,
         lastJobAt: last?.completedAt,
-        lastCapability: last?.capability,
-        jobCount: history.length
+        lastCapability: last?.capability
       });
       const lines = [
         `Saved contact ${contact.npub}.`,
         contact.name ? `  name: ${contact.name}` : null,
-        contact.lastCapability ? `  last capability: ${contact.lastCapability}` : null,
-        contact.jobCount > 0 ? `  prior jobs: ${contact.jobCount}` : null
+        contact.lastCapability ? `  last capability: ${contact.lastCapability}` : null
       ].filter((line) => line !== null);
       return textResult(lines.join("\n"));
     }
@@ -2656,8 +2704,7 @@ var feedbackContactsTools = [
         note: contact.note !== void 0 ? sanitizeField(contact.note, 500) : void 0,
         added_at: contact.addedAt,
         last_job_at: contact.lastJobAt,
-        last_capability: contact.lastCapability !== void 0 ? sanitizeField(contact.lastCapability, 200) : void 0,
-        job_count: contact.jobCount
+        last_capability: contact.lastCapability !== void 0 ? sanitizeField(contact.lastCapability, 200) : void 0
       }));
       const { text: wrapped } = sanitizeUntrusted(JSON.stringify(limited, null, 2), "structured");
       return textResult(`${limited.length} contact(s):