import { z } from "zod";
import { AdoClient } from "../../ado-client.js";
export const listWikisSchema = z.object({
project: z.string().optional().describe("Project name, defaults to ADO_PROJECT env var"),
});
export const listWikisTool = {
name: "list_wikis",
description: "List all wikis in a project. Azure DevOps supports project wikis (managed by ADO) and code wikis (published from Git repos). Returns wiki ID, name, and type. Use this to discover wikis before accessing their pages.",
inputSchema: {
type: "object" as const,
properties: {
project: {
type: "string",
description: "Project name, defaults to ADO_PROJECT env var",
},
},
required: [],
},
};
export interface WikiSummary {
id: string;
name: string;
type: string;
url: string;
}
export async function listWikis(
client: AdoClient,
params: z.infer<typeof listWikisSchema>
): Promise<WikiSummary[]> {
const validatedParams = listWikisSchema.parse(params);
const project = client.resolveProject(validatedParams.project);
const wikiApi = await client.getWikiApi();
const wikis = await wikiApi.getAllWikis(project);
if (!wikis) {
return [];
}
return wikis.map((wiki) => ({
id: wiki.id || "",
name: wiki.name || "",
type: wiki.type !== undefined ? getWikiTypeString(wiki.type) : "unknown",
url: wiki.url || "",
}));
}
function getWikiTypeString(type: number): string {
switch (type) {
case 0:
return "projectWiki";
case 1:
return "codeWiki";
default:
return "unknown";
}
}
