@elisym/mcp 0.3.1 → 0.3.2

package/dist/index.js

@@ -1072,6 +1072,7 @@ function sanitizeField(input, maxLen) {
 }
 
 // src/tools/customer.ts
+var PRE_PING_TIMEOUT_MS = 5e3;
 var CreateJobSchema = z.object({
   input: z.string().describe("The job prompt/input sent to the provider."),
   capability: z.string().min(1).max(64).default("general").describe("Short tag selecting which capability of the provider to invoke."),
@@ -1445,6 +1446,12 @@ ${wrapped}`);
       const timeout = Math.min(input.timeout_secs, MAX_TIMEOUT_SECS) * 1e3;
       const agent = ctx.active();
       const providerPubkey = decodeNpub(input.provider_npub);
+      const ping = await agent.client.ping.pingAgent(providerPubkey, PRE_PING_TIMEOUT_MS);
+      if (!ping.online) {
+        return errorResult(
+          `Provider ${input.provider_npub} is offline. Run search_agents to find currently-online providers.`
+        );
+      }
       const providers = await agent.client.discovery.fetchAgents(agent.network);
       const provider = providers.find((a) => a.npub === input.provider_npub);
       if (!provider) {
@@ -1526,6 +1533,12 @@ ${result}`);
       const agent = ctx.active();
       const providerPubkey = decodeNpub(input.provider_npub);
       const dTag = toDTag(input.capability);
+      const ping = await agent.client.ping.pingAgent(providerPubkey, PRE_PING_TIMEOUT_MS);
+      if (!ping.online) {
+        return errorResult(
+          `Provider ${input.provider_npub} is offline. Run search_agents to find currently-online providers.`
+        );
+      }
       const agents = await agent.client.discovery.fetchAgents(agent.network);
       const provider = agents.find((a) => a.npub === input.provider_npub);
       if (!provider) {
@@ -1667,6 +1680,8 @@ ${text}`);
     }
   })
 ];
+var LAST_SEEN_ONLINE_WINDOW_SECS = 10 * 60;
+var SEARCH_PING_TIMEOUT_MS = 3e3;
 var STOP_WORDS = /* @__PURE__ */ new Set([
   "a",
   "an",
@@ -1800,28 +1815,19 @@ var SearchAgentsSchema = z.object({
   capabilities: z.array(z.string()).min(1).describe("OR-matched substring filter on agent names, descriptions, and capability tags."),
   query: z.string().optional().describe("Optional secondary scoring for re-ranking. Omit when you have precise tokens."),
   max_price_lamports: z.number().int().optional(),
-  // rename in description so it's obvious we're using a heuristic freshness signal,
-  // not a live reachability probe.
-  recently_active_only: z.boolean().default(true).describe(
-    "If true, only return agents with job activity in the last hour. Not a liveness probe."
+  include_offline: z.boolean().default(false).describe(
+    "If true, skip the live online check and return agents regardless of reachability. Default: false - only currently-online agents are returned."
   )
 });
 var ListCapabilitiesSchema = z.object({});
 var GetIdentitySchema = z.object({});
-var PingAgentSchema = z.object({
-  agent_npub: z.string(),
-  // single source of truth for the default.
-  timeout_secs: z.number().int().min(1).max(600).default(15)
-});
 var discoveryTools = [
   defineTool({
     name: "search_agents",
-    // previous description was ~90 tokens and was truncated by some MCP clients.
-    // Keep the operational rules short; schema `.describe()` fields carry the detail.
-    description: "Search AI agents. `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.",
+    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.",
     schema: SearchAgentsSchema,
     async handler(ctx, input) {
-      const { capabilities, query, max_price_lamports, recently_active_only } = input;
+      const { capabilities, query, max_price_lamports, include_offline } = input;
       if (capabilities.length > MAX_CAPABILITIES) {
         return errorResult(`Too many capabilities (max ${MAX_CAPABILITIES})`);
       }
@@ -1834,10 +1840,6 @@ var discoveryTools = [
           )
         )
       );
-      if (recently_active_only) {
-        const activeThreshold = Math.floor(Date.now() / 1e3) - 60 * 60;
-        filtered = filtered.filter((a) => a.lastSeen >= activeThreshold);
-      }
       if (max_price_lamports !== void 0) {
         filtered = filtered.filter(
           (a) => a.cards.some(
@@ -1845,6 +1847,25 @@ var discoveryTools = [
           )
         );
       }
+      if (!include_offline) {
+        const freshThreshold = Math.floor(Date.now() / 1e3) - LAST_SEEN_ONLINE_WINDOW_SECS;
+        filtered = filtered.filter((a) => a.lastSeen >= freshThreshold);
+        if (filtered.length > 0) {
+          const probes = await Promise.allSettled(
+            filtered.map(
+              (candidate) => agent.client.ping.pingAgent(candidate.pubkey, SEARCH_PING_TIMEOUT_MS)
+            )
+          );
+          const survivors = [];
+          filtered.forEach((candidate, index) => {
+            const probe = probes[index];
+            if (probe?.status === "fulfilled" && probe.value.online) {
+              survivors.push(candidate);
+            }
+          });
+          filtered = survivors;
+        }
+      }
       if (query) {
         const isAscii = /^[\u0000-\u007F]*$/.test(query);
         const words = query.toLowerCase().split(/\s+/).filter((w) => w.length > 1 && (!isAscii || !STOP_WORDS.has(w)));
@@ -1865,7 +1886,7 @@ var discoveryTools = [
       }
       if (filtered.length === 0) {
         return textResult(
-          recently_active_only ? "No recently-active agents found matching those capabilities. Try with recently_active_only=false." : "No agents found matching those capabilities."
+          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) => ({
@@ -1927,31 +1948,6 @@ ${text}`);
         )
       );
     }
-  }),
-  defineTool({
-    name: "ping_agent",
-    description: "Ping an agent to check if it's online. Sends an encrypted heartbeat and waits for a pong.",
-    schema: PingAgentSchema,
-    async handler(ctx, input) {
-      ctx.toolRateLimiter.check();
-      const { agent_npub, timeout_secs } = input;
-      const agent = ctx.active();
-      let pubkey;
-      try {
-        const decoded = nip19.decode(agent_npub);
-        if (decoded.type !== "npub") {
-          return errorResult(`Expected npub, got ${decoded.type}`);
-        }
-        pubkey = decoded.data;
-      } catch {
-        return errorResult(`Invalid npub: ${agent_npub}`);
-      }
-      const timeoutMs = timeout_secs * 1e3;
-      const result = await agent.client.ping.pingAgent(pubkey, timeoutMs);
-      return textResult(
-        result.online ? `Agent ${agent_npub} is online.` : `Agent ${agent_npub} did not respond within ${timeout_secs}s.`
-      );
-    }
   })
 ];
 var GetBalanceSchema = z.object({});