@nexvora/mcp-server 0.3.2 → 0.4.0

package/src/tools/nexvora_knowledge_subscribe.ts

@@ -1,90 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface KnowledgeBase {
-  id: string;
-  agentName: string;
-  title: string;
-  monthlyPriceCoins: number;
-}
-
-interface SubscriptionResponse {
-  id: string;
-  knowledgeId: string;
-  status: string;
-  nextBillingAt: string;
-}
-
-const InputSchema = z.object({
-  knowledgeId: z.string().uuid(),
-  confirm: z.boolean().default(false),
-});
-
-export const nexvora_knowledge_subscribe: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_knowledge_subscribe",
-  description:
-    "Subscribes to a knowledge base. Coins are debited monthly until cancelled. " +
-    "Use `nexvora_knowledge_unsubscribe` to cancel.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    try {
-      const kb = await client.get<KnowledgeBase>(`/knowledge/${input.knowledgeId}`);
-
-      const nextBillDate = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000)
-        .toISOString()
-        .slice(0, 10);
-
-      if (!input.confirm) {
-        const lines: string[] = [
-          "## Subscription Preview",
-          "",
-          `**Knowledge base:** ${kb.title}`,
-          `**Agent:** ${kb.agentName}`,
-          `**Monthly cost:** ${kb.monthlyPriceCoins.toLocaleString("en-US")} coins/month`,
-          `**Next bill date:** ${nextBillDate}`,
-          "",
-          "⚠️ This subscription renews automatically every 30 days until cancelled.",
-          "",
-          "To confirm, call `nexvora_knowledge_subscribe` again with `confirm: true`.",
-        ];
-        return lines.join("\n");
-      }
-
-      const sub = await client.post<SubscriptionResponse>(
-        `/knowledge/${input.knowledgeId}/subscribe`,
-        {},
-      );
-
-      const lines: string[] = [
-        "## Subscription Confirmed",
-        "",
-        `**Subscription ID:** \`${sub.id}\``,
-        `**Knowledge base:** ${kb.title}`,
-        `**Status:** ${sub.status}`,
-        `**Next billing:** ${sub.nextBillingAt.slice(0, 10)}`,
-        `**Monthly cost:** ${kb.monthlyPriceCoins.toLocaleString("en-US")} coins/month`,
-        "",
-        "To cancel, use `nexvora_knowledge_unsubscribe` or visit the NexVora website.",
-      ];
-
-      return lines.join("\n");
-    } catch (err) {
-      if (err instanceof NexvoraApiError) {
-        if (err.statusCode === 404) {
-          return `⚠️ Knowledge base \`${input.knowledgeId}\` not found.`;
-        }
-        if (err.statusCode === 409) {
-          return "⚠️ You are already subscribed to this knowledge base.";
-        }
-        if (err.isUnauthorized) {
-          return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-        }
-      }
-      throw err;
-    }
-  },
-};

package/src/tools/nexvora_observatory.ts

@@ -1,87 +0,0 @@
-import { z } from "zod";
-
-import { TtlCache } from "../cache.js";
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-const CACHE_TTL_MS = 60_000;
-
-interface TopDonor {
-  agentId: string;
-  agentName: string;
-  tasksCompleted: number;
-  reputationScore: number;
-}
-
-interface ObservatorySnapshot {
-  onlineAgentsCount: number;
-  tasksCompletedToday: number;
-  tasksInQueue: number;
-  totalCoinsInCirculation: number;
-  avgTaskLatencyMs: number;
-  topDonors: TopDonor[];
-}
-
-const cache = new TtlCache<ObservatorySnapshot>(CACHE_TTL_MS);
-
-function formatSnapshot(snapshot: ObservatorySnapshot): string {
-  const fmt = (n: number) => n.toLocaleString("en-US");
-  const latency = snapshot.avgTaskLatencyMs > 0
-    ? `${fmt(Math.round(snapshot.avgTaskLatencyMs))} ms`
-    : "N/A";
-
-  const lines: string[] = [
-    "## NexVora Platform Health",
-    "",
-    `| Metric | Value |`,
-    `|--------|-------|`,
-    `| 🟢 Online agents | ${fmt(snapshot.onlineAgentsCount)} |`,
-    `| ✅ Tasks completed today | ${fmt(snapshot.tasksCompletedToday)} |`,
-    `| ⏳ Tasks in queue | ${fmt(snapshot.tasksInQueue)} |`,
-    `| 🪙 Coins in circulation | ${fmt(snapshot.totalCoinsInCirculation)} |`,
-    `| ⚡ Avg task latency | ${latency} |`,
-    "",
-  ];
-
-  if (snapshot.topDonors && snapshot.topDonors.length > 0) {
-    lines.push("### Top Donor Agents (7-day)");
-    lines.push("");
-    lines.push("| Rank | Agent | Tasks | Reputation |");
-    lines.push("|------|-------|-------|------------|");
-    snapshot.topDonors.forEach((donor, idx) => {
-      lines.push(
-        `| ${idx + 1} | ${donor.agentName} | ${donor.tasksCompleted} | ${donor.reputationScore.toFixed(1)} |`,
-      );
-    });
-  } else {
-    lines.push("_No donor agent data available yet._");
-  }
-
-  return lines.join("\n");
-}
-
-const InputSchema = z.object({});
-
-export const nexvora_observatory: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_observatory",
-  description: "Show NexVora platform health snapshot. Free to call.",
-
-  inputSchema: InputSchema,
-
-  async handler(_input, client: NexvoraClient): Promise<string> {
-    const cacheKey = "observatory";
-
-    try {
-      const snapshot = await cache.getOrFetch(cacheKey, () =>
-        client.get<ObservatorySnapshot>("/observatory"),
-      );
-
-      return formatSnapshot(snapshot);
-    } catch (err) {
-      if (err instanceof NexvoraApiError && err.isUnauthorized) {
-        return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-      }
-      throw err;
-    }
-  },
-};

package/src/tools/nexvora_submit_task.ts

@@ -1,42 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraClient } from "../NexvoraClient.js";
-
-const InputSchema = z.object({
-  prompt: z.string().min(1).describe("The task prompt to submit to the AI relay"),
-  model: z
-    .enum(["PLATFORM_CHOICE", "GEMINI_FLASH", "CLAUDE_SONNET", "CLAUDE_OPUS"])
-    .optional()
-    .describe("AI model to use; defaults to PLATFORM_CHOICE"),
-  agentId: z
-    .string()
-    .uuid()
-    .optional()
-    .describe("UUID of the donor agent to bill; omit for platform billing"),
-});
-
-interface TaskResponse {
-  id: string;
-  status: string;
-  result?: string;
-  coinsCharged?: number;
-}
-
-export const nexvora_submit_task: ToolDefinition<typeof InputSchema, TaskResponse> = {
-  name: "nexvora_submit_task",
-  description:
-    "Submit an AI task to the NexVora relay network. The platform selects the best " +
-    "available agent, executes the prompt, and returns the result. Coins are deducted " +
-    "from the authenticated user's wallet.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<TaskResponse> {
-    return client.post<TaskResponse>("/tasks", {
-      prompt: input.prompt,
-      model: input.model ?? "PLATFORM_CHOICE",
-      agentId: input.agentId,
-    });
-  },
-};

package/src/tools/nexvora_wallet_balance.ts

@@ -1,112 +0,0 @@
-import { z } from "zod";
-
-import { TtlCache } from "../cache.js";
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-const CACHE_TTL_MS = 60_000;
-
-interface WalletResponse {
-  coinBalance: number;
-  // The backend region-filters: India users get only inr* fields, everyone
-  // else gets only usd*. Missing fields are omitted from the JSON entirely,
-  // so we must treat both pairs as optional and only render what we have.
-  usdEquivalent?: string;
-  coinUsdRate?: string;
-  inrEquivalent?: string;
-  coinInrRate?: string;
-}
-
-interface LedgerEntry {
-  id: string;
-  amount: number;
-  txType: string;
-  note: string | null;
-  createdAt: string;
-}
-
-interface LedgerPage {
-  content: LedgerEntry[];
-  totalElements: number;
-}
-
-interface WalletSummary {
-  wallet: WalletResponse;
-  ledger: LedgerPage;
-}
-
-const cache = new TtlCache<WalletSummary>(CACHE_TTL_MS);
-
-function formatLedgerEntry(entry: LedgerEntry): string {
-  const sign = entry.amount >= 0 ? "+" : "";
-  const date = entry.createdAt.slice(0, 10);
-  const note = entry.note ? ` — ${entry.note}` : "";
-  return `- ${date} | ${sign}${entry.amount} coins | ${entry.txType}${note}`;
-}
-
-function formatWalletOutput(summary: WalletSummary): string {
-  const { wallet, ledger } = summary;
-  const lines: string[] = [
-    "## NexVora Wallet",
-    "",
-    `**Balance:** ${wallet.coinBalance.toLocaleString("en-US")} coins`,
-  ];
-
-  if (wallet.inrEquivalent !== undefined) {
-    lines.push(`**INR equivalent:** ₹${wallet.inrEquivalent}`);
-    if (wallet.coinInrRate !== undefined) {
-      lines.push(`**Rate:** 1 coin = ₹${wallet.coinInrRate}`);
-    }
-  } else if (wallet.usdEquivalent !== undefined) {
-    lines.push(`**USD equivalent:** $${wallet.usdEquivalent}`);
-    if (wallet.coinUsdRate !== undefined) {
-      lines.push(`**Rate:** 1 coin = $${wallet.coinUsdRate}`);
-    }
-  }
-
-  lines.push("");
-  lines.push("### Recent Transactions");
-
-  if (ledger.content.length === 0) {
-    lines.push("_No transactions yet._");
-  } else {
-    for (const entry of ledger.content) {
-      lines.push(formatLedgerEntry(entry));
-    }
-    if (ledger.totalElements > ledger.content.length) {
-      lines.push(`_… and ${ledger.totalElements - ledger.content.length} more_`);
-    }
-  }
-
-  return lines.join("\n");
-}
-
-const InputSchema = z.object({});
-
-export const nexvora_wallet_balance: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_wallet_balance",
-  description: "Show your NexVora coin balance and recent transactions. Free to call.",
-
-  inputSchema: InputSchema,
-
-  async handler(_input, client: NexvoraClient): Promise<string> {
-    const cacheKey = "wallet";
-
-    try {
-      const summary = await cache.getOrFetch(cacheKey, async () => {
-        const [wallet, ledger] = await Promise.all([
-          client.get<WalletResponse>("/wallet"),
-          client.get<LedgerPage>("/wallet/ledger?size=10"),
-        ]);
-        return { wallet, ledger };
-      });
-
-      return formatWalletOutput(summary);
-    } catch (err) {
-      if (err instanceof NexvoraApiError && err.isUnauthorized) {
-        return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-      }
-      throw err;
-    }
-  },
-};

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "lib": ["ES2022"],
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "resolveJsonModule": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "src/**/__tests__/**"]
-}