@nexvora/mcp-server 0.3.2 → 0.4.0

package/src/__tests__/nexvora_agentstack_ask.test.ts

@@ -1,140 +0,0 @@
-import { jest } from "@jest/globals";
-
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-import { nexvora_agentstack_ask } from "../tools/nexvora_agentstack_ask.js";
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function makeClient(): any {
-  const client = new NexvoraClient({
-    baseUrl: "https://api.nxvora.online",
-    accessToken: "token",
-  });
-  (client as any).get = jest.fn();
-  (client as any).post = jest.fn();
-  (client as any).sendAudit = jest.fn().mockResolvedValue(undefined);
-  return client;
-}
-
-const WALLET_RESPONSE = { coinBalance: 1000 };
-
-const QUESTION_RESPONSE = {
-  id: "bbbbbbbb-0000-0000-0000-000000000001",
-  title: "How to implement RAG?",
-  bountyCoins: 100,
-  status: "OPEN",
-};
-
-describe("nexvora_agentstack_ask tool", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it("posts a question without bounty (skips wallet check)", async () => {
-    const client = makeClient();
-    client.post.mockResolvedValueOnce(QUESTION_RESPONSE);
-
-    const result = await nexvora_agentstack_ask.handler(
-      { title: "How to implement RAG?", body: "Explain in detail.", domainTags: [], bountyCoins: 0 },
-      client,
-    );
-
-    expect(client.get).not.toHaveBeenCalled();
-    expect(client.post).toHaveBeenCalledWith("/agentstack/questions", {
-      title: "How to implement RAG?",
-      body: "Explain in detail.",
-      bountyCoins: 0,
-    });
-    expect(result).toContain("## Question Posted");
-    expect(result).toContain("bbbbbbbb-0000-0000-0000-000000000001");
-  });
-
-  it("checks wallet before posting when bountyCoins > 0", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce(WALLET_RESPONSE);
-    client.post.mockResolvedValueOnce(QUESTION_RESPONSE);
-
-    await nexvora_agentstack_ask.handler(
-      { title: "My question", body: "Body text", domainTags: [], bountyCoins: 100 },
-      client,
-    );
-
-    expect(client.get).toHaveBeenCalledWith("/wallet");
-    expect(client.post).toHaveBeenCalled();
-  });
-
-  it("returns insufficient balance message when bounty exceeds balance", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce({ coinBalance: 50 });
-
-    const result = await nexvora_agentstack_ask.handler(
-      { title: "Expensive question", body: "Body text", domainTags: [], bountyCoins: 500 },
-      client,
-    );
-
-    expect(client.post).not.toHaveBeenCalled();
-    expect(result).toContain("Insufficient balance");
-    expect(result).toContain("50");
-    expect(result).toContain("500");
-    expect(result).toContain("nexvora_purchase");
-  });
-
-  it("returns formatted success with question title and ID", async () => {
-    const client = makeClient();
-    client.post.mockResolvedValueOnce(QUESTION_RESPONSE);
-
-    const result = await nexvora_agentstack_ask.handler(
-      { title: "How to implement RAG?", body: "Details", domainTags: [], bountyCoins: 0 },
-      client,
-    );
-
-    expect(result).toContain("How to implement RAG?");
-    expect(result).toContain("bbbbbbbb-0000-0000-0000-000000000001");
-    expect(result).toContain("OPEN");
-  });
-
-  it("posts with bounty=100 to /agentstack/questions", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce(WALLET_RESPONSE);
-    client.post.mockResolvedValueOnce({ ...QUESTION_RESPONSE, bountyCoins: 100 });
-
-    await nexvora_agentstack_ask.handler(
-      { title: "My Q", body: "My body", domainTags: [], bountyCoins: 100 },
-      client,
-    );
-
-    expect(client.post).toHaveBeenCalledWith("/agentstack/questions", {
-      title: "My Q",
-      body: "My body",
-      bountyCoins: 100,
-    });
-  });
-
-  it("returns auth error message on 401", async () => {
-    const client = makeClient();
-    client.post.mockRejectedValueOnce(
-      new NexvoraApiError(401, "Unauthorized", "/agentstack/questions"),
-    );
-
-    const result = await nexvora_agentstack_ask.handler(
-      { title: "Q", body: "B", domainTags: [], bountyCoins: 0 },
-      client,
-    );
-
-    expect(result).toContain("nexvora login");
-    expect(result).toContain("Not authenticated");
-  });
-
-  it("re-throws non-auth errors", async () => {
-    const client = makeClient();
-    client.post.mockRejectedValueOnce(
-      new NexvoraApiError(500, "Server Error", "/agentstack/questions"),
-    );
-
-    await expect(
-      nexvora_agentstack_ask.handler(
-        { title: "Q", body: "B", domainTags: [], bountyCoins: 0 },
-        client,
-      ),
-    ).rejects.toBeInstanceOf(NexvoraApiError);
-  });
-});

package/src/__tests__/nexvora_agentstack_search.test.ts

@@ -1,188 +0,0 @@
-import { jest } from "@jest/globals";
-
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-import { nexvora_agentstack_search } from "../tools/nexvora_agentstack_search.js";
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function makeClient(): any {
-  const client = new NexvoraClient({
-    baseUrl: "https://api.nxvora.online",
-    accessToken: "token",
-  });
-  (client as any).get = jest.fn();
-  (client as any).sendAudit = jest.fn().mockResolvedValue(undefined);
-  return client;
-}
-
-const NOW = new Date("2026-05-07T12:00:00Z").getTime();
-
-const QUESTION_PAGE = {
-  content: [
-    {
-      id: "aaaaaaaa-0000-0000-0000-000000000001",
-      title: "How to implement RAG?",
-      bountyCoins: 500,
-      status: "OPEN",
-      createdAt: new Date(NOW - 2 * 86_400_000).toISOString(),
-      answers: [],
-    },
-    {
-      id: "aaaaaaaa-0000-0000-0000-000000000002",
-      title: "Best vector store for Java?",
-      bountyCoins: 0,
-      status: "OPEN",
-      createdAt: new Date(NOW - 86_400_000).toISOString(),
-      answers: [{ id: "ans-1" }],
-    },
-  ],
-  page: 0,
-  size: 10,
-  totalElements: 2,
-  totalPages: 1,
-};
-
-describe("nexvora_agentstack_search tool", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-    jest.useFakeTimers({ now: NOW });
-  });
-
-  afterEach(() => {
-    jest.useRealTimers();
-  });
-
-  it("returns formatted markdown list of questions", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce(QUESTION_PAGE);
-
-    const defaults = nexvora_agentstack_search.inputSchema.parse({});
-    const result = await nexvora_agentstack_search.handler(defaults, client);
-
-    expect(result).toContain("## AgentStack Questions (OPEN)");
-    expect(result).toContain("How to implement RAG?");
-    expect(result).toContain("Best vector store for Java?");
-    expect(result).toContain("500 coins");
-    expect(result).toContain("no bounty");
-  });
-
-  it("uses default status=OPEN, page=0, size=10 when no args", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce(QUESTION_PAGE);
-
-    const defaults = nexvora_agentstack_search.inputSchema.parse({});
-    await nexvora_agentstack_search.handler(defaults, client);
-
-    expect(client.get).toHaveBeenCalledWith(
-      expect.stringContaining("status=OPEN"),
-    );
-    expect(client.get).toHaveBeenCalledWith(expect.stringContaining("page=0"));
-    expect(client.get).toHaveBeenCalledWith(expect.stringContaining("size=10"));
-  });
-
-  it("passes custom status, page, size to the backend", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce({ ...QUESTION_PAGE, page: 1, totalPages: 3 });
-
-    await nexvora_agentstack_search.handler(
-      { status: "AWARDED", page: 1, size: 5, domainTag: undefined },
-      client,
-    );
-
-    expect(client.get).toHaveBeenCalledWith(
-      expect.stringContaining("status=AWARDED"),
-    );
-    expect(client.get).toHaveBeenCalledWith(expect.stringContaining("page=1"));
-    expect(client.get).toHaveBeenCalledWith(expect.stringContaining("size=5"));
-  });
-
-  it("appends domainTag to URL when provided", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce(QUESTION_PAGE);
-
-    await nexvora_agentstack_search.handler(
-      { status: "OPEN", domainTag: "machine learning", page: 0, size: 10 },
-      client,
-    );
-
-    expect(client.get).toHaveBeenCalledWith(
-      expect.stringContaining("domainTag=machine%20learning"),
-    );
-  });
-
-  it("shows empty state when no questions found", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce({
-      content: [],
-      page: 0,
-      size: 10,
-      totalElements: 0,
-      totalPages: 0,
-    });
-
-    const result = await nexvora_agentstack_search.handler(
-      { status: "OPEN", page: 0, size: 10, domainTag: undefined },
-      client,
-    );
-
-    expect(result).toContain("No questions found");
-  });
-
-  it("shows pagination summary when results are returned", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce({
-      ...QUESTION_PAGE,
-      totalElements: 42,
-      totalPages: 5,
-    });
-
-    const result = await nexvora_agentstack_search.handler(
-      { status: "OPEN", page: 0, size: 10, domainTag: undefined },
-      client,
-    );
-
-    expect(result).toContain("42");
-    expect(result).toContain("Page 1 of 5");
-  });
-
-  it("shows answer count in question summary", async () => {
-    const client = makeClient();
-    client.get.mockResolvedValueOnce(QUESTION_PAGE);
-
-    const result = await nexvora_agentstack_search.handler(
-      { status: "OPEN", page: 0, size: 10, domainTag: undefined },
-      client,
-    );
-
-    expect(result).toContain("0 answers");
-    expect(result).toContain("1 answer");
-  });
-
-  it("returns auth error message on 401", async () => {
-    const client = makeClient();
-    client.get.mockRejectedValueOnce(
-      new NexvoraApiError(401, "Unauthorized", "/agentstack/questions"),
-    );
-
-    const result = await nexvora_agentstack_search.handler(
-      { status: "OPEN", page: 0, size: 10, domainTag: undefined },
-      client,
-    );
-
-    expect(result).toContain("nexvora login");
-    expect(result).toContain("Not authenticated");
-  });
-
-  it("re-throws non-auth errors", async () => {
-    const client = makeClient();
-    client.get.mockRejectedValueOnce(
-      new NexvoraApiError(500, "Server Error", "/agentstack/questions"),
-    );
-
-    await expect(
-      nexvora_agentstack_search.handler(
-        { status: "OPEN", page: 0, size: 10, domainTag: undefined },
-        client,
-      ),
-    ).rejects.toBeInstanceOf(NexvoraApiError);
-  });
-});

package/src/__tests__/nexvora_consulting_book.test.ts

@@ -1,277 +0,0 @@
-import { jest } from "@jest/globals";
-
-import { NexvoraApiError, NexvoraClient } from "../NexvoraClient.js";
-import { nexvora_consulting_book } from "../tools/nexvora_consulting_book.js";
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function makeClient(): any {
-  const client = new NexvoraClient({
-    baseUrl: "https://api.nxvora.online",
-    accessToken: "token",
-  });
-  (client as any).get = jest.fn();
-  (client as any).post = jest.fn();
-  (client as any).sendAudit = jest.fn().mockResolvedValue(undefined);
-  return client;
-}
-
-const LISTING_ID = "aaaaaaaa-0000-0000-0000-000000000001";
-// A future date well within 30 days
-const FUTURE_DATE = new Date(Date.now() + 2 * 24 * 60 * 60 * 1000).toISOString();
-const FAR_FUTURE_DATE = new Date(Date.now() + 31 * 24 * 60 * 60 * 1000).toISOString();
-
-const LISTING = {
-  id: LISTING_ID,
-  agentName: "ExpertBot",
-  hourlyRateCoins: 500,
-};
-
-const WALLET_OK = { coinBalance: 1000 };
-const WALLET_LOW = { coinBalance: 100 };
-
-const BOOKING_RESPONSE = {
-  id: "cccccccc-0000-0000-0000-000000000001",
-  listingId: LISTING_ID,
-  scheduledAt: FUTURE_DATE,
-  durationMinutes: 60,
-  totalCostCoins: 500,
-  status: "CONFIRMED",
-};
-
-describe("nexvora_consulting_book tool", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  describe("validation", () => {
-    it("rejects a past scheduledAt", async () => {
-      const client = makeClient();
-      const past = new Date(Date.now() - 1000).toISOString();
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: past, durationMinutes: 60, confirm: false },
-        client,
-      );
-
-      expect(result).toContain("must be in the future");
-      expect(client.get).not.toHaveBeenCalled();
-    });
-
-    it("rejects a scheduledAt more than 30 days out", async () => {
-      const client = makeClient();
-
-      const result = await nexvora_consulting_book.handler(
-        {
-          listingId: LISTING_ID,
-          scheduledAt: FAR_FUTURE_DATE,
-          durationMinutes: 60,
-          confirm: false,
-        },
-        client,
-      );
-
-      expect(result).toContain("within 30 days");
-      expect(client.get).not.toHaveBeenCalled();
-    });
-
-    it("accepts only 30 or 60 as durationMinutes", () => {
-      expect(() =>
-        nexvora_consulting_book.inputSchema.parse({
-          listingId: LISTING_ID,
-          scheduledAt: FUTURE_DATE,
-          durationMinutes: 45,
-        }),
-      ).toThrow();
-    });
-
-    it("defaults confirm to false", () => {
-      const parsed = nexvora_consulting_book.inputSchema.parse({
-        listingId: LISTING_ID,
-        scheduledAt: FUTURE_DATE,
-        durationMinutes: 30,
-      });
-      expect(parsed.confirm).toBe(false);
-    });
-  });
-
-  describe("preview mode (confirm=false)", () => {
-    it("returns cost preview without booking", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_OK);
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: false },
-        client,
-      );
-
-      expect(result).toContain("## Booking Preview");
-      expect(result).toContain("ExpertBot");
-      expect(result).toContain("500");
-      expect(result).toContain("confirm: true");
-      expect(client.post).not.toHaveBeenCalled();
-    });
-
-    it("computes cost correctly for 30-minute session", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)       // 500 coins/hr
-        .mockResolvedValueOnce(WALLET_OK);
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 30, confirm: false },
-        client,
-      );
-
-      // 500 coins/hr × 0.5 hr = 250 coins
-      expect(result).toContain("250");
-      expect(client.post).not.toHaveBeenCalled();
-    });
-
-    it("shows insufficient balance warning in preview when wallet is too low", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_LOW);
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: false },
-        client,
-      );
-
-      expect(result).toContain("Insufficient balance");
-      expect(client.post).not.toHaveBeenCalled();
-    });
-
-    it("fetches listing and wallet in parallel", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_OK);
-
-      await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: false },
-        client,
-      );
-
-      expect(client.get).toHaveBeenCalledWith(`/consulting/${LISTING_ID}`);
-      expect(client.get).toHaveBeenCalledWith("/wallet");
-      expect(client.get).toHaveBeenCalledTimes(2);
-    });
-  });
-
-  describe("confirm mode (confirm=true)", () => {
-    it("submits booking and returns confirmation", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_OK);
-      client.post.mockResolvedValueOnce(BOOKING_RESPONSE);
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: true },
-        client,
-      );
-
-      expect(result).toContain("## Booking Confirmed");
-      expect(result).toContain(BOOKING_RESPONSE.id);
-      expect(result).toContain("CONFIRMED");
-      expect(result).toContain("500");
-    });
-
-    it("sends only scheduledAt and durationMinutes in POST body", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_OK);
-      client.post.mockResolvedValueOnce(BOOKING_RESPONSE);
-
-      await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: true },
-        client,
-      );
-
-      const [url, body] = client.post.mock.calls[0] as [string, unknown];
-      expect(url).toBe(`/consulting/${LISTING_ID}/bookings`);
-      expect(body).toEqual({ scheduledAt: FUTURE_DATE, durationMinutes: 60 });
-    });
-
-    it("blocks booking when wallet balance is insufficient", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_LOW);
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: true },
-        client,
-      );
-
-      expect(result).toContain("Insufficient balance");
-      expect(client.post).not.toHaveBeenCalled();
-    });
-  });
-
-  describe("error handling", () => {
-    it("returns 404 message when listing not found", async () => {
-      const client = makeClient();
-      client.get.mockRejectedValueOnce(
-        new NexvoraApiError(404, "Not Found", `/consulting/${LISTING_ID}`),
-      );
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: false },
-        client,
-      );
-
-      expect(result).toContain("not found");
-      expect(result).toContain(LISTING_ID);
-    });
-
-    it("returns 409 message when time slot is taken", async () => {
-      const client = makeClient();
-      client.get
-        .mockResolvedValueOnce(LISTING)
-        .mockResolvedValueOnce(WALLET_OK);
-      client.post.mockRejectedValueOnce(
-        new NexvoraApiError(409, "Conflict", `/consulting/${LISTING_ID}/bookings`),
-      );
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: true },
-        client,
-      );
-
-      expect(result).toContain("no longer available");
-    });
-
-    it("returns auth error message on 401", async () => {
-      const client = makeClient();
-      client.get.mockRejectedValueOnce(
-        new NexvoraApiError(401, "Unauthorized", `/consulting/${LISTING_ID}`),
-      );
-
-      const result = await nexvora_consulting_book.handler(
-        { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: false },
-        client,
-      );
-
-      expect(result).toContain("nexvora login");
-    });
-
-    it("re-throws non-handled errors", async () => {
-      const client = makeClient();
-      client.get.mockRejectedValueOnce(
-        new NexvoraApiError(500, "Server Error", `/consulting/${LISTING_ID}`),
-      );
-
-      await expect(
-        nexvora_consulting_book.handler(
-          { listingId: LISTING_ID, scheduledAt: FUTURE_DATE, durationMinutes: 60, confirm: false },
-          client,
-        ),
-      ).rejects.toBeInstanceOf(NexvoraApiError);
-    });
-  });
-});