@kody/atlassian-mcp

import { atlassianMcpSetupMessage, callAtlassianMcp, firstArray } from './mcp.ts'

type Input = { query?: string; cql?: string; limit?: number }

/**
 * Search Confluence through the connected Atlassian MCP server.
 * @param input - Optional helper arguments (query, limit, filters).
 * @returns Structured helper result for agents.
 * @example
 * import searchConfluence from 'kody:@kody/atlassian-mcp/search-confluence'
 * const result = await searchConfluence()
 * // => { ... }
 */
export default async function searchConfluence(input: Input = {}) {
	const mcp = await callAtlassianMcp(
		[
  "searchConfluenceUsingCql",
  "search_confluence_using_cql",
  "search"
],
		{ cql: input.cql?.trim() || undefined, query: input.query?.trim() || undefined, limit: input.limit ?? 10 },
	)
	if (!mcp) {
		throw new Error(atlassianMcpSetupMessage())
	}
	return {
		via: 'mcp',
		tool: mcp.tool,
		pages: firstArray(mcp.result) ?? mcp.result,
	}
}