Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

8.6 KB
Raw Blame
import { describe, expect, it } from "vitest";
import {
  createDocsRedirects,
  createIntegrationRedirects,
  createRootMarkdownRedirects,
  compatibilityRedirects,
  defaultLanguageRedirects,
  docsRedirects,
  rootMarkdownRedirects,
} from "./redirects";

describe("createDocsRedirects", () => {
  it("preserves Markdown negotiation across default and localized paths", () => {
    expect(createDocsRedirects("/channels", "/channels/overview")).toEqual([
      {
        source: "/docs/channels",
        destination: "/docs/channels/overview",
        permanent: true,
      },
      {
        source: "/en/docs/channels",
        destination: "/docs/channels/overview",
        permanent: true,
      },
      {
        source: "/docs/channels.md",
        destination: "/docs/channels/overview.md",
        permanent: true,
      },
      {
        source: "/en/docs/channels.md",
        destination: "/docs/channels/overview.md",
        permanent: true,
      },
      {
        source: "/docs/channels.mdx",
        destination: "/docs/channels/overview.mdx",
        permanent: true,
      },
      {
        source: "/en/docs/channels.mdx",
        destination: "/docs/channels/overview.mdx",
        permanent: true,
      },
    ]);
  });
});

describe("createRootMarkdownRedirects", () => {
  it("redirects only explicit Markdown representations into docs", () => {
    expect(createRootMarkdownRedirects("/installation", "/getting-started")).toEqual([
      {
        source: "/installation.md",
        destination: "/docs/getting-started.md",
        permanent: true,
      },
      {
        source: "/installation.mdx",
        destination: "/docs/getting-started.mdx",
        permanent: true,
      },
    ]);
  });
});

describe("createIntegrationRedirects", () => {
  it("preserves HTML and Markdown representations across default and localized paths", () => {
    expect(createIntegrationRedirects("chat-sdk-photon", "photon")).toEqual([
      {
        source: "/integrations/chat-sdk-photon",
        destination: "/integrations/photon",
        permanent: true,
      },
      {
        source: "/en/integrations/chat-sdk-photon",
        destination: "/integrations/photon",
        permanent: true,
      },
      {
        source: "/integrations/chat-sdk-photon.md",
        destination: "/integrations/photon.md",
        permanent: true,
      },
      {
        source: "/en/integrations/chat-sdk-photon.md",
        destination: "/integrations/photon.md",
        permanent: true,
      },
      {
        source: "/integrations/chat-sdk-photon.mdx",
        destination: "/integrations/photon.mdx",
        permanent: true,
      },
      {
        source: "/en/integrations/chat-sdk-photon.mdx",
        destination: "/integrations/photon.mdx",
        permanent: true,
      },
    ]);
  });
});

describe("docsRedirects", () => {
  it.each([
    ["/docs/channels", "/docs/channels/overview"],
    ["/docs/guides/deployment.md", "/docs/guides/deployment/overview.md"],
    ["/docs/guides/frontend/add-a-web-app", "/docs/guides/frontend/nextjs"],
    ["/docs/guides/frontend/add-a-web-app.mdx", "/docs/guides/frontend/nextjs.mdx"],
    ["/docs/introduction.md", "/docs/getting-started.md"],
    ["/docs/installation", "/docs/getting-started"],
    ["/docs/installation.md", "/docs/getting-started.md"],
    ["/docs/project-structure", "/docs/concepts/project-structure"],
    ["/docs/project-structure.md", "/docs/concepts/project-structure.md"],
    ["/docs/getting-started/multiple-root-agents", "/docs/concepts/project-structure"],
    ["/docs/multi-agent-projects", "/docs/concepts/project-structure"],
    ["/docs/multi-agent-projects.mdx", "/docs/concepts/project-structure.mdx"],
    ["/docs/reference/http-api", "/docs/channels/eve"],
    ["/docs/project-layout", "/docs/getting-started"],
    ["/docs/reference/project-layout", "/docs/getting-started"],
    ["/docs/reference/project-layout.md", "/docs/getting-started.md"],
    ["/docs/dynamic-capabilities", "/docs/guides/dynamic-capabilities"],
    ["/docs/guides/state", "/docs/concepts/state"],
    ["/docs/dynamic-workflows", "/docs/concepts/built-in-tools"],
    ["/docs/guides/dynamic-workflows", "/docs/concepts/built-in-tools"],
    ["/docs/subagents/workflow-tool", "/docs/concepts/built-in-tools"],
    ["/docs/subagents/workflow-tool.md", "/docs/concepts/built-in-tools.md"],
    ["/docs/sessions", "/docs/concepts/sessions-runs-and-streaming"],
    ["/docs/agent", "/docs/agent-config"],
    ["/docs/guides/acp", "/docs/protocols/acp"],
    ["/docs/guides/acp.md", "/docs/protocols/acp.md"],
    ["/docs/guides/ucp", "/docs/protocols/ucp"],
    ["/docs/guides/ucp.mdx", "/docs/protocols/ucp.mdx"],
    ["/docs/evals", "/docs/evals/overview"],
    ["/docs/guides/evaluate", "/docs/guides/decide"],
    ["/docs/guides/evaluate.md", "/docs/guides/decide.md"],
    ["/docs/sandbox/microsandbox", "/docs/sandbox"],
    ["/docs/sandbox/microsandbox.md", "/docs/sandbox.md"],
    ["/en/docs/sandbox/microsandbox.mdx", "/docs/sandbox.mdx"],
  ])("redirects %s to %s", (source, destination) => {
    expect(docsRedirects).toContainEqual({ source, destination, permanent: true });
  });
});

describe("project structure redirects", () => {
  it.each(["", ".md", ".mdx"])("preserves the %s representation at both old paths", (extension) => {
    for (const prefix of ["/docs", "/en/docs"]) {
      expect(docsRedirects).toContainEqual({
        source: `${prefix}/getting-started/project-structure${extension}`,
        destination: `/docs/concepts/project-structure${extension}`,
        permanent: true,
      });
    }
  });
});

describe("rootMarkdownRedirects", () => {
  it.each([
    ["/getting-started.mdx", "/docs/getting-started.mdx"],
    ["/installation.md", "/docs/getting-started.md"],
    ["/project-structure.mdx", "/docs/concepts/project-structure.mdx"],
    ["/tools/overview.md", "/docs/tools.md"],
    ["/channels/eve.mdx", "/docs/channels/eve.mdx"],
  ])("redirects observed root Markdown alias %s to %s", (source, destination) => {
    expect(rootMarkdownRedirects).toContainEqual({ source, destination, permanent: true });
  });

  it("does not create extensionless root redirects", () => {
    expect(
      rootMarkdownRedirects.some(
        ({ source }) => !source.endsWith(".md") && !source.endsWith(".mdx"),
      ),
    ).toBe(false);
  });
});

describe("compatibilityRedirects", () => {
  it("redirects the previous benchmark route", () => {
    expect(compatibilityRedirects).toContainEqual({
      source: "/evals",
      destination: "/benchmarks",
      permanent: true,
    });
  });

  it("redirects the Arcana extension registry item to its memory provider", () => {
    expect(compatibilityRedirects).toContainEqual({
      source: "/r/extension/arcana.json",
      destination: "/r/memory/arcana.json",
      permanent: true,
    });
  });

  it("redirects the Upstash AgentKit extension registry item to its memory provider", () => {
    expect(compatibilityRedirects).toContainEqual({
      source: "/r/extension/upstash-agentkit.json",
      destination: "/r/memory/upstash-agentkit.json",
      permanent: true,
    });
  });

  it("redirects the Hindsight extension registry item to its memory provider", () => {
    expect(compatibilityRedirects).toContainEqual({
      source: "/r/extension/hindsight.json",
      destination: "/r/memory/hindsight.json",
      permanent: true,
    });
  });
});

describe("defaultLanguageRedirects", () => {
  it("redirects observed locale aliases directly to their canonical destination", () => {
    expect(defaultLanguageRedirects).toEqual([
      {
        source: "/en/docs",
        destination: "/docs/getting-started",
        permanent: true,
      },
      {
        source: "/en/resources",
        destination: "/templates",
        permanent: true,
      },
      {
        source: "/en/:path*",
        destination: "/:path*",
        permanent: true,
      },
    ]);
  });
});

describe("all redirects", () => {
  const redirects = [
    ...compatibilityRedirects,
    ...docsRedirects,
    ...rootMarkdownRedirects,
    ...defaultLanguageRedirects,
  ];

  it("has no duplicate sources", () => {
    const sources = redirects.map(({ source }) => source);
    expect(new Set(sources).size).toBe(sources.length);
  });

  it("has no redirect loops", () => {
    const destinations = new Map(redirects.map(({ source, destination }) => [source, destination]));

    for (const { source } of redirects) {
      const visited = new Set<string>();
      let current: string | undefined = source;
      while (current && destinations.has(current)) {
        expect(visited.has(current), `redirect loop from ${source}`).toBe(false);
        visited.add(current);
        current = destinations.get(current);
      }
    }
  });
});