castor-mcp 0.6.0

package/build/tools/permissions.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { withConfluenceErrorHandling } from "./errors.js";
+import { jsonDetailBlock } from "./spaces-pages.js";
+// Confirmed live (2026-08-20): granting global permissions to a subject with no existing global
+// grants fails with "'USECONFLUENCE' permission has to exist before adding any other permissions
+// for a subject" unless {targetType: "application", operationKey: "use"} is included in — or
+// already granted before — the same call. Not a bug in this tool; a real Confluence business
+// rule callers need to know about, since the error message alone doesn't say what to do about it.
+const OperationSchema = z.object({
+    targetType: z.string().describe('e.g. "space", "application".'),
+    operationKey: z.string().describe('e.g. "read", "create", "administer", "use".'),
+});
+export const OperationsArgSchema = z.array(OperationSchema).min(1);
+// Shared shape behind every get/grant/revoke pair below — same request/response contract,
+// differing only in path. Kept as thin named exports (not one generic tool) so each operation the
+// catalog lists maps to a distinct, individually-registerable tool name, matching this project's
+// one-tool-per-capability convention.
+async function getPermissions(client, path, label) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.get(path);
+        return {
+            content: [
+                { type: "text", text: `✅ Permissions for ${label} retrieved` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+async function grantPermissions(client, path, operations, label) {
+    return withConfluenceErrorHandling(async () => {
+        await client.put(path, operations);
+        return { content: [{ type: "text", text: `✅ Permissions granted to ${label}` }] };
+    });
+}
+async function revokePermissions(client, path, operations, label) {
+    return withConfluenceErrorHandling(async () => {
+        await client.put(path, operations);
+        return { content: [{ type: "text", text: `✅ Permissions revoked from ${label}` }] };
+    });
+}
+// --- Global permissions ---
+export const ListGlobalPermissionsArgsSchema = z.object({});
+export async function listGlobalPermissions(client, _args) {
+    return getPermissions(client, "/rest/api/permissions", "the instance (all global permissions)");
+}
+const SpacePermissionsForSubjectSchema = z.object({
+    userKey: z.string().optional(),
+    groupName: z.string().optional(),
+    operations: OperationsArgSchema,
+});
+export const SetGlobalPermissionsArgsSchema = z.object({
+    subjects: z.array(SpacePermissionsForSubjectSchema).min(1),
+});
+export async function setGlobalPermissions(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        await client.put("/rest/api/permissions", args.subjects);
+        return { content: [{ type: "text", text: `✅ Global permissions set for ${args.subjects.length} subject(s)` }] };
+    });
+}
+export const GetAnonymousGlobalPermissionsArgsSchema = z.object({});
+export async function getAnonymousGlobalPermissions(client, _args) {
+    return getPermissions(client, "/rest/api/permissions/anonymous", "anonymous users (global)");
+}
+export const GrantAnonymousGlobalPermissionsArgsSchema = z.object({ operations: OperationsArgSchema });
+export async function grantAnonymousGlobalPermissions(client, args) {
+    return grantPermissions(client, "/rest/api/permissions/anonymous/grant", args.operations, "anonymous users (global)");
+}
+export const RevokeAnonymousGlobalPermissionsArgsSchema = z.object({ operations: OperationsArgSchema });
+export async function revokeAnonymousGlobalPermissions(client, args) {
+    return revokePermissions(client, "/rest/api/permissions/anonymous/revoke", args.operations, "anonymous users (global)");
+}
+export const GetGroupGlobalPermissionsArgsSchema = z.object({ groupName: z.string().min(1) });
+export async function getGroupGlobalPermissions(client, args) {
+    return getPermissions(client, `/rest/api/permissions/group/${encodeURIComponent(args.groupName)}`, `group "${args.groupName}" (global)`);
+}
+export const GrantGroupGlobalPermissionsArgsSchema = z.object({
+    groupName: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function grantGroupGlobalPermissions(client, args) {
+    return grantPermissions(client, `/rest/api/permissions/group/${encodeURIComponent(args.groupName)}/grant`, args.operations, `group "${args.groupName}" (global)`);
+}
+export const RevokeGroupGlobalPermissionsArgsSchema = z.object({
+    groupName: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function revokeGroupGlobalPermissions(client, args) {
+    return revokePermissions(client, `/rest/api/permissions/group/${encodeURIComponent(args.groupName)}/revoke`, args.operations, `group "${args.groupName}" (global)`);
+}
+export const GetUnlicensedGlobalPermissionsArgsSchema = z.object({});
+export async function getUnlicensedGlobalPermissions(client, _args) {
+    return getPermissions(client, "/rest/api/permissions/unlicensed", "unlicensed users (global)");
+}
+export const GrantUnlicensedGlobalPermissionsArgsSchema = z.object({ operations: OperationsArgSchema });
+export async function grantUnlicensedGlobalPermissions(client, args) {
+    return grantPermissions(client, "/rest/api/permissions/unlicensed/grant", args.operations, "unlicensed users (global)");
+}
+export const RevokeUnlicensedGlobalPermissionsArgsSchema = z.object({ operations: OperationsArgSchema });
+export async function revokeUnlicensedGlobalPermissions(client, args) {
+    return revokePermissions(client, "/rest/api/permissions/unlicensed/revoke", args.operations, "unlicensed users (global)");
+}
+export const GetUserGlobalPermissionsArgsSchema = z.object({ user: z.string().min(1) });
+export async function getUserGlobalPermissions(client, args) {
+    return getPermissions(client, `/rest/api/permissions/user/${encodeURIComponent(args.user)}`, `user "${args.user}" (global)`);
+}
+export const GrantUserGlobalPermissionsArgsSchema = z.object({
+    user: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function grantUserGlobalPermissions(client, args) {
+    return grantPermissions(client, `/rest/api/permissions/user/${encodeURIComponent(args.user)}/grant`, args.operations, `user "${args.user}" (global)`);
+}
+export const RevokeUserGlobalPermissionsArgsSchema = z.object({
+    user: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function revokeUserGlobalPermissions(client, args) {
+    return revokePermissions(client, `/rest/api/permissions/user/${encodeURIComponent(args.user)}/revoke`, args.operations, `user "${args.user}" (global)`);
+}
+// --- Space permissions ---
+export const SetSpacePermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    subjects: z.array(SpacePermissionsForSubjectSchema).min(1),
+});
+export async function setSpacePermissions(client, args) {
+    return withConfluenceErrorHandling(async () => {
+        const response = await client.post(`/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions`, args.subjects);
+        return {
+            content: [
+                { type: "text", text: `✅ Permissions set on space ${args.spaceKey} for ${args.subjects.length} subject(s)` },
+                jsonDetailBlock(response.data),
+            ],
+        };
+    });
+}
+export const GetSpaceAnonymousPermissionsArgsSchema = z.object({ spaceKey: z.string().min(1) });
+export async function getSpaceAnonymousPermissions(client, args) {
+    return getPermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/anonymous`, `anonymous users on space ${args.spaceKey}`);
+}
+export const GrantSpaceAnonymousPermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function grantSpaceAnonymousPermissions(client, args) {
+    return grantPermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/anonymous/grant`, args.operations, `anonymous users on space ${args.spaceKey}`);
+}
+export const RevokeSpaceAnonymousPermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function revokeSpaceAnonymousPermissions(client, args) {
+    return revokePermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/anonymous/revoke`, args.operations, `anonymous users on space ${args.spaceKey}`);
+}
+export const GetSpaceGroupPermissionsArgsSchema = z.object({ spaceKey: z.string().min(1), groupName: z.string().min(1) });
+export async function getSpaceGroupPermissions(client, args) {
+    return getPermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/group/${encodeURIComponent(args.groupName)}`, `group "${args.groupName}" on space ${args.spaceKey}`);
+}
+export const GrantSpaceGroupPermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    groupName: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function grantSpaceGroupPermissions(client, args) {
+    return grantPermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/group/${encodeURIComponent(args.groupName)}/grant`, args.operations, `group "${args.groupName}" on space ${args.spaceKey}`);
+}
+export const RevokeSpaceGroupPermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    groupName: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function revokeSpaceGroupPermissions(client, args) {
+    return revokePermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/group/${encodeURIComponent(args.groupName)}/revoke`, args.operations, `group "${args.groupName}" on space ${args.spaceKey}`);
+}
+export const GetSpaceUserPermissionsArgsSchema = z.object({ spaceKey: z.string().min(1), userKey: z.string().min(1) });
+export async function getSpaceUserPermissions(client, args) {
+    return getPermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/user/${encodeURIComponent(args.userKey)}`, `user "${args.userKey}" on space ${args.spaceKey}`);
+}
+export const GrantSpaceUserPermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    userKey: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function grantSpaceUserPermissions(client, args) {
+    return grantPermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/user/${encodeURIComponent(args.userKey)}/grant`, args.operations, `user "${args.userKey}" on space ${args.spaceKey}`);
+}
+export const RevokeSpaceUserPermissionsArgsSchema = z.object({
+    spaceKey: z.string().min(1),
+    userKey: z.string().min(1),
+    operations: OperationsArgSchema,
+});
+export async function revokeSpaceUserPermissions(client, args) {
+    return revokePermissions(client, `/rest/api/space/${encodeURIComponent(args.spaceKey)}/permissions/user/${encodeURIComponent(args.userKey)}/revoke`, args.operations, `user "${args.userKey}" on space ${args.spaceKey}`);
+}
+//# sourceMappingURL=permissions.js.map

package/build/tools/permissions.js.map

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

package/build/tools/spaces-admin.d.ts

@@ -0,0 +1,225 @@
+import { z } from "zod";
+import { ConfluenceClient } from "../confluence-client.js";
+import { ToolResult } from "./spaces-pages.js";
+export declare const CreateSpaceArgsSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    name: string;
+    description?: string | undefined;
+}, {
+    key: string;
+    name: string;
+    description?: string | undefined;
+}>;
+export type CreateSpaceArgs = z.infer<typeof CreateSpaceArgsSchema>;
+export declare function createSpace(client: ConfluenceClient, args: CreateSpaceArgs): Promise<ToolResult>;
+export declare const CreatePrivateSpaceArgsSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    name: string;
+    description?: string | undefined;
+}, {
+    key: string;
+    name: string;
+    description?: string | undefined;
+}>;
+export type CreatePrivateSpaceArgs = z.infer<typeof CreatePrivateSpaceArgsSchema>;
+export declare function createPrivateSpace(client: ConfluenceClient, args: CreatePrivateSpaceArgs): Promise<ToolResult>;
+export declare const CreatePersonalSpaceArgsSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    isPrivate: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+    isPrivate?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    isPrivate?: boolean | undefined;
+}>;
+export type CreatePersonalSpaceArgs = z.infer<typeof CreatePersonalSpaceArgsSchema>;
+export declare function createPersonalSpace(client: ConfluenceClient, args: CreatePersonalSpaceArgs): Promise<ToolResult>;
+export declare const DeleteSpaceArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type DeleteSpaceArgs = z.infer<typeof DeleteSpaceArgsSchema>;
+export declare function deleteSpace(client: ConfluenceClient, args: DeleteSpaceArgs): Promise<ToolResult>;
+export declare const UpdateSpaceArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    name?: string | undefined;
+    description?: string | undefined;
+}, {
+    spaceKey: string;
+    name?: string | undefined;
+    description?: string | undefined;
+}>;
+export type UpdateSpaceArgs = z.infer<typeof UpdateSpaceArgsSchema>;
+export declare function updateSpace(client: ConfluenceClient, args: UpdateSpaceArgs): Promise<ToolResult>;
+export declare const ArchiveSpaceArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type ArchiveSpaceArgs = z.infer<typeof ArchiveSpaceArgsSchema>;
+export declare function archiveSpace(client: ConfluenceClient, args: ArchiveSpaceArgs): Promise<ToolResult>;
+export declare const AddSpaceCategoryArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    categoryName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    categoryName: string;
+}, {
+    spaceKey: string;
+    categoryName: string;
+}>;
+export type AddSpaceCategoryArgs = z.infer<typeof AddSpaceCategoryArgsSchema>;
+export declare function addSpaceCategory(client: ConfluenceClient, args: AddSpaceCategoryArgs): Promise<ToolResult>;
+export declare const RemoveSpaceCategoryArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    categoryName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    categoryName: string;
+}, {
+    spaceKey: string;
+    categoryName: string;
+}>;
+export type RemoveSpaceCategoryArgs = z.infer<typeof RemoveSpaceCategoryArgsSchema>;
+export declare function removeSpaceCategory(client: ConfluenceClient, args: RemoveSpaceCategoryArgs): Promise<ToolResult>;
+export declare const ListSpaceContentArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type ListSpaceContentArgs = z.infer<typeof ListSpaceContentArgsSchema>;
+export declare function listSpaceContent(client: ConfluenceClient, args: ListSpaceContentArgs): Promise<ToolResult>;
+export declare const ListSpaceContentOfTypeArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    spaceKey: string;
+}, {
+    type: string;
+    spaceKey: string;
+}>;
+export type ListSpaceContentOfTypeArgs = z.infer<typeof ListSpaceContentOfTypeArgsSchema>;
+export declare function listSpaceContentOfType(client: ConfluenceClient, args: ListSpaceContentOfTypeArgs): Promise<ToolResult>;
+export declare const ListSpacePropertiesArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type ListSpacePropertiesArgs = z.infer<typeof ListSpacePropertiesArgsSchema>;
+export declare function listSpaceProperties(client: ConfluenceClient, args: ListSpacePropertiesArgs): Promise<ToolResult>;
+export declare const CreateSpacePropertyArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    key: z.ZodString;
+    value: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    key: string;
+    value?: unknown;
+}, {
+    spaceKey: string;
+    key: string;
+    value?: unknown;
+}>;
+export type CreateSpacePropertyArgs = z.infer<typeof CreateSpacePropertyArgsSchema>;
+export declare function createSpaceProperty(client: ConfluenceClient, args: CreateSpacePropertyArgs): Promise<ToolResult>;
+export declare const GetSpacePropertyArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    key: string;
+}, {
+    spaceKey: string;
+    key: string;
+}>;
+export type GetSpacePropertyArgs = z.infer<typeof GetSpacePropertyArgsSchema>;
+export declare function getSpaceProperty(client: ConfluenceClient, args: GetSpacePropertyArgs): Promise<ToolResult>;
+export declare const UpdateSpacePropertyArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    key: z.ZodString;
+    value: z.ZodUnknown;
+    currentVersion: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    currentVersion: number;
+    key: string;
+    value?: unknown;
+}, {
+    spaceKey: string;
+    currentVersion: number;
+    key: string;
+    value?: unknown;
+}>;
+export type UpdateSpacePropertyArgs = z.infer<typeof UpdateSpacePropertyArgsSchema>;
+export declare function updateSpaceProperty(client: ConfluenceClient, args: UpdateSpacePropertyArgs): Promise<ToolResult>;
+export declare const DeleteSpacePropertyArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+    key: string;
+}, {
+    spaceKey: string;
+    key: string;
+}>;
+export type DeleteSpacePropertyArgs = z.infer<typeof DeleteSpacePropertyArgsSchema>;
+export declare function deleteSpaceProperty(client: ConfluenceClient, args: DeleteSpacePropertyArgs): Promise<ToolResult>;
+export declare const RestoreSpaceArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type RestoreSpaceArgs = z.infer<typeof RestoreSpaceArgsSchema>;
+export declare function restoreSpace(client: ConfluenceClient, args: RestoreSpaceArgs): Promise<ToolResult>;
+export declare const EmptySpaceTrashArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type EmptySpaceTrashArgs = z.infer<typeof EmptySpaceTrashArgsSchema>;
+export declare function emptySpaceTrash(client: ConfluenceClient, args: EmptySpaceTrashArgs): Promise<ToolResult>;
+export declare const ListSpaceTrashArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type ListSpaceTrashArgs = z.infer<typeof ListSpaceTrashArgsSchema>;
+export declare function listSpaceTrash(client: ConfluenceClient, args: ListSpaceTrashArgs): Promise<ToolResult>;
+export declare const GetSpaceWatchersArgsSchema: z.ZodObject<{
+    spaceKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceKey: string;
+}, {
+    spaceKey: string;
+}>;
+export type GetSpaceWatchersArgs = z.infer<typeof GetSpaceWatchersArgsSchema>;
+export declare function getSpaceWatchers(client: ConfluenceClient, args: GetSpaceWatchersArgs): Promise<ToolResult>;