castor-mcp 0.6.0

package/build/tools/content.js

@@ -0,0 +1,246 @@
+import { z } from "zod";
+import { withConfluenceErrorHandling } from "./errors.js";
+import { jsonDetailBlock, MAX_LIST_RESULTS } from "./spaces-pages.js";
+export function projectContentSummary(raw) {
+    return {
+        id: raw.id,
+        title: raw.title,
+        type: raw.type,
+        status: raw.status,
+        spaceKey: raw.space?.key ?? null,
+    };
+}
+export const ListContentArgsSchema = z.object({
+    spaceKey: z.string().optional(),
+    type: z.string().optional().describe('e.g. "page", "blogpost".'),
+    title: z.string().optional(),
+    status: z.string().optional().describe('e.g. "current", "trashed", "draft".'),
+    limit: z.number().int().positive().max(MAX_LIST_RESULTS).optional(),
+});
+export async function listContent(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        // Confluence's default GET /content response omits `space` unless explicitly expanded —
+        // confirmed live (2026-08-20): without this, every projected item's spaceKey came back null
+        // even when a real space owned the content.
+        const response = await client.get("/rest/api/content", {
+            spaceKey: args.spaceKey,
+            type: args.type,
+            title: args.title,
+            status: args.status,
+            limit: args.limit,
+            expand: "space",
+        });
+        const items = (response.data.results ?? []).slice(0, MAX_LIST_RESULTS).map(projectContentSummary);
+        return {
+            content: [
+                { type: "text", text: `✅ ${items.length} content item(s) visible` },
+                jsonDetailBlock(items),
+            ],
+        };
+    });
+}
+export const DeletePageArgsSchema = z.object({
+    pageId: z.string().min(1),
+    status: z
+        .string()
+        .optional()
+        .describe('Pass "trashed" (matching the page\'s current status) to permanently purge an already-' +
+        'trashed page. Omit to trash a current page — passing "current" here does nothing.'),
+});
+export async function deletePage(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        await client.delete(`/rest/api/content/${encodeURIComponent(args.pageId)}`, { status: args.status });
+        return { content: [{ type: "text", text: `✅ Page ${args.pageId} deleted` }] };
+    });
+}
+export const GetPageHistoryArgsSchema = z.object({ pageId: z.string().min(1) });
+// The swagger schema's ReferenceVersion is a thin lazy-loaded wrapper ({idProperties, expanded}) —
+// confirmed live (2026-08-20) that the real, non-expanded response nests the useful fields
+// (`by`, `when`, `number`) directly, not under `idProperties`. Read defensively either way.
+function projectVersionRef(raw) {
+    const by = raw?.by?.displayName ?? raw?.idProperties?.by?.displayName ?? null;
+    const when = raw?.when ?? raw?.idProperties?.when ?? null;
+    const number = raw?.number ?? raw?.idProperties?.number ?? null;
+    return { by, when, number };
+}
+export async function getPageHistory(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/${encodeURIComponent(args.pageId)}/history`);
+        const raw = response.data;
+        const lastUpdated = projectVersionRef(raw.lastUpdated);
+        const projected = {
+            latest: raw.latest ?? null,
+            createdByDisplayName: raw.createdBy?.displayName ?? null,
+            createdDate: raw.createdDate ?? null,
+            lastUpdatedByDisplayName: lastUpdated.by,
+            lastUpdatedWhen: lastUpdated.when,
+            lastUpdatedVersionNumber: lastUpdated.number,
+        };
+        return {
+            content: [
+                { type: "text", text: `✅ History for page ${args.pageId} retrieved` },
+                jsonDetailBlock(projected),
+            ],
+        };
+    });
+}
+const MacroArgsBase = { pageId: z.string().min(1), version: z.number().int().positive() };
+export const GetPageMacroBodyByHashArgsSchema = z.object({ ...MacroArgsBase, hash: z.string().min(1) });
+function projectMacroInstance(raw) {
+    return { name: raw.name ?? null, body: raw.body ?? null, parameters: raw.parameters ?? {} };
+}
+export async function getPageMacroBodyByHash(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/${encodeURIComponent(args.pageId)}/history/${args.version}/macro/hash/${encodeURIComponent(args.hash)}`);
+        const macro = projectMacroInstance(response.data);
+        return {
+            content: [
+                { type: "text", text: `✅ Macro body retrieved (hash ${args.hash})` },
+                jsonDetailBlock(macro),
+            ],
+        };
+    });
+}
+export const GetPageMacroBodyByIdArgsSchema = z.object({ ...MacroArgsBase, macroId: z.string().min(1) });
+export async function getPageMacroBodyById(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/${encodeURIComponent(args.pageId)}/history/${args.version}/macro/id/${encodeURIComponent(args.macroId)}`);
+        const macro = projectMacroInstance(response.data);
+        return {
+            content: [
+                { type: "text", text: `✅ Macro body retrieved (macroId ${args.macroId})` },
+                jsonDetailBlock(macro),
+            ],
+        };
+    });
+}
+function projectContentProperty(raw) {
+    return { id: raw.id, key: raw.key, value: raw.value, version: raw.version?.number ?? null };
+}
+export const ListPagePropertiesArgsSchema = z.object({ pageId: z.string().min(1) });
+export async function listPageProperties(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/${encodeURIComponent(args.pageId)}/property`);
+        const properties = (response.data.results ?? []).map(projectContentProperty);
+        return {
+            content: [
+                { type: "text", text: `✅ ${properties.length} propert(y/ies) on page ${args.pageId}` },
+                jsonDetailBlock(properties),
+            ],
+        };
+    });
+}
+export const GetPagePropertyArgsSchema = z.object({ pageId: z.string().min(1), key: z.string().min(1) });
+export async function getPageProperty(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/${encodeURIComponent(args.pageId)}/property/${encodeURIComponent(args.key)}`);
+        const property = projectContentProperty(response.data);
+        return {
+            content: [
+                { type: "text", text: `✅ Property "${args.key}" on page ${args.pageId} retrieved` },
+                jsonDetailBlock(property),
+            ],
+        };
+    });
+}
+export const CreatePagePropertyArgsSchema = z.object({
+    pageId: z.string().min(1),
+    key: z.string().min(1),
+    value: z.unknown().describe("Any JSON-serializable value."),
+});
+export async function createPageProperty(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post(`/rest/api/content/${encodeURIComponent(args.pageId)}/property`, {
+            key: args.key,
+            value: args.value,
+        });
+        const property = projectContentProperty(response.data);
+        return {
+            content: [
+                { type: "text", text: `✅ Property "${args.key}" created on page ${args.pageId}` },
+                jsonDetailBlock(property),
+            ],
+        };
+    });
+}
+export const UpdatePagePropertyArgsSchema = z.object({
+    pageId: z.string().min(1),
+    key: z.string().min(1),
+    value: z.unknown(),
+    currentVersion: z.number().int().positive().describe("From list_page_properties/get_page_property's version field."),
+});
+export async function updatePageProperty(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put(`/rest/api/content/${encodeURIComponent(args.pageId)}/property/${encodeURIComponent(args.key)}`, { key: args.key, value: args.value, version: { number: args.currentVersion + 1 } });
+        const property = projectContentProperty(response.data);
+        return {
+            content: [
+                { type: "text", text: `✅ Property "${args.key}" updated to v${property.version} on page ${args.pageId}` },
+                jsonDetailBlock(property),
+            ],
+        };
+    });
+}
+export const DeletePagePropertyArgsSchema = z.object({ pageId: z.string().min(1), key: z.string().min(1) });
+export async function deletePageProperty(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        await client.delete(`/rest/api/content/${encodeURIComponent(args.pageId)}/property/${encodeURIComponent(args.key)}`);
+        return { content: [{ type: "text", text: `✅ Property "${args.key}" deleted from page ${args.pageId}` }] };
+    });
+}
+export const DeletePageVersionArgsSchema = z.object({
+    pageId: z.string().min(1),
+    versionNumber: z.number().int().positive(),
+});
+export async function deletePageVersion(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        await client.delete(`/rest/api/content/${encodeURIComponent(args.pageId)}/version/${args.versionNumber}`);
+        return { content: [{ type: "text", text: `✅ Version ${args.versionNumber} of page ${args.pageId} deleted` }] };
+    });
+}
+export const ScanContentArgsSchema = z.object({
+    spaceKey: z.string().optional(),
+    type: z.string().optional(),
+    cursor: z.string().optional().describe("From a previous scan_content call's nextCursor."),
+    limit: z.number().int().positive().max(MAX_LIST_RESULTS).optional(),
+});
+export async function scanContent(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/content/scan", {
+            spaceKey: args.spaceKey,
+            type: args.type,
+            cursor: args.cursor,
+            limit: args.limit,
+            expand: "space",
+        });
+        const items = (response.data.results ?? []).slice(0, MAX_LIST_RESULTS).map(projectContentSummary);
+        const nextCursor = response.data.nextCursor ?? null;
+        return {
+            content: [
+                { type: "text", text: `✅ ${items.length} content item(s) scanned${nextCursor ? " (more available)" : ""}` },
+                jsonDetailBlock({ items, nextCursor }),
+            ],
+        };
+    });
+}
+export const ConvertContentBodyArgsSchema = z.object({
+    value: z.string().min(1),
+    from: z.string().describe('Source representation, e.g. "storage", "wiki", "view".'),
+    to: z.string().describe('Target representation, e.g. "view", "storage", "export_view".'),
+});
+export async function convertContentBody(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post(`/rest/api/contentbody/convert/${encodeURIComponent(args.to)}`, {
+            value: args.value,
+            representation: args.from,
+        });
+        const body = { value: response.data.value, representation: response.data.representation };
+        return {
+            content: [
+                { type: "text", text: `✅ Converted body from ${args.from} to ${args.to}` },
+                jsonDetailBlock(body),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=content.js.map

package/build/tools/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/tools/content.ts"],"names":[],"mappings":"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"}

package/build/tools/errors.d.ts

@@ -0,0 +1,3 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export declare function mapConfluenceError(error: unknown): McpError;
+export declare function withConfluenceErrorHandling<T>(fn: () => Promise<T>): Promise<T>;

package/build/tools/errors.js

@@ -0,0 +1,55 @@
+import axios from "axios";
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+const MAX_ERROR_BODY_LENGTH = 500;
+const TRUNCATION_MARKER = "... (truncated)";
+function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength) + TRUNCATION_MARKER;
+}
+/** Confluence's validation error shape: `{ message: string, statusCode?: number }`. */
+function extractValidationMessage(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const body = data;
+    return typeof body.message === "string" && body.message.length > 0 ? body.message : null;
+}
+export function mapConfluenceError(error) {
+    if (axios.isAxiosError(error) && error.response) {
+        const status = error.response.status;
+        const validationMessage = extractValidationMessage(error.response.data);
+        if (status === 401) {
+            return new McpError(ErrorCode.InvalidRequest, "Confluence rejected the request (401 Unauthorized) — check your CONFLUENCE_USER_TOKEN/CONFLUENCE_ADMIN_TOKEN.");
+        }
+        if (status === 403) {
+            return new McpError(ErrorCode.InvalidRequest, "Confluence denied permission (403 Forbidden) for this operation under the acting token's permissions.");
+        }
+        if (status === 404) {
+            return new McpError(ErrorCode.InvalidRequest, "Confluence could not find the requested resource (404 Not Found).");
+        }
+        if (status === 400) {
+            return new McpError(ErrorCode.InvalidRequest, validationMessage
+                ? `Confluence rejected the request (400 Bad Request): ${validationMessage}`
+                : "Confluence rejected the request (400 Bad Request) — no further validation detail was provided.");
+        }
+        if (status === 409) {
+            return new McpError(ErrorCode.InvalidRequest, `Confluence rejected the request (409 Conflict) — likely a page version mismatch; ` +
+                `call get_page again for the current version before retrying update_page.` +
+                (validationMessage ? ` Detail: ${validationMessage}` : ""));
+        }
+        if (status === 429) {
+            return new McpError(ErrorCode.InternalError, "Confluence rate-limited the request (429 Too Many Requests) — this is retryable; back off and try again.");
+        }
+        return new McpError(ErrorCode.InternalError, `Confluence API error ${status}: ${truncate(JSON.stringify(error.response.data), MAX_ERROR_BODY_LENGTH)}`);
+    }
+    return new McpError(ErrorCode.InternalError, error instanceof Error ? error.message : String(error));
+}
+export async function withConfluenceErrorHandling(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        throw mapConfluenceError(error);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/tools/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAE5C,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAiB;IAC/C,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,iBAAiB,CAAC;AACtD,CAAC;AAED,uFAAuF;AACvF,SAAS,wBAAwB,CAAC,IAAa;IAC7C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,IAA6B,CAAC;IAC3C,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxE,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,QAAQ,CACjB,SAAS,CAAC,cAAc,EACxB,+GAA+G,CAChH,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,QAAQ,CACjB,SAAS,CAAC,cAAc,EACxB,uGAAuG,CACxG,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,mEAAmE,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,QAAQ,CACjB,SAAS,CAAC,cAAc,EACxB,iBAAiB;gBACf,CAAC,CAAC,sDAAsD,iBAAiB,EAAE;gBAC3E,CAAC,CAAC,gGAAgG,CACrG,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,QAAQ,CACjB,SAAS,CAAC,cAAc,EACxB,mFAAmF;gBACjF,0EAA0E;gBAC1E,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,QAAQ,CACjB,SAAS,CAAC,aAAa,EACvB,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,QAAQ,CACjB,SAAS,CAAC,aAAa,EACvB,wBAAwB,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC,EAAE,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACvG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAI,EAAoB;IACvE,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/build/tools/index-management.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { ConfluenceClient } from "../confluence-client.js";
+import { ToolResult } from "./spaces-pages.js";
+export declare const GetReindexStatusArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetReindexStatusArgs = z.infer<typeof GetReindexStatusArgsSchema>;
+export declare function getReindexStatus(client: ConfluenceClient, _args: GetReindexStatusArgs): Promise<ToolResult>;
+export declare const TriggerReindexArgsSchema: z.ZodObject<{
+    confirm: z.ZodBoolean;
+    spaceKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    confirm: boolean;
+    spaceKey?: string | undefined;
+}, {
+    confirm: boolean;
+    spaceKey?: string | undefined;
+}>;
+export type TriggerReindexArgs = z.infer<typeof TriggerReindexArgsSchema>;
+export declare function triggerReindex(client: ConfluenceClient, args: TriggerReindexArgs): Promise<ToolResult>;
+export declare const ResetReindexJobArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type ResetReindexJobArgs = z.infer<typeof ResetReindexJobArgsSchema>;
+export declare function resetReindexJob(client: ConfluenceClient, _args: ResetReindexJobArgs): Promise<ToolResult>;
+export declare const UnindexAllContentArgsSchema: z.ZodObject<{
+    confirm: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    confirm: boolean;
+}, {
+    confirm: boolean;
+}>;
+export type UnindexAllContentArgs = z.infer<typeof UnindexAllContentArgsSchema>;
+export declare function unindexAllContent(client: ConfluenceClient, args: UnindexAllContentArgs): Promise<ToolResult>;

package/build/tools/index-management.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { withConfluenceErrorHandling } from "./errors.js";
+import { jsonDetailBlock } from "./spaces-pages.js";
+export const GetReindexStatusArgsSchema = z.object({});
+export async function getReindexStatus(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/index/reindex");
+        return {
+            content: [
+                { type: "text", text: "✅ Reindex status retrieved" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const TriggerReindexArgsSchema = z.object({
+    confirm: z.boolean().describe("Must be true — rebuilding the search index is resource-intensive and disruptive while running."),
+    spaceKey: z.string().optional().describe("Omit to reindex the entire instance."),
+});
+export async function triggerReindex(client, args) {
+    if (!args.confirm) {
+        throw new McpError(ErrorCode.InvalidParams, "trigger_reindex requires confirm: true — this rebuilds the search index, which is resource-intensive and disrupts search while running.");
+    }
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post(`/rest/api/index/reindex${args.spaceKey ? `?spaceKey=${encodeURIComponent(args.spaceKey)}` : ""}`);
+        return {
+            content: [
+                { type: "text", text: `✅ Reindex triggered${args.spaceKey ? ` for space ${args.spaceKey}` : " for the entire instance"}` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const ResetReindexJobArgsSchema = z.object({});
+export async function resetReindexJob(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put("/rest/api/index/resetjob");
+        return {
+            content: [
+                { type: "text", text: "✅ Reindex job status reset" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const UnindexAllContentArgsSchema = z.object({
+    confirm: z.boolean().describe("Must be true — this removes ALL content from the search index; search returns nothing until a reindex completes."),
+});
+export async function unindexAllContent(client, args) {
+    if (!args.confirm) {
+        throw new McpError(ErrorCode.InvalidParams, "unindex_all_content requires confirm: true — this removes ALL content from the search index until a reindex completes.");
+    }
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/index/unindex");
+        return {
+            content: [
+                { type: "text", text: "✅ All content removed from the search index — trigger_reindex to restore search" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index-management.js.map

package/build/tools/index-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-management.js","sourceRoot":"","sources":["../../src/tools/index-management.ts"],"names":[],"mappings":"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"}

package/build/tools/labels.d.ts

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { ConfluenceClient } from "../confluence-client.js";
+import { ToolResult } from "./spaces-pages.js";
+export declare const ListPageLabelsArgsSchema: z.ZodObject<{
+    pageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    pageId: string;
+}, {
+    pageId: string;
+}>;
+export type ListPageLabelsArgs = z.infer<typeof ListPageLabelsArgsSchema>;
+export declare function listPageLabels(client: ConfluenceClient, args: ListPageLabelsArgs): Promise<ToolResult>;
+export declare const AddPageLabelsArgsSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    names: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    pageId: string;
+    names: string[];
+}, {
+    pageId: string;
+    names: string[];
+}>;
+export type AddPageLabelsArgs = z.infer<typeof AddPageLabelsArgsSchema>;
+export declare function addPageLabels(client: ConfluenceClient, args: AddPageLabelsArgs): Promise<ToolResult>;
+export declare const DeletePageLabelArgsSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    pageId: string;
+    label: string;
+}, {
+    pageId: string;
+    label: string;
+}>;
+export type DeletePageLabelArgs = z.infer<typeof DeletePageLabelArgsSchema>;
+export declare function deletePageLabel(client: ConfluenceClient, args: DeletePageLabelArgs): Promise<ToolResult>;
+export declare const GetRelatedLabelsArgsSchema: z.ZodObject<{
+    labelName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    labelName: string;
+}, {
+    labelName: string;
+}>;
+export type GetRelatedLabelsArgs = z.infer<typeof GetRelatedLabelsArgsSchema>;
+export declare function getRelatedLabels(client: ConfluenceClient, args: GetRelatedLabelsArgs): Promise<ToolResult>;
+export declare const SearchLabelsArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    labelName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    spaceKey?: string | undefined;
+    labelName?: string | undefined;
+    owner?: string | undefined;
+    namespace?: string | undefined;
+}, {
+    spaceKey?: string | undefined;
+    labelName?: string | undefined;
+    owner?: string | undefined;
+    namespace?: string | undefined;
+}>;
+export type SearchLabelsArgs = z.infer<typeof SearchLabelsArgsSchema>;
+export declare function searchLabels(client: ConfluenceClient, args: SearchLabelsArgs): Promise<ToolResult>;
+export declare const GetPopularLabelsArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetPopularLabelsArgs = z.infer<typeof GetPopularLabelsArgsSchema>;
+export declare function getPopularLabels(client: ConfluenceClient, _args: GetPopularLabelsArgs): Promise<ToolResult>;
+export declare const GetRecentLabelsArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetRecentLabelsArgs = z.infer<typeof GetRecentLabelsArgsSchema>;
+export declare function getRecentLabels(client: ConfluenceClient, _args: GetRecentLabelsArgs): Promise<ToolResult>;
+export declare const ListSpaceLabelsArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type ListSpaceLabelsArgs = z.infer<typeof ListSpaceLabelsArgsSchema>;
+export declare function listSpaceLabels(client: ConfluenceClient, args: ListSpaceLabelsArgs): Promise<ToolResult>;
+export declare const GetSpaceRelatedLabelsArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    labelName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    labelName: string;
+}, {
+    spaceKey: string;
+    labelName: string;
+}>;
+export type GetSpaceRelatedLabelsArgs = z.infer<typeof GetSpaceRelatedLabelsArgsSchema>;
+export declare function getSpaceRelatedLabels(client: ConfluenceClient, args: GetSpaceRelatedLabelsArgs): Promise<ToolResult>;
+export declare const GetSpacePopularLabelsArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type GetSpacePopularLabelsArgs = z.infer<typeof GetSpacePopularLabelsArgsSchema>;
+export declare function getSpacePopularLabels(client: ConfluenceClient, args: GetSpacePopularLabelsArgs): Promise<ToolResult>;
+export declare const GetSpaceRecentLabelsArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type GetSpaceRecentLabelsArgs = z.infer<typeof GetSpaceRecentLabelsArgsSchema>;
+export declare function getSpaceRecentLabels(client: ConfluenceClient, args: GetSpaceRecentLabelsArgs): Promise<ToolResult>;