GET_USER_CREATED_WIKIS

Instructions

Implementation Reference

• src/index.ts:18-18 (registration)

  Registration of the GET_USER_CREATED_WIKIS tool via server.addTool()

  server.addTool(getUserCreatedWikisTool);

• src/tools/get-user-created-wikis.ts:14-32 (handler)

  Tool definition with name 'GET_USER_CREATED_WIKIS', parameter schema, and execute function that calls the service

  export const getUserCreatedWikisTool = {
  	name: "GET_USER_CREATED_WIKIS",
  	description: "Get wikis created by a specific user on IQ.wiki",
  	parameters: getUserCreatedWikisParams,
  	execute: async (params: GetUserCreatedWikisParams) => {
  		try {
  			const service = new GetUserCreatedWikisService();
  			const wikis = await service.execute(params.id, params.timeFrameSeconds);
  
  			return service.format(wikis);
  		} catch (error) {
  			if (error instanceof Error) {
  				console.log(`Error in GET_USER_CREATED_WIKIS tool: ${error.message}`);
  				return `Error retrieving user created wikis: ${error.message}`;
  			}
  			return "An unknown error occurred while fetching user created wikis";
  		}
  	},
  } as const;

• src/tools/get-user-created-wikis.ts:4-10 (schema)

  Zod schema defining input parameters: id (string) and optional timeFrameSeconds (number)

  const getUserCreatedWikisParams = z.object({
  	id: z.string().min(1).describe("The Ethereum address of the user"),
  	timeFrameSeconds: z
  		.number()
  		.optional()
  		.describe("Optional time frame in seconds to filter results"),
  });

• src/services/get-user-created-wikis.ts:6-72 (handler)

  Service class with execute() method fetching wikis from GraphQL and format() method producing formatted output

  export class GetUserCreatedWikisService {
  	async execute(id: string, timeFrameSeconds?: number) {
  		try {
  			const response: any = await client.request(USER_CREATED_WIKIS_QUERY, {
  				id,
  			});
  
  			if (!response.userById) {
  				throw new Error("user does not exist");
  			}
  			if (!response.userById.wikisCreated.activity) {
  				throw new Error("user has not created any wikis");
  			}
  
  			let wikis = response.userById.wikisCreated.activity[0].content;
  
  			// Filter by time if timeFrameSeconds is provided
  			if (timeFrameSeconds) {
  				const now = new Date();
  				const timeLimit = new Date(now.getTime() - timeFrameSeconds * 1000);
  
  				// Filter wikis by creation time
  				wikis = wikis.filter((wiki: any) => {
  					if (!wiki.created) return false;
  					const wikiDate = new Date(wiki.created);
  					return wikiDate >= timeLimit;
  				});
  
  				if (wikis.length === 0) {
  					// Convert seconds to a human-readable format for the error message
  					const timeFrameText =
  						timeFrameSeconds >= 86400
  							? `${timeFrameSeconds / 86400} day(s)`
  							: timeFrameSeconds >= 3600
  								? `${timeFrameSeconds / 3600} hour(s)`
  								: `${timeFrameSeconds / 60} minute(s)`;
  
  					throw new Error(
  						`No created wikis found in the last ${timeFrameText}`,
  					);
  				}
  			}
  
  			return wikis;
  		} catch (error: any) {
  			throw new Error(error.message);
  		}
  	}
  
  	format(wikis: any) {
  		return wikis
  			.map((wiki: any) => {
  				const date = new Date(wiki.created);
  				const formattedDate = date.toLocaleString();
  
  				return dedent`
  						📜 Wiki Created
  						- Title: ${wiki.title}
  						- Summary: ${wiki.summary}
  						- Created: ${formattedDate}
  
  						🔗 Source: ${IQ_BASE_URL}/${wiki.id}
  						🔗 Transaction: https://polygonscan.com/tx/${wiki.transactionHash}
  					`;
  			})
  			.join("\n\n");
  	}

• src/lib/queries.ts:3-45 (helper)

  GraphQL query (USER_CREATED_WIKIS_QUERY) used to fetch user-created wikis from the API

  export const USER_CREATED_WIKIS_QUERY = graphql(`
    query userCreatedWikis($id: String!) {
      userById(id: $id) {
        wikisCreated {
          ... on UserActivity {
            activity {
              content {
                id
                ipfs
                transactionHash
                title
                created
                updated
                summary
                categories {
                  id
                  title
                }
                tags {
                  id
                }
                images {
                  id
                  type
                }
                metadata {
                  id
                  value
                }
                user {
                  id
                  profile {
                    username
                    avatar
                  }
                }
              }
            }
          }
        }
      }
    }
  `);