shockbot/mcp/shared.ts

import { Octokit } from "@octokit/rest";
import type { StandardSchemaV1 } from "@standard-schema/spec";
import type { FastMCP, Tool } from "fastmcp";
import type { Payload } from "../external.ts";
import { log } from "../utils/cli.ts";
import { parseRepoContext, type RepoContext } from "../utils/github.ts";

export interface ToolResult {
  content: {
    type: "text";
    text: string;
  }[];
  isError?: boolean;
}

export function getPayload(): Payload {
  const payloadEnv = process.env.PULLFROG_PAYLOAD;
  if (!payloadEnv) {
    throw new Error("PULLFROG_PAYLOAD environment variable is required");
  }

  try {
    return JSON.parse(payloadEnv) as Payload;
  } catch (error) {
    throw new Error(
      `Failed to parse PULLFROG_PAYLOAD: ${error instanceof Error ? error.message : String(error)}`
    );
  }
}

export function getMcpContext(): McpContext {
  const githubInstallationToken = process.env.GITHUB_INSTALLATION_TOKEN;
  if (!githubInstallationToken) {
    throw new Error("GITHUB_INSTALLATION_TOKEN environment variable is required");
  }

  return {
    ...parseRepoContext(),
    octokit: new Octokit({
      auth: githubInstallationToken,
    }),
    payload: getPayload(),
  };
}

export interface McpContext extends RepoContext {
  octokit: Octokit;
  payload: Payload;
}

export const tool = <const params>(toolDef: Tool<any, StandardSchemaV1<params>>) => {
  // Wrap the execute function to add logging with the tool name
  const toolName = toolDef.name;
  const originalExecute = toolDef.execute;

  toolDef.execute = async (args: params, context: any) => {
    try {
      const result = await originalExecute(args, context);

      // TOOL CALL LOGGING DISABLED — now handled by each agent

      // Check if result is a ToolResult with isError property
      // const isError =
      //   result && typeof result === "object" && "isError" in result && result.isError === true;
      // const resultData =
      //   result && typeof result === "object" && "content" in result
      //     ? (result as ToolResult).content[0]?.text
      //     : undefined;

      // if (isError && resultData) {
      //   log.toolCall({ toolName, request: args, error: resultData });
      // } else if (resultData) {
      //   log.toolCall({ toolName, request: args, result: resultData });
      // } else {
      //   log.toolCall({ toolName, request: args });
      // }
      return result;
    } catch (error) {
      // const errorMessage = error instanceof Error ? error.message : String(error);
      // log.toolCall({ toolName, request: args, error: errorMessage });
      throw error;
    }
  };

  return toolDef;
};

export const addTools = (server: FastMCP, tools: Tool<any, any>[]) => {
  for (const tool of tools) {
    server.addTool(tool);
  }
  return server;
};

export const contextualize =
  <T>(executor: (params: T, ctx: McpContext) => Promise<Record<string, any>>) =>
  async (params: T): Promise<ToolResult> => {
    try {
      const ctx = getMcpContext();
      const result = await executor(params, ctx);
      return handleToolSuccess(result);
    } catch (error) {
      return handleToolError(error);
    }
  };

const handleToolSuccess = (data: Record<string, any>): ToolResult => {
  return {
    content: [
      {
        type: "text",
        text: JSON.stringify(data, null, 2),
      },
    ],
  };
};

const handleToolError = (error: unknown): ToolResult => {
  const errorMessage = error instanceof Error ? error.message : String(error);
  return {
    content: [
      {
        type: "text",
        text: `Error: ${errorMessage}`,
      },
    ],
    isError: true,
  };
};