castor-mcp 0.6.0

package/build/tools/backup-restore.js

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import { withConfluenceErrorHandling } from "./errors.js";
+import { jsonDetailBlock } from "./spaces-pages.js";
+const MULTIPART_UPLOAD_HEADERS = { "X-Atlassian-Token": "no-check", "Content-Type": undefined };
+// Backup files can be many megabytes — never embed one wholesale in a tool response. Below this
+// size, inline it as base64 (same convention as attachment upload/download elsewhere in this
+// project); above it, report metadata only and let the caller retrieve it another way.
+const MAX_INLINE_DOWNLOAD_BYTES = 200_000;
+export const AdminCreateSiteBackupJobArgsSchema = z.object({
+    skipAttachments: z.boolean().optional(),
+    keepPermanently: z.boolean().optional(),
+    fileNamePrefix: z.string().optional(),
+});
+export async function adminCreateSiteBackupJob(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/backup-restore/backup/site", {
+            skipAttachments: args.skipAttachments,
+            keepPermanently: args.keepPermanently,
+            fileNamePrefix: args.fileNamePrefix,
+        });
+        return {
+            content: [
+                { type: "text", text: "✅ Site backup job submitted" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const AdminCreateSpaceBackupJobArgsSchema = z.object({
+    spaceKeys: z.array(z.string()).min(1),
+    keepPermanently: z.boolean().optional(),
+    fileNamePrefix: z.string().optional(),
+});
+export async function adminCreateSpaceBackupJob(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/backup-restore/backup/space", {
+            spaceKeys: args.spaceKeys,
+            keepPermanently: args.keepPermanently,
+            fileNamePrefix: args.fileNamePrefix,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Space backup job submitted for ${args.spaceKeys.join(", ")}` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const AdminFindBackupRestoreJobsArgsSchema = z.object({
+    owner: z.string().optional(),
+    spaceKey: z.string().optional(),
+    jobScope: z.string().optional().describe('"SITE" or "SPACE".'),
+    jobOperation: z.string().optional().describe('"BACKUP" or "RESTORE".'),
+});
+// Confirmed live (2026-08-20): with no filters at all, this returns an empty array even when real
+// jobs exist (verified against a real completed job, findable by ID via admin_get_backup_restore_job
+// but absent from an unfiltered list). Either jobScope or jobOperation alone is enough to make real
+// jobs appear — the description below steers callers accordingly rather than letting an empty
+// result read as "no jobs have ever run."
+export async function adminFindBackupRestoreJobs(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/backup-restore/jobs", {
+            owner: args.owner,
+            spaceKey: args.spaceKey,
+            jobScope: args.jobScope,
+            jobOperation: args.jobOperation,
+        });
+        const jobs = response.data.results ?? [];
+        return {
+            content: [
+                { type: "text", text: `✅ ${jobs.length} job(s) found` },
+                jsonDetailBlock(jobs),
+            ],
+        };
+    });
+}
+export const AdminGetBackupRestoreJobArgsSchema = z.object({ jobId: z.string().min(1) });
+export async function adminGetBackupRestoreJob(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/backup-restore/jobs/${encodeURIComponent(args.jobId)}`);
+        return {
+            content: [
+                { type: "text", text: `✅ Job ${args.jobId} retrieved` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const AdminCancelBackupRestoreJobArgsSchema = z.object({ jobId: z.string().min(1) });
+export async function adminCancelBackupRestoreJob(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        await client.put(`/rest/api/backup-restore/jobs/${encodeURIComponent(args.jobId)}/cancel`);
+        return { content: [{ type: "text", text: `✅ Job ${args.jobId} cancelled` }] };
+    });
+}
+export const AdminDownloadBackupFileArgsSchema = z.object({ jobId: z.string().min(1) });
+export async function adminDownloadBackupFile(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/backup-restore/jobs/${encodeURIComponent(args.jobId)}/download`, undefined, "arraybuffer");
+        const bytes = Buffer.from(response.data);
+        const contentType = response.headers?.["content-type"] ?? "application/octet-stream";
+        if (bytes.length > MAX_INLINE_DOWNLOAD_BYTES) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Backup file for job ${args.jobId}: ${bytes.length} bytes, too large to inline (limit ${MAX_INLINE_DOWNLOAD_BYTES})`,
+                    },
+                    jsonDetailBlock({ sizeBytes: bytes.length, contentType }),
+                ],
+            };
+        }
+        return {
+            content: [
+                { type: "text", text: `✅ Backup file for job ${args.jobId} retrieved (${bytes.length} bytes)` },
+                jsonDetailBlock({ sizeBytes: bytes.length, contentType, contentBase64: bytes.toString("base64") }),
+            ],
+        };
+    });
+}
+export const AdminCancelAllQueuedBackupRestoreJobsArgsSchema = z.object({});
+export async function adminCancelAllQueuedBackupRestoreJobs(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        await client.put("/rest/api/backup-restore/jobs/clear-queue");
+        return { content: [{ type: "text", text: "✅ All queued backup/restore jobs cancelled" }] };
+    });
+}
+export const AdminListRestoreFilesArgsSchema = z.object({
+    jobScope: z.string().optional().describe('"SITE" or "SPACE".'),
+});
+export async function adminListRestoreFiles(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/backup-restore/restore/files", { jobScope: args.jobScope });
+        const files = response.data.results ?? [];
+        return {
+            content: [
+                { type: "text", text: `✅ ${files.length} file(s) available in the restore directory` },
+                jsonDetailBlock(files),
+            ],
+        };
+    });
+}
+const DESTRUCTIVE_RESTORE_NOTE = "DESTRUCTIVE — replaces live content with the backup's contents. There is no undo short of " +
+    "restoring a more recent backup.";
+export const AdminCreateSiteRestoreJobArgsSchema = z.object({
+    fileName: z.string().min(1).describe("A filename already present in the restore directory (see admin_list_restore_files)."),
+    skipReindex: z.boolean().optional(),
+});
+export async function adminCreateSiteRestoreJob(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/backup-restore/restore/site", {
+            fileName: args.fileName,
+            skipReindex: args.skipReindex,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Site restore job submitted from "${args.fileName}". ${DESTRUCTIVE_RESTORE_NOTE}` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const AdminCreateSpaceRestoreJobArgsSchema = z.object({
+    fileName: z.string().min(1).describe("A filename already present in the restore directory (see admin_list_restore_files)."),
+    skipReindex: z.boolean().optional(),
+});
+export async function adminCreateSpaceRestoreJob(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/backup-restore/restore/space", {
+            fileName: args.fileName,
+            skipReindex: args.skipReindex,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Space restore job submitted from "${args.fileName}". ${DESTRUCTIVE_RESTORE_NOTE}` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const AdminCreateSiteRestoreJobFromUploadArgsSchema = z.object({
+    filename: z.string().min(1),
+    contentBase64: z.string().min(1).describe("Backup zip content, base64-encoded."),
+    skipReindex: z.boolean().optional(),
+});
+export async function adminCreateSiteRestoreJobFromUpload(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const bytes = Buffer.from(args.contentBase64, "base64");
+        const form = new FormData();
+        form.append("file", new Blob([bytes], { type: "application/zip" }), args.filename);
+        if (args.skipReindex !== undefined)
+            form.append("skipReindex", String(args.skipReindex));
+        const response = await client.post("/rest/api/backup-restore/restore/site/upload", form, MULTIPART_UPLOAD_HEADERS);
+        return {
+            content: [
+                { type: "text", text: `✅ Site restore job submitted from uploaded file "${args.filename}". ${DESTRUCTIVE_RESTORE_NOTE}` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const AdminCreateSpaceRestoreJobFromUploadArgsSchema = z.object({
+    filename: z.string().min(1),
+    contentBase64: z.string().min(1).describe("Backup zip content, base64-encoded."),
+    skipReindex: z.boolean().optional(),
+});
+export async function adminCreateSpaceRestoreJobFromUpload(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const bytes = Buffer.from(args.contentBase64, "base64");
+        const form = new FormData();
+        form.append("file", new Blob([bytes], { type: "application/zip" }), args.filename);
+        if (args.skipReindex !== undefined)
+            form.append("skipReindex", String(args.skipReindex));
+        const response = await client.post("/rest/api/backup-restore/restore/space/upload", form, MULTIPART_UPLOAD_HEADERS);
+        return {
+            content: [
+                { type: "text", text: `✅ Space restore job submitted from uploaded file "${args.filename}". ${DESTRUCTIVE_RESTORE_NOTE}` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=backup-restore.js.map

package/build/tools/backup-restore.js.map

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

package/build/tools/bulk-pages.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { ConfluenceClient } from "../confluence-client.js";
+import { ToolResult } from "./spaces-pages.js";
+export declare const GetBulkPageChildrenArgsSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pageId: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}, {
+    pageId: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}>;
+export type GetBulkPageChildrenArgs = z.infer<typeof GetBulkPageChildrenArgsSchema>;
+export declare function getBulkPageChildren(client: ConfluenceClient, args: GetBulkPageChildrenArgs): Promise<ToolResult>;
+export declare const BulkDeletePagesArgsSchema: z.ZodObject<{
+    pages: z.ZodArray<z.ZodObject<{
+        contentId: z.ZodString;
+        deleteAllDescendants: z.ZodOptional<z.ZodBoolean>;
+        excludedDescendantIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }, {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    pages: {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }[];
+}, {
+    pages: {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }[];
+}>;
+export type BulkDeletePagesArgs = z.infer<typeof BulkDeletePagesArgsSchema>;
+export declare function bulkDeletePages(client: ConfluenceClient, args: BulkDeletePagesArgs): Promise<ToolResult>;
+export declare const GetDeletableDescendantCountsArgsSchema: z.ZodObject<{
+    pageIds: z.ZodArray<z.ZodNumber, "many">;
+}, "strip", z.ZodTypeAny, {
+    pageIds: number[];
+}, {
+    pageIds: number[];
+}>;
+export type GetDeletableDescendantCountsArgs = z.infer<typeof GetDeletableDescendantCountsArgsSchema>;
+export declare function getDeletableDescendantCounts(client: ConfluenceClient, args: GetDeletableDescendantCountsArgs): Promise<ToolResult>;
+export declare const GetBulkDeleteLimitsArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetBulkDeleteLimitsArgs = z.infer<typeof GetBulkDeleteLimitsArgsSchema>;
+export declare function getBulkDeleteLimits(client: ConfluenceClient, _args: GetBulkDeleteLimitsArgs): Promise<ToolResult>;
+export declare const PreviewBulkDeleteArgsSchema: z.ZodObject<{
+    pages: z.ZodArray<z.ZodObject<{
+        contentId: z.ZodString;
+        deleteAllDescendants: z.ZodOptional<z.ZodBoolean>;
+        excludedDescendantIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }, {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    pages: {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }[];
+}, {
+    pages: {
+        contentId: string;
+        deleteAllDescendants?: boolean | undefined;
+        excludedDescendantIds?: string[] | undefined;
+    }[];
+}>;
+export type PreviewBulkDeleteArgs = z.infer<typeof PreviewBulkDeleteArgsSchema>;
+export declare function previewBulkDelete(client: ConfluenceClient, args: PreviewBulkDeleteArgs): Promise<ToolResult>;
+export declare const GetSpaceRootPagesArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}, {
+    spaceKey: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}>;
+export type GetSpaceRootPagesArgs = z.infer<typeof GetSpaceRootPagesArgsSchema>;
+export declare function getSpaceRootPages(client: ConfluenceClient, args: GetSpaceRootPagesArgs): Promise<ToolResult>;

package/build/tools/bulk-pages.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { withConfluenceErrorHandling } from "./errors.js";
+import { jsonDetailBlock } from "./spaces-pages.js";
+export const GetBulkPageChildrenArgsSchema = z.object({
+    pageId: z.string().min(1),
+    cursor: z.string().optional(),
+    limit: z.number().int().positive().optional(),
+});
+export async function getBulkPageChildren(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/bulk/page/${encodeURIComponent(args.pageId)}/children`, {
+            cursor: args.cursor,
+            limit: args.limit,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Bulk children of page ${args.pageId} retrieved` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+const BulkDeleteEntrySchema = z.object({
+    contentId: z.string().min(1),
+    deleteAllDescendants: z.boolean().optional(),
+    excludedDescendantIds: z.array(z.string()).optional(),
+});
+export const BulkDeletePagesArgsSchema = z.object({
+    pages: z.array(BulkDeleteEntrySchema).min(1),
+});
+export async function bulkDeletePages(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/content/bulk/page/delete", args.pages.map((p) => ({
+            contentId: p.contentId,
+            deleteAllDescendants: p.deleteAllDescendants ?? false,
+            ...(p.excludedDescendantIds ? { excludedDescendantIds: p.excludedDescendantIds } : {}),
+        })));
+        return {
+            content: [
+                { type: "text", text: `✅ Bulk delete submitted for ${args.pages.length} page(s)` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetDeletableDescendantCountsArgsSchema = z.object({
+    pageIds: z.array(z.number().int().positive()).min(1),
+});
+export async function getDeletableDescendantCounts(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/content/bulk/page/delete/deletableDescendantCounts", {
+            pageIds: args.pageIds,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Deletable descendant counts retrieved for ${args.pageIds.length} page(s)` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetBulkDeleteLimitsArgsSchema = z.object({});
+export async function getBulkDeleteLimits(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/content/bulk/page/delete/limits");
+        return {
+            content: [
+                { type: "text", text: "✅ Bulk delete limits retrieved" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const PreviewBulkDeleteArgsSchema = z.object({
+    pages: z.array(BulkDeleteEntrySchema).min(1),
+});
+export async function previewBulkDelete(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post("/rest/api/content/bulk/page/delete/preview", args.pages.map((p) => ({
+            contentId: p.contentId,
+            deleteAllDescendants: p.deleteAllDescendants ?? false,
+            ...(p.excludedDescendantIds ? { excludedDescendantIds: p.excludedDescendantIds } : {}),
+        })));
+        return {
+            content: [
+                { type: "text", text: `✅ Bulk delete preview for ${args.pages.length} page(s) — nothing was deleted` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetSpaceRootPagesArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    cursor: z.string().optional(),
+    limit: z.number().int().positive().optional(),
+});
+export async function getSpaceRootPages(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/content/bulk/page/space/${encodeURIComponent(args.spaceKey)}/root`, {
+            cursor: args.cursor,
+            limit: args.limit,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Root pages for space ${args.spaceKey} retrieved` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=bulk-pages.js.map

package/build/tools/bulk-pages.js.map

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

package/build/tools/color-schemes.d.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { ConfluenceClient } from "../confluence-client.js";
+import { ToolResult } from "./spaces-pages.js";
+export declare const GetGlobalColorSchemeArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetGlobalColorSchemeArgs = z.infer<typeof GetGlobalColorSchemeArgsSchema>;
+export declare function getGlobalColorScheme(client: ConfluenceClient, _args: GetGlobalColorSchemeArgs): Promise<ToolResult>;
+export declare const UpdateGlobalColorSchemeArgsSchema: z.ZodObject<{
+    scheme: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    scheme: Record<string, unknown>;
+}, {
+    scheme: Record<string, unknown>;
+}>;
+export type UpdateGlobalColorSchemeArgs = z.infer<typeof UpdateGlobalColorSchemeArgsSchema>;
+export declare function updateGlobalColorScheme(client: ConfluenceClient, args: UpdateGlobalColorSchemeArgs): Promise<ToolResult>;
+export declare const GetDefaultGlobalColorSchemeArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetDefaultGlobalColorSchemeArgs = z.infer<typeof GetDefaultGlobalColorSchemeArgsSchema>;
+export declare function getDefaultGlobalColorScheme(client: ConfluenceClient, _args: GetDefaultGlobalColorSchemeArgs): Promise<ToolResult>;
+export declare const ResetGlobalColorSchemeArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type ResetGlobalColorSchemeArgs = z.infer<typeof ResetGlobalColorSchemeArgsSchema>;
+export declare function resetGlobalColorScheme(client: ConfluenceClient, _args: ResetGlobalColorSchemeArgs): Promise<ToolResult>;
+export declare const GetSpaceColorSchemeArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type GetSpaceColorSchemeArgs = z.infer<typeof GetSpaceColorSchemeArgsSchema>;
+export declare function getSpaceColorScheme(client: ConfluenceClient, args: GetSpaceColorSchemeArgs): Promise<ToolResult>;
+export declare const UpdateSpaceColorSchemeArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    scheme: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    scheme: Record<string, unknown>;
+}, {
+    spaceKey: string;
+    scheme: Record<string, unknown>;
+}>;
+export type UpdateSpaceColorSchemeArgs = z.infer<typeof UpdateSpaceColorSchemeArgsSchema>;
+export declare function updateSpaceColorScheme(client: ConfluenceClient, args: UpdateSpaceColorSchemeArgs): Promise<ToolResult>;
+export declare const ResetSpaceColorSchemeArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type ResetSpaceColorSchemeArgs = z.infer<typeof ResetSpaceColorSchemeArgsSchema>;
+export declare function resetSpaceColorScheme(client: ConfluenceClient, args: ResetSpaceColorSchemeArgs): Promise<ToolResult>;
+export declare const GetSpaceColorSchemeTypeArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type GetSpaceColorSchemeTypeArgs = z.infer<typeof GetSpaceColorSchemeTypeArgsSchema>;
+export declare function getSpaceColorSchemeType(client: ConfluenceClient, args: GetSpaceColorSchemeTypeArgs): Promise<ToolResult>;
+export declare const UpdateSpaceColorSchemeTypeArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    spaceKey: string;
+}, {
+    type: string;
+    spaceKey: string;
+}>;
+export type UpdateSpaceColorSchemeTypeArgs = z.infer<typeof UpdateSpaceColorSchemeTypeArgsSchema>;
+export declare function updateSpaceColorSchemeType(client: ConfluenceClient, args: UpdateSpaceColorSchemeTypeArgs): Promise<ToolResult>;

package/build/tools/color-schemes.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { withConfluenceErrorHandling } from "./errors.js";
+import { jsonDetailBlock } from "./spaces-pages.js";
+// Color scheme objects have many theme-specific hex-color fields (light/dark variants) — accepted
+// and returned as an opaque JSON object rather than an exhaustively-typed schema, same pattern as
+// this project's other settings-blob tools (e.g. content/space properties).
+const SchemeArgSchema = z.record(z.string(), z.unknown());
+export const GetGlobalColorSchemeArgsSchema = z.object({});
+export async function getGlobalColorScheme(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/color-scheme");
+        return {
+            content: [
+                { type: "text", text: "✅ Global color scheme retrieved" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const UpdateGlobalColorSchemeArgsSchema = z.object({ scheme: SchemeArgSchema });
+export async function updateGlobalColorScheme(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put("/rest/api/color-scheme", args.scheme);
+        return {
+            content: [
+                { type: "text", text: "✅ Global color scheme updated" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetDefaultGlobalColorSchemeArgsSchema = z.object({});
+export async function getDefaultGlobalColorScheme(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get("/rest/api/color-scheme/default");
+        return {
+            content: [
+                { type: "text", text: "✅ Default global color scheme retrieved" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const ResetGlobalColorSchemeArgsSchema = z.object({});
+export async function resetGlobalColorScheme(client, _args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put("/rest/api/color-scheme/reset");
+        return {
+            content: [
+                { type: "text", text: "✅ Global color scheme reset to default" },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetSpaceColorSchemeArgsSchema = z.object({ spaceKey: z.string().min(1) });
+export async function getSpaceColorScheme(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/space/${encodeURIComponent(args.spaceKey)}/color-scheme`);
+        return {
+            content: [
+                { type: "text", text: `✅ Color scheme for space ${args.spaceKey} retrieved` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const UpdateSpaceColorSchemeArgsSchema = z.object({ spaceKey: z.string().min(1), scheme: SchemeArgSchema });
+export async function updateSpaceColorScheme(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put(`/rest/api/space/${encodeURIComponent(args.spaceKey)}/color-scheme`, args.scheme);
+        return {
+            content: [
+                { type: "text", text: `✅ Color scheme for space ${args.spaceKey} updated` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const ResetSpaceColorSchemeArgsSchema = z.object({ spaceKey: z.string().min(1) });
+export async function resetSpaceColorScheme(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put(`/rest/api/space/${encodeURIComponent(args.spaceKey)}/color-scheme/reset`);
+        return {
+            content: [
+                { type: "text", text: `✅ Color scheme for space ${args.spaceKey} reset to default` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetSpaceColorSchemeTypeArgsSchema = z.object({ spaceKey: z.string().min(1) });
+export async function getSpaceColorSchemeType(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(`/rest/api/space/${encodeURIComponent(args.spaceKey)}/color-scheme/type`);
+        return {
+            content: [
+                { type: "text", text: `✅ Color scheme type for space ${args.spaceKey}: "${response.data.type}"` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const UpdateSpaceColorSchemeTypeArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    type: z.string().describe('e.g. "global" (inherit instance default) or "custom".'),
+});
+export async function updateSpaceColorSchemeType(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.put(`/rest/api/space/${encodeURIComponent(args.spaceKey)}/color-scheme/type`, {
+            type: args.type,
+        });
+        return {
+            content: [
+                { type: "text", text: `✅ Color scheme type for space ${args.spaceKey} set to "${response.data.type}"` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=color-schemes.js.map