@aashari/mcp-server-atlassian-confluence/dist/tools/atlassian.pages.types.js

Node.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP in

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.GetPageToolArgs = exports.ListPagesToolArgs = void 0;
const zod_1 = require("zod");
/**
 * Base pagination arguments for all tools
 */
const PaginationArgs = {
    limit: zod_1.z
        .number()
        .int()
        .positive()
        .min(1)
        .max(250)
        .optional()
        .describe('Maximum number of items to return (1-250). Controls the response size. Defaults to 25 if omitted. The Confluence API caps results at 250 items per request.'),
    cursor: zod_1.z
        .string()
        .optional()
        .describe('Pagination cursor for retrieving the next set of results. Obtain this opaque string from the metadata.pagination.nextCursor of a previous response when more results are available. Confluence uses cursor-based pagination rather than offset-based pagination.'),
};
/**
 * Arguments for listing Confluence pages
 * Matches the controller's ListPagesOptions interface
 */
const ListPagesToolArgs = zod_1.z.object({
    spaceIds: zod_1.z
        .array(zod_1.z.string())
        .optional()
        .describe('Optional: Numeric Space IDs to filter by. Either use this OR spaceKeys, not both together. If both are provided, only spaceIds will be used.'),
    spaceKeys: zod_1.z
        .array(zod_1.z.string())
        .optional()
        .describe('Optional: Space Keys (e.g., "DEV") to filter by. Either use this OR spaceIds, not both together. If both are provided, only spaceIds will be used. Preferred for usability as keys are more human-readable than IDs.'),
    parentId: zod_1.z
        .string()
        .optional()
        .describe('Optional: Parent page ID to filter for child pages only.'),
    title: zod_1.z
        .string()
        .optional()
        .describe('Filter pages by title. IMPORTANT: This performs an EXACT match on the page title, not a partial or contains match. For partial title matching or full-text content search, use the `conf_search` tool instead, which supports fuzzy title matching via `title ~ "Your Text"`.'),
    status: zod_1.z
        .array(zod_1.z.enum(['current', 'trashed', 'deleted', 'archived', 'historical']))
        .optional()
        .describe('Optional: Filter pages by status. Options: "current" (published), "trashed", "deleted", "archived", "historical" (previous versions). Defaults to ["current"] if not specified. Provide as an array to include multiple statuses.'),
    ...PaginationArgs,
    sort: zod_1.z
        .enum([
        'id',
        '-id',
        'created-date',
        '-created-date',
        'modified-date',
        '-modified-date',
        'title',
        '-title',
    ])
        .optional()
        .describe('Optional: Property to sort pages by. Default is "-modified-date" (most recently modified first). The "-" prefix indicates descending order. Valid values: "id", "-id", "created-date", "-created-date", "modified-date", "-modified-date", "title", "-title".'),
});
exports.ListPagesToolArgs = ListPagesToolArgs;
/**
 * Arguments for getting a specific Confluence page
 * Matches the controller's get function signature
 */
const GetPageToolArgs = zod_1.z.object({
    pageId: zod_1.z
        .string()
        .describe('The numeric ID of the Confluence page to retrieve (e.g., "456789"). This is required and must be a valid page ID from your Confluence instance. The page content will be returned in Markdown format for easy reading.'),
});
exports.GetPageToolArgs = GetPageToolArgs;