feat: add optional pageSize parameter to all list tools

src/handlers/list-xero-contacts.handler.ts

@@ -4,7 +4,7 @@ import { XeroClientResponse } from "../types/tool-response.js";
 import { formatError } from "../helpers/format-error.js";
 import { getClientHeaders } from "../helpers/get-client-headers.js";
 
-async function getContacts(page?: number, searchTerm?: string): Promise<Contact[]> {
+async function getContacts(page?: number, searchTerm?: string, pageSize?: number): Promise<Contact[]> {
   await xeroClient.authenticate();
 
   const contacts = await xeroClient.accountingApi.getContacts(
@@ -17,7 +17,7 @@ async function getContacts(page?: number, searchTerm?: string): Promise<Contact[
     undefined, // includeArchived
     true, // summaryOnly
     searchTerm, // searchTerm
-    undefined, // pageSize
+    pageSize, // pageSize
     getClientHeaders(),
   );
   return contacts.body.contacts ?? [];
@@ -26,11 +26,11 @@ async function getContacts(page?: number, searchTerm?: string): Promise<Contact[
 /**
  * List all contacts from Xero
  */
-export async function listXeroContacts(page?: number, searchTerm?: string): Promise<
+export async function listXeroContacts(page?: number, searchTerm?: string, pageSize?: number): Promise<
   XeroClientResponse<Contact[]>
 > {
   try {
-    const contacts = await getContacts(page, searchTerm);
+    const contacts = await getContacts(page, searchTerm, pageSize);
 
     return {
       result: contacts,

src/handlers/list-xero-credit-notes.handler.ts

@@ -7,6 +7,7 @@ import { getClientHeaders } from "../helpers/get-client-headers.js";
 async function getCreditNotes(
   contactId: string | undefined,
   page: number,
+  pageSize: number = 10,
 ): Promise<CreditNote[]> {
   await xeroClient.authenticate();
 
@@ -17,7 +18,7 @@ async function getCreditNotes(
     "UpdatedDateUTC DESC", // order
     page, // page
     undefined, // unitdp
-    10, // pageSize
+    pageSize, // pageSize
     getClientHeaders(),
   );
 
@@ -30,9 +31,10 @@ async function getCreditNotes(
 export async function listXeroCreditNotes(
   page: number = 1,
   contactId?: string,
+  pageSize: number = 10,
 ): Promise<XeroClientResponse<CreditNote[]>> {
   try {
-    const creditNotes = await getCreditNotes(contactId, page);
+    const creditNotes = await getCreditNotes(contactId, page, pageSize);
 
     return {
       result: creditNotes,

src/handlers/list-xero-invoices.handler.ts

@@ -8,6 +8,7 @@ async function getInvoices(
   invoiceNumbers: string[] | undefined,
   contactIds: string[] | undefined,
   page: number,
+  pageSize: number = 10,
 ): Promise<Invoice[]> {
   await xeroClient.authenticate();
 
@@ -25,7 +26,7 @@ async function getInvoices(
     false, // createdByMyApp
     undefined, // unitdp
     false, // summaryOnly
-    10, // pageSize
+    pageSize, // pageSize
     undefined, // searchTerm
     getClientHeaders(),
   );
@@ -39,9 +40,10 @@ export async function listXeroInvoices(
   page: number = 1,
   contactIds?: string[],
   invoiceNumbers?: string[],
+  pageSize: number = 10,
 ): Promise<XeroClientResponse<Invoice[]>> {
   try {
-    const invoices = await getInvoices(invoiceNumbers, contactIds, page);
+    const invoices = await getInvoices(invoiceNumbers, contactIds, page, pageSize);
 
     return {
       result: invoices,

src/handlers/list-xero-manual-journals.handler.ts

@@ -8,6 +8,7 @@ async function getManualJournals(
   page: number,
   manualJournalId?: string,
   modifiedAfter?: string,
+  pageSize: number = 10,
 ): Promise<ManualJournal[]> {
   await xeroClient.authenticate();
 
@@ -27,7 +28,7 @@ async function getManualJournals(
     undefined,
     "UpdatedDateUTC DESC",
     page,
-    10, // pageSize
+    pageSize, // pageSize
     getClientHeaders(),
   );
 
@@ -41,12 +42,14 @@ export async function listXeroManualJournals(
   page: number = 1,
   manualJournalId?: string,
   modifiedAfter?: string,
+  pageSize: number = 10,
 ): Promise<XeroClientResponse<ManualJournal[]>> {
   try {
     const manualJournals = await getManualJournals(
       page,
       manualJournalId,
       modifiedAfter,
+      pageSize,
     );
 
     return {

src/handlers/list-xero-payments.handler.ts

@@ -6,6 +6,7 @@ import { getClientHeaders } from "../helpers/get-client-headers.js";
 
 async function getPayments(
   page: number = 1,
+  pageSize: number = 10,
   {
     invoiceNumber,
     invoiceId,
@@ -46,7 +47,7 @@ async function getPayments(
     where,
     "UpdatedDateUTC DESC", // order
     page, // page
-    10, // pageSize
+    pageSize, // pageSize
     getClientHeaders(), // options
   );
 
@@ -69,9 +70,10 @@ export async function listXeroPayments(
     paymentId?: string;
     reference?: string;
   },
+  pageSize: number = 10,
 ): Promise<XeroClientResponse<Payment[]>> {
   try {
-    const payments = await getPayments(page, {
+    const payments = await getPayments(page, pageSize, {
       invoiceNumber,
       invoiceId,
       paymentId,

src/tools/list/list-contacts.tool.ts

@@ -10,10 +10,11 @@ const ListContactsTool = CreateXeroTool(
       If not provided, the first page will be returned. If 100 contacts are returned, \
       call this tool again with the next page number."),
     searchTerm: z.string().optional().describe("Search parameter that performs a case-insensitive text search across the Name, FirstName, LastName, ContactNumber and EmailAddress fields"),
+    pageSize: z.number().min(1).max(100).default(10).optional().describe("Number of results per page (1-100, default 10)"),
   },
   async (params) => {
-    const { page, searchTerm } = params;
-    const response = await listXeroContacts(page, searchTerm);
+    const { page, searchTerm, pageSize } = params;
+    const response = await listXeroContacts(page, searchTerm, pageSize);
 
     if (response.isError) {
       return {

src/tools/list/list-credit-notes.tool.ts

@@ -14,9 +14,10 @@ const ListCreditNotesTool = CreateXeroTool(
   {
     page: z.number(),
     contactId: z.string().optional(),
+    pageSize: z.number().min(1).max(100).default(10).optional().describe("Number of results per page (1-100, default 10)"),
   },
-  async ({ page, contactId }) => {
-    const response = await listXeroCreditNotes(page, contactId);
+  async ({ page, contactId, pageSize }) => {
+    const response = await listXeroCreditNotes(page, contactId, pageSize);
     if (response.error !== null) {
       return {
         content: [

src/tools/list/list-invoices.tool.ts

@@ -14,14 +14,15 @@ const ListInvoicesTool = CreateXeroTool(
   and the contact or invoice number if one was provided in the previous call.",
   {
     page: z.number(),
+    pageSize: z.number().min(1).max(100).default(10).optional().describe("Number of results per page (1-100, default 10)"),
     contactIds: z.array(z.string()).optional(),
     invoiceNumbers: z
       .array(z.string())
       .optional()
       .describe("If provided, invoice line items will also be returned"),
   },
-  async ({ page, contactIds, invoiceNumbers }) => {
-    const response = await listXeroInvoices(page, contactIds, invoiceNumbers);
+  async ({ page, pageSize, contactIds, invoiceNumbers }) => {
+    const response = await listXeroInvoices(page, contactIds, invoiceNumbers, pageSize);
     if (response.error !== null) {
       return {
         content: [

src/tools/list/list-manual-journals.tool.ts

@@ -23,13 +23,15 @@ If they want the next page, call this tool again with the next page number, modi
         "Optional date YYYY-MM-DD to filter journals modified after this date",
       ),
     page: z.number().optional().describe("Optional page number for pagination"),
+    pageSize: z.number().min(1).max(100).default(10).optional().describe("Number of results per page (1-100, default 10)"),
     // TODO: where, order
   },
   async (args) => {
     const response = await listXeroManualJournals(
       args?.page,
       args?.manualJournalId,
       args?.modifiedAfter,
+      args?.pageSize,
     );
 
     if (response.isError) {

src/tools/list/list-payments.tool.ts

@@ -48,18 +48,19 @@ const ListPaymentsTool = CreateXeroTool(
   If many payments are returned, ask the user if they want to see the next page.`,
   {
     page: z.number().default(1),
+    pageSize: z.number().min(1).max(100).default(10).optional().describe("Number of results per page (1-100, default 10)"),
     invoiceNumber: z.string().optional(),
     invoiceId: z.string().optional(),
     paymentId: z.string().optional(),
     reference: z.string().optional(),
   },
-  async ({ page, invoiceNumber, invoiceId, paymentId, reference }) => {
+  async ({ page, pageSize, invoiceNumber, invoiceId, paymentId, reference }) => {
     const response = await listXeroPayments(page, {
       invoiceNumber,
       invoiceId,
       paymentId,
       reference,
-    });
+    }, pageSize);
 
     if (response.error !== null) {
       return {