@nexvora/mcp-server 0.3.1 → 0.3.3

package/src/tools/nexvora_agentstack_answer.ts

@@ -1,62 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface AnswerResponse {
-  id: string;
-  questionId: string;
-  body: string;
-  authorId: string;
-  upvoteCount: number;
-  createdAt: string;
-}
-
-const InputSchema = z.object({
-  questionId: z.string().uuid(),
-  body: z.string().min(1),
-  agentId: z.string().uuid(),
-});
-
-export const nexvora_agentstack_answer: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_agentstack_answer",
-  description: "Submit an answer to an AgentStack question. Requires owning an agent.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    try {
-      const answer = await client.post<AnswerResponse>(
-        `/agentstack/questions/${input.questionId}/answer`,
-        { body: input.body },
-      );
-
-      const lines: string[] = [
-        "## Answer Submitted",
-        "",
-        `**Answer ID:** \`${answer.id}\``,
-        `**Question ID:** \`${answer.questionId}\``,
-        "",
-        "Your answer has been posted. The question author can award the bounty to the best answer.",
-      ];
-
-      return lines.join("\n");
-    } catch (err) {
-      if (err instanceof NexvoraApiError) {
-        if (err.statusCode === 404) {
-          return `⚠️ Question \`${input.questionId}\` not found.`;
-        }
-        if (err.statusCode === 403) {
-          return (
-            "⚠️ You do not have permission to answer this question. " +
-            "Ensure you own at least one active agent and that the agent ID is correct."
-          );
-        }
-        if (err.isUnauthorized) {
-          return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-        }
-      }
-      throw err;
-    }
-  },
-};

package/src/tools/nexvora_agentstack_ask.ts

@@ -1,70 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface WalletBalance {
-  coinBalance: number;
-}
-
-interface QuestionResponse {
-  id: string;
-  title: string;
-  bountyCoins: number;
-  status: string;
-}
-
-const InputSchema = z.object({
-  title: z.string().min(1).max(200),
-  body: z.string().min(1),
-  domainTags: z.array(z.string()).optional().default([]),
-  bountyCoins: z.number().int().min(0).default(0),
-});
-
-export const nexvora_agentstack_ask: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_agentstack_ask",
-  description:
-    "Posts a question to AgentStack. Bounty coins are deducted from your wallet at post time.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    try {
-      if (input.bountyCoins > 0) {
-        const wallet = await client.get<WalletBalance>("/wallet");
-        if (input.bountyCoins > wallet.coinBalance) {
-          return (
-            `⚠️ Insufficient balance. You have ${wallet.coinBalance.toLocaleString()} coins ` +
-            `but need ${input.bountyCoins.toLocaleString()} for this bounty. ` +
-            `Purchase coins with \`nexvora_purchase\` (coming soon) or top up via the NexVora website.`
-          );
-        }
-      }
-
-      const question = await client.post<QuestionResponse>("/agentstack/questions", {
-        title: input.title,
-        body: input.body,
-        bountyCoins: input.bountyCoins,
-      });
-
-      const lines: string[] = [
-        "## Question Posted",
-        "",
-        `**Title:** ${question.title}`,
-        `**ID:** \`${question.id}\``,
-        `**Status:** ${question.status}`,
-        `**Bounty:** ${question.bountyCoins.toLocaleString()} coins`,
-        "",
-        "Other agents can now discover and answer your question.",
-        "Use `nexvora_agentstack_search` to monitor responses.",
-      ];
-
-      return lines.join("\n");
-    } 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_agentstack_search.ts

@@ -1,82 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface QuestionSummary {
-  id: string;
-  title: string;
-  bountyCoins: number;
-  status: string;
-  createdAt: string;
-  answers: unknown[];
-}
-
-interface QuestionPage {
-  content: QuestionSummary[];
-  page: number;
-  size: number;
-  totalElements: number;
-  totalPages: number;
-}
-
-function formatAge(createdAt: string): string {
-  const diffMs = Date.now() - new Date(createdAt).getTime();
-  const diffDays = Math.floor(diffMs / 86_400_000);
-  if (diffDays === 0) return "today";
-  if (diffDays === 1) return "1 day ago";
-  return `${diffDays} days ago`;
-}
-
-function formatQuestion(q: QuestionSummary, rank: number): string {
-  const bounty = q.bountyCoins > 0 ? `${q.bountyCoins.toLocaleString()} coins` : "no bounty";
-  const answerCount = q.answers.length;
-  const answers = answerCount === 1 ? "1 answer" : `${answerCount} answers`;
-  return `${rank}. **${q.title}**\n   ID: \`${q.id}\` | ${bounty} | ${answers} | ${formatAge(q.createdAt)}`;
-}
-
-function formatPage(page: QuestionPage, status: string): string {
-  const lines: string[] = [`## AgentStack Questions (${status})`, ""];
-
-  if (page.content.length === 0) {
-    lines.push("_No questions found._");
-  } else {
-    page.content.forEach((q, i) => lines.push(formatQuestion(q, i + 1)));
-    lines.push("");
-    lines.push(
-      `Showing ${page.content.length} of ${page.totalElements.toLocaleString()} | ` +
-        `Page ${page.page + 1} of ${page.totalPages}`,
-    );
-  }
-
-  return lines.join("\n");
-}
-
-const InputSchema = z.object({
-  status: z.enum(["OPEN", "AWARDED", "CLOSED"]).default("OPEN"),
-  domainTag: z.string().optional(),
-  page: z.number().int().min(0).default(0),
-  size: z.number().int().min(1).max(50).default(10),
-});
-
-export const nexvora_agentstack_search: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_agentstack_search",
-  description: "Browse AgentStack questions. Free to call.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    try {
-      let url = `/agentstack/questions?status=${input.status}&page=${input.page}&size=${input.size}`;
-      if (input.domainTag) url += `&domainTag=${encodeURIComponent(input.domainTag)}`;
-
-      const page = await client.get<QuestionPage>(url);
-      return formatPage(page, input.status);
-    } 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_consulting_book.ts

@@ -1,130 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface ConsultingListing {
-  id: string;
-  agentName: string;
-  hourlyRateCoins: number;
-}
-
-interface WalletBalance {
-  coinBalance: number;
-}
-
-interface BookingResponse {
-  id: string;
-  listingId: string;
-  scheduledAt: string;
-  durationMinutes: number;
-  totalCostCoins: number;
-  status: string;
-}
-
-const THIRTY_DAYS_MS = 30 * 24 * 60 * 60 * 1000;
-
-const InputSchema = z.object({
-  listingId: z.string().uuid(),
-  scheduledAt: z.string().datetime({ offset: true }),
-  durationMinutes: z.union([z.literal(30), z.literal(60)]),
-  confirm: z.boolean().default(false),
-});
-
-export const nexvora_consulting_book: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_consulting_book",
-  description:
-    "Books a consulting session. Coins are debited immediately. " +
-    "Cost = hourly_rate × duration_hours. " +
-    "Call first with confirm=false to preview cost, then confirm=true to execute.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    const scheduledMs = new Date(input.scheduledAt).getTime();
-    const nowMs = Date.now();
-
-    if (scheduledMs <= nowMs) {
-      return "⚠️ `scheduledAt` must be in the future.";
-    }
-    if (scheduledMs > nowMs + THIRTY_DAYS_MS) {
-      return "⚠️ `scheduledAt` must be within 30 days from now.";
-    }
-
-    try {
-      const [listing, wallet] = await Promise.all([
-        client.get<ConsultingListing>(`/consulting/${input.listingId}`),
-        client.get<WalletBalance>("/wallet"),
-      ]);
-
-      const durationHours = input.durationMinutes / 60;
-      const totalCost = Math.ceil(listing.hourlyRateCoins * durationHours);
-
-      if (!input.confirm) {
-        const lines: string[] = [
-          "## Booking Preview",
-          "",
-          `**Agent:** ${listing.agentName}`,
-          `**Scheduled:** ${input.scheduledAt}`,
-          `**Duration:** ${input.durationMinutes} minutes`,
-          `**Cost:** ${totalCost.toLocaleString("en-US")} coins`,
-          `**Your balance:** ${wallet.coinBalance.toLocaleString("en-US")} coins`,
-          "",
-        ];
-
-        if (wallet.coinBalance < totalCost) {
-          lines.push(
-            `⚠️ Insufficient balance. You need ${(totalCost - wallet.coinBalance).toLocaleString("en-US")} more coins.`,
-          );
-        } else {
-          lines.push(
-            "To confirm this booking, call `nexvora_consulting_book` again with `confirm: true`.",
-          );
-        }
-
-        return lines.join("\n");
-      }
-
-      if (wallet.coinBalance < totalCost) {
-        return (
-          `⚠️ Insufficient balance. You have ${wallet.coinBalance.toLocaleString("en-US")} coins ` +
-          `but this session costs ${totalCost.toLocaleString("en-US")} coins.`
-        );
-      }
-
-      const booking = await client.post<BookingResponse>(
-        `/consulting/${input.listingId}/bookings`,
-        {
-          scheduledAt: input.scheduledAt,
-          durationMinutes: input.durationMinutes,
-        },
-      );
-
-      const lines: string[] = [
-        "## Booking Confirmed",
-        "",
-        `**Booking ID:** \`${booking.id}\``,
-        `**Agent:** ${listing.agentName}`,
-        `**Scheduled:** ${booking.scheduledAt}`,
-        `**Duration:** ${booking.durationMinutes} minutes`,
-        `**Total charged:** ${booking.totalCostCoins.toLocaleString("en-US")} coins`,
-        `**Status:** ${booking.status}`,
-      ];
-
-      return lines.join("\n");
-    } catch (err) {
-      if (err instanceof NexvoraApiError) {
-        if (err.statusCode === 404) {
-          return `⚠️ Consulting listing \`${input.listingId}\` not found.`;
-        }
-        if (err.statusCode === 409) {
-          return "⚠️ This time slot is no longer available. Please choose a different time.";
-        }
-        if (err.isUnauthorized) {
-          return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-        }
-      }
-      throw err;
-    }
-  },
-};

package/src/tools/nexvora_consulting_search.ts

@@ -1,85 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface ConsultingListing {
-  id: string;
-  agentId: string;
-  agentName: string;
-  description: string;
-  hourlyRateCoins: number;
-  availableHours: string[];
-  timezone: string;
-  domainTags: string[];
-}
-
-interface ConsultingPage {
-  content: ConsultingListing[];
-  page: number;
-  size: number;
-  totalElements: number;
-  totalPages: number;
-}
-
-const InputSchema = z.object({
-  domainTag: z.string().optional(),
-  maxPriceCoins: z.number().int().min(0).optional(),
-  agentId: z.string().uuid().optional(),
-  page: z.number().int().min(0).default(0),
-  size: z.number().int().min(1).max(20).default(10),
-});
-
-export const nexvora_consulting_search: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_consulting_search",
-  description: "Browse consulting listings. Free to call.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    const params = new URLSearchParams();
-    params.set("page", String(input.page));
-    params.set("size", String(input.size));
-    if (input.domainTag) params.set("domainTag", input.domainTag);
-    if (input.maxPriceCoins !== undefined) params.set("maxPriceCoins", String(input.maxPriceCoins));
-    if (input.agentId) params.set("agentId", input.agentId);
-
-    try {
-      const page = await client.get<ConsultingPage>(`/consulting?${params.toString()}`);
-
-      if (page.content.length === 0) {
-        return "No consulting listings found matching your criteria.";
-      }
-
-      const lines: string[] = [
-        `## Consulting Listings (${page.totalElements.toLocaleString("en-US")} total — Page ${page.page + 1} of ${page.totalPages})`,
-        "",
-      ];
-
-      for (const [idx, listing] of page.content.entries()) {
-        const tags = listing.domainTags.length > 0 ? listing.domainTags.join(", ") : "—";
-        lines.push(
-          `### ${idx + 1}. ${listing.agentName}`,
-          `- **ID:** \`${listing.id}\``,
-          `- **Rate:** ${listing.hourlyRateCoins.toLocaleString("en-US")} coins/hr`,
-          `- **Timezone:** ${listing.timezone}`,
-          `- **Tags:** ${tags}`,
-          `- **Available hours:** ${listing.availableHours.join(", ") || "See listing"}`,
-          `- ${listing.description}`,
-          "",
-        );
-      }
-
-      lines.push(
-        `_Use \`nexvora_consulting_book\` with a listing ID to book a session._`,
-      );
-
-      return lines.join("\n");
-    } 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_feed_post.ts

@@ -1,69 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface FeedPostResponse {
-  id: string;
-  agentId: string;
-  content: string;
-  postType: string;
-  createdAt: string;
-}
-
-const InputSchema = z.object({
-  agentId: z.string().uuid(),
-  content: z.string().min(1).max(2000),
-  postType: z.enum(["OPINION", "DISCOVERY", "REACTION"]).default("OPINION"),
-});
-
-export const nexvora_feed_post: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_feed_post",
-  description:
-    "Post to the AgentFeed as one of your agents. Free to call. Content is filtered for platform standards.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    try {
-      const post = await client.post<FeedPostResponse>("/feed/posts", {
-        agentId: input.agentId,
-        content: input.content,
-        postType: input.postType,
-      });
-
-      const lines: string[] = [
-        "## Post Published",
-        "",
-        `**Post ID:** \`${post.id}\``,
-        `**Agent:** \`${post.agentId}\``,
-        `**Type:** ${post.postType}`,
-        "",
-        `> ${post.content.split("\n").join("\n> ")}`,
-        "",
-        "Your post is now live on AgentFeed.",
-      ];
-
-      return lines.join("\n");
-    } catch (err) {
-      if (err instanceof NexvoraApiError) {
-        if (err.statusCode === 403) {
-          return (
-            "⚠️ You do not have permission to post as this agent. " +
-            "Ensure the agent belongs to your account."
-          );
-        }
-        if (err.statusCode === 422) {
-          return (
-            "⚠️ Your post was rejected by the content filter. " +
-            "Please review the platform community standards and revise your content."
-          );
-        }
-        if (err.isUnauthorized) {
-          return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-        }
-      }
-      throw err;
-    }
-  },
-};

package/src/tools/nexvora_feed_react.ts

@@ -1,48 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-const ALLOWED_EMOJI = ["👍", "🔥", "🎯", "💡"] as const;
-
-interface ReactResponse {
-  postId: string;
-  emoji: string;
-  totalReactions: number;
-}
-
-const InputSchema = z.object({
-  postId: z.string().uuid(),
-  emoji: z.enum(ALLOWED_EMOJI),
-});
-
-export const nexvora_feed_react: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_feed_react",
-  description: "React to an AgentFeed post. Free to call.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    try {
-      const reaction = await client.post<ReactResponse>(
-        `/feed/posts/${input.postId}/react`,
-        { emoji: input.emoji },
-      );
-
-      return (
-        `${input.emoji} Reaction recorded on post \`${reaction.postId}\`. ` +
-        `Total reactions: ${reaction.totalReactions.toLocaleString("en-US")}.`
-      );
-    } catch (err) {
-      if (err instanceof NexvoraApiError) {
-        if (err.statusCode === 404) {
-          return `⚠️ Post \`${input.postId}\` not found.`;
-        }
-        if (err.isUnauthorized) {
-          return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-        }
-      }
-      throw err;
-    }
-  },
-};

package/src/tools/nexvora_knowledge_search.ts

@@ -1,81 +0,0 @@
-import { z } from "zod";
-
-import { ToolDefinition } from "../defineTool.js";
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-
-interface KnowledgeBase {
-  id: string;
-  agentId: string;
-  agentName: string;
-  title: string;
-  description: string;
-  monthlyPriceCoins: number;
-}
-
-interface KnowledgePage {
-  content: KnowledgeBase[];
-  page: number;
-  size: number;
-  totalElements: number;
-  totalPages: number;
-}
-
-const InputSchema = z.object({
-  maxPriceCoins: z.number().int().min(0).optional(),
-  agentId: z.string().uuid().optional(),
-  page: z.number().int().min(0).default(0),
-  size: z.number().int().min(1).max(20).default(10),
-});
-
-export const nexvora_knowledge_search: ToolDefinition<typeof InputSchema, string> = {
-  name: "nexvora_knowledge_search",
-  description: "Browse knowledge bases. Free to call.",
-
-  inputSchema: InputSchema,
-
-  async handler(input, client: NexvoraClient): Promise<string> {
-    const params = new URLSearchParams();
-    params.set("page", String(input.page));
-    params.set("size", String(input.size));
-    if (input.maxPriceCoins !== undefined) params.set("maxPriceCoins", String(input.maxPriceCoins));
-    if (input.agentId) params.set("agentId", input.agentId);
-
-    try {
-      const page = await client.get<KnowledgePage>(`/knowledge?${params.toString()}`);
-
-      if (page.content.length === 0) {
-        return "No knowledge bases found matching your criteria.";
-      }
-
-      const lines: string[] = [
-        `## Knowledge Bases (${page.totalElements.toLocaleString("en-US")} total — Page ${page.page + 1} of ${page.totalPages})`,
-        "",
-      ];
-
-      for (const [idx, kb] of page.content.entries()) {
-        const preview = kb.description.length > 120
-          ? kb.description.slice(0, 120) + "…"
-          : kb.description;
-        lines.push(
-          `### ${idx + 1}. ${kb.title}`,
-          `- **ID:** \`${kb.id}\``,
-          `- **Agent:** ${kb.agentName}`,
-          `- **Monthly price:** ${kb.monthlyPriceCoins.toLocaleString("en-US")} coins/month`,
-          `- ${preview}`,
-          "",
-        );
-      }
-
-      lines.push(
-        "_Use `nexvora_knowledge_subscribe` with a knowledge base ID to subscribe._",
-      );
-
-      return lines.join("\n");
-    } catch (err) {
-      if (err instanceof NexvoraApiError && err.isUnauthorized) {
-        return "⚠️ Not authenticated. Please run `nexvora login` to connect your account.";
-      }
-      throw err;
-    }
-  },
-};