@pagopa/dx-mcpserver 0.0.12 → 0.1.2

package/dist/auth/github.js

@@ -1,38 +0,0 @@
-import { getLogger } from "@logtape/logtape";
-import { Octokit } from "@octokit/rest";
-import { z } from "zod/v4";
-const organizationsSchema = z
-    .array(z.string().nonempty())
-    .nonempty()
-    .transform((orgs) => orgs.map((org) => org.trim()))
-    .catch(["pagopa"]);
-const REQUIRED_ORGANIZATIONS = organizationsSchema.parse(process.env.REQUIRED_ORGANIZATIONS);
-/**
- * Verifies that a user, identified by a GitHub personal access token, is a member
- * of at least one of the required GitHub organizations.
- * @param token The user's GitHub personal access token.
- * @returns A boolean indicating whether the user is a member of a required organization.
- */
-export async function verifyGithubUser(token) {
-    const logger = getLogger(["mcpserver", "github-auth"]);
-    if (!token) {
-        return false;
-    }
-    const octokit = new Octokit({ auth: token });
-    try {
-        // Fetches the user's organization memberships using Octokit.
-        const { data: organizations } = await octokit.rest.orgs.listForAuthenticatedUser();
-        const isMember = organizations.some((org) => REQUIRED_ORGANIZATIONS.includes(org.login));
-        if (isMember) {
-            logger.debug(`User is a member of one of the required organizations: ${REQUIRED_ORGANIZATIONS.join(", ")}`);
-        }
-        else {
-            logger.warn(`User is not a member of any of the required organizations: ${REQUIRED_ORGANIZATIONS.join(", ")}`);
-        }
-        return isMember;
-    }
-    catch (error) {
-        logger.error("Error verifying GitHub organization membership", { error });
-        return false;
-    }
-}

package/dist/config/__tests__/awsConfig.test.js

@@ -1,17 +0,0 @@
-import { describe, expect, it } from "vitest";
-import * as awsConfig from "../aws.js";
-describe("aws config", () => {
-    it("should export kbRerankingEnabled as boolean", () => {
-        expect(typeof awsConfig.kbRerankingEnabled).toBe("boolean");
-    });
-    it("should export knowledgeBaseId as string", () => {
-        expect(typeof awsConfig.knowledgeBaseId).toBe("string");
-    });
-    it("should export region as string", () => {
-        expect(typeof awsConfig.region).toBe("string");
-    });
-    it("should export kbRuntimeClient as object", () => {
-        expect(typeof awsConfig.kbRuntimeClient).toBe("object");
-        expect(awsConfig.kbRuntimeClient).toHaveProperty("send");
-    });
-});

package/dist/tools/QueryPagoPADXDocumentation.js

@@ -1,35 +0,0 @@
-import { z } from "zod";
-import { kbRerankingEnabled, kbRuntimeClient, knowledgeBaseId, } from "../config/aws.js";
-import { queryKnowledgeBase } from "../services/bedrock.js";
-/**
- * A tool that provides access to the complete PagoPA DX documentation.
- * It uses a Bedrock knowledge base to answer queries about DX tools, patterns, and best practices.
- */
-export const QueryPagoPADXDocumentationTool = {
-    annotations: {
-        title: "Query PagoPA DX documentation",
-    },
-    description: `This tool provides access to the complete PagoPA DX documentation covering:
-- Getting started, monorepo setup, dev containers, and GitHub collaboration
-- Git workflows and pull requests
-- DX pipelines setup and management
-- TypeScript development (npm scripts, ESLint, code review)
-- Terraform (folder structure, DX modules, Azure provider, pre-commit hooks, validation, deployment, drift detection)
-- Azure development (naming conventions, policies, IAM, API Management, monitoring, networking, deployments, static websites, Service Bus, data archiving)
-- Container development (Docker images)
-- Contributing to DX (Azure provider, Terraform modules, documentation)
-
-All prompts and questions should be written in English.
-For Terraform module details (input/output variables, examples), use the \`searchModules\` tool.
-`,
-    execute: async (args) => {
-        const result = await queryKnowledgeBase(knowledgeBaseId, args.query, kbRuntimeClient, undefined, kbRerankingEnabled);
-        return result;
-    },
-    name: "QueryPagoPADXTerraformDocumentation",
-    parameters: z.object({
-        query: z
-            .string()
-            .describe("A natural language query in English used to search the DX documentation for relevant information."),
-    }),
-};

package/dist/tools/SearchGitHubCode.js

@@ -1,84 +0,0 @@
-import { getLogger } from "@logtape/logtape";
-import { Octokit } from "@octokit/rest";
-import { z } from "zod";
-const defaultOrg = process.env.GITHUB_SEARCH_ORG || "pagopa";
-/**
- * A tool that searches for code in a GitHub organization.
- * Useful for finding examples of Terraform module usage or specific code patterns.
- */
-export const SearchGitHubCodeTool = {
-    annotations: {
-        title: "Search GitHub organization code",
-    },
-    description: `Search for code in a GitHub organization (defaults to pagopa).
-Use this to find examples of specific code patterns, such as Terraform module usage.
-For example, search for "pagopa-dx/azure-function-app/azurerm" to find examples of the azure-function-app module usage.
-Returns file contents matching the search query.`,
-    execute: async (args, context) => {
-        const logger = getLogger(["mcpserver", "github-search"]);
-        const org = defaultOrg;
-        const token = context.session?.token;
-        if (!token) {
-            throw new Error("GitHub token not available in session");
-        }
-        const octokit = new Octokit({ auth: token });
-        try {
-            const extensionFilter = args.extension
-                ? ` extension:${args.extension}`
-                : "";
-            const searchQuery = `${args.query} org:${org}${extensionFilter}`;
-            logger.info(`Searching GitHub: ${searchQuery}`);
-            const { data } = await octokit.rest.search.code({
-                per_page: 10,
-                q: searchQuery,
-            });
-            if (data.items.length === 0) {
-                return JSON.stringify({ message: "No results found", results: [] });
-            }
-            const results = await Promise.all(data.items.map(async (item) => {
-                try {
-                    const { data: fileContent } = await octokit.rest.repos.getContent({
-                        owner: org,
-                        path: item.path,
-                        repo: item.repository.name,
-                    });
-                    if ("content" in fileContent) {
-                        return {
-                            content: Buffer.from(fileContent.content, "base64").toString("utf-8"),
-                            path: item.path,
-                            repository: item.repository.full_name,
-                            url: item.html_url,
-                        };
-                    }
-                    return null;
-                }
-                catch (error) {
-                    logger.error(`Error fetching file ${item.path}`, { error });
-                    return null;
-                }
-            }));
-            const validResults = results.filter((r) => r !== null);
-            return JSON.stringify({
-                organization: org,
-                query: args.query,
-                results: validResults,
-                returned_results: validResults.length,
-                total_results: data.total_count,
-            });
-        }
-        catch (error) {
-            logger.error("Error searching GitHub code", { error });
-            throw error;
-        }
-    },
-    name: "SearchGitHubCode",
-    parameters: z.object({
-        extension: z
-            .string()
-            .optional()
-            .describe('File extension to filter results (e.g., "tf" for Terraform files, "py" for Python files). For example, you can use "tf" to find Terraform module usage examples.'),
-        query: z
-            .string()
-            .describe('Code search query (e.g., "pagopa-dx/azure-function-app/azurerm" to find Terraform module usage examples)'),
-    }),
-};

package/dist/tools/__tests__/QueryPagoPADXDocumentation.test.js

@@ -1,22 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-vi.mock("../../services/bedrock", () => ({
-    queryKnowledgeBase: vi.fn().mockResolvedValue("mocked result"),
-}));
-vi.mock("../../config/aws", () => ({
-    kbRerankingEnabled: false,
-    kbRuntimeClient: "mockClient",
-    knowledgeBaseId: "mockKbId",
-}));
-import { QueryPagoPADXDocumentationTool } from "../QueryPagoPADXDocumentation.js";
-describe("QueryPagoPADXDocumentationTool", () => {
-    it("should return results from the knowledge base", async () => {
-        const args = { number_of_results: 3, query: "test query" };
-        const result = await QueryPagoPADXDocumentationTool.execute(args);
-        expect(result).toBe("mocked result");
-    });
-    it("should use default number_of_results if not provided", async () => {
-        const args = { query: "test query" };
-        const result = await QueryPagoPADXDocumentationTool.execute(args);
-        expect(result).toBe("mocked result");
-    });
-});