@stupidcodefactory/freeagent-mcp-server 1.0.0

package/dist/tools/invoice-tools.js

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+import { transformInvoice } from '../transformers/invoice-transformer.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { normalizeContactId, normalizeProjectId } from '../utils/validators.js';
+import { FREEAGENT_API_BASE } from '../config.js';
+import { sanitizeInput } from '../utils/sanitizer.js';
+// Invoice item schema
+const invoiceItemSchema = z.object({
+    description: z.string().min(1),
+    item_type: z.enum([
+        'Hours', 'Days', 'Weeks', 'Months', 'Years',
+        'Products', 'Services', 'Training', 'Expenses', 'Comment'
+    ]),
+    quantity: z.number().positive(),
+    price: z.number(),
+    sales_tax_rate: z.number().optional(),
+});
+// Create invoice schema
+export const createInvoiceSchema = z.object({
+    contact_id: z.string().min(1),
+    dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    payment_terms_in_days: z.number().int().positive().default(30),
+    currency: z.string().length(3).default('GBP'),
+    invoice_items: z.array(invoiceItemSchema).min(1),
+    project_id: z.string().optional(),
+    comments: z.string().optional(),
+    ec_status: z.enum(['UK/Non-EC', 'EC w/ VAT', 'EC VAT Exempt', 'EC Reverse Charge']).optional(),
+});
+export async function createInvoice(client, input, contactNameLookup) {
+    try {
+        const validated = createInvoiceSchema.parse(input);
+        const invoiceData = {
+            contact: normalizeContactId(validated.contact_id, FREEAGENT_API_BASE),
+            dated_on: validated.dated_on,
+            payment_terms_in_days: validated.payment_terms_in_days,
+            currency: validated.currency.toUpperCase(),
+            invoice_items: validated.invoice_items.map((item) => ({
+                description: sanitizeInput(item.description),
+                item_type: item.item_type,
+                quantity: item.quantity.toString(),
+                price: item.price.toString(),
+                ...(item.sales_tax_rate !== undefined && { sales_tax_rate: item.sales_tax_rate.toString() }),
+            })),
+        };
+        if (validated.project_id) {
+            invoiceData['project'] = normalizeProjectId(validated.project_id, FREEAGENT_API_BASE);
+        }
+        if (validated.comments) {
+            invoiceData['comments'] = sanitizeInput(validated.comments);
+        }
+        if (validated.ec_status) {
+            invoiceData['ec_status'] = validated.ec_status;
+        }
+        const response = await client.post('/invoices', {
+            invoice: invoiceData,
+        });
+        return transformInvoice(response.invoice, contactNameLookup);
+    }
+    catch (error) {
+        handleToolError(error, 'create_invoice');
+    }
+}
+// Update invoice schema
+export const updateInvoiceSchema = z.object({
+    invoice_id: z.string().min(1),
+    dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    payment_terms_in_days: z.number().int().positive().optional(),
+    comments: z.string().optional(),
+    invoice_items: z.array(invoiceItemSchema).min(1).optional(),
+});
+export async function updateInvoice(client, input, contactNameLookup) {
+    try {
+        const validated = updateInvoiceSchema.parse(input);
+        const updateData = {};
+        if (validated.dated_on)
+            updateData['dated_on'] = validated.dated_on;
+        if (validated.payment_terms_in_days)
+            updateData['payment_terms_in_days'] = validated.payment_terms_in_days;
+        if (validated.comments !== undefined)
+            updateData['comments'] = sanitizeInput(validated.comments);
+        if (validated.invoice_items) {
+            updateData['invoice_items'] = validated.invoice_items.map((item) => ({
+                description: sanitizeInput(item.description),
+                item_type: item.item_type,
+                quantity: item.quantity.toString(),
+                price: item.price.toString(),
+                ...(item.sales_tax_rate !== undefined && { sales_tax_rate: item.sales_tax_rate.toString() }),
+            }));
+        }
+        const response = await client.put(`/invoices/${validated.invoice_id}`, { invoice: updateData });
+        return transformInvoice(response.invoice, contactNameLookup);
+    }
+    catch (error) {
+        handleToolError(error, 'update_invoice');
+    }
+}
+// Send invoice schema
+export const sendInvoiceSchema = z.object({
+    invoice_id: z.string().min(1),
+    email_to: z.string().email().optional(),
+});
+export async function sendInvoice(client, input) {
+    try {
+        const validated = sendInvoiceSchema.parse(input);
+        const emailData = {};
+        if (validated.email_to) {
+            emailData['email'] = { to: validated.email_to };
+        }
+        await client.put(`/invoices/${validated.invoice_id}/send_email`, emailData);
+        return { success: true, message: 'Invoice sent successfully' };
+    }
+    catch (error) {
+        handleToolError(error, 'send_invoice');
+    }
+}
+// Mark invoice as sent schema
+export const markInvoiceSentSchema = z.object({
+    invoice_id: z.string().min(1),
+});
+export async function markInvoiceSent(client, input) {
+    try {
+        const validated = markInvoiceSentSchema.parse(input);
+        await client.put(`/invoices/${validated.invoice_id}/mark_as_sent`, {});
+        return { success: true, message: 'Invoice marked as sent' };
+    }
+    catch (error) {
+        handleToolError(error, 'mark_invoice_sent');
+    }
+}
+// Mark invoice as paid schema
+export const markInvoicePaidSchema = z.object({
+    invoice_id: z.string().min(1),
+    paid_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    amount: z.number().positive().optional(),
+});
+export async function markInvoicePaid(client, input) {
+    try {
+        const validated = markInvoicePaidSchema.parse(input);
+        const paymentData = {
+            paid_on: validated.paid_on,
+        };
+        if (validated.amount !== undefined) {
+            paymentData['amount'] = validated.amount.toString();
+        }
+        await client.put(`/invoices/${validated.invoice_id}/mark_as_paid`, {
+            invoice: paymentData,
+        });
+        return { success: true, message: 'Invoice marked as paid' };
+    }
+    catch (error) {
+        handleToolError(error, 'mark_invoice_paid');
+    }
+}
+// Delete invoice schema
+export const deleteInvoiceSchema = z.object({
+    invoice_id: z.string().min(1),
+});
+export async function deleteInvoice(client, input) {
+    try {
+        const validated = deleteInvoiceSchema.parse(input);
+        await client.delete(`/invoices/${validated.invoice_id}`);
+        return { success: true, message: 'Invoice deleted' };
+    }
+    catch (error) {
+        handleToolError(error, 'delete_invoice');
+    }
+}
+//# sourceMappingURL=invoice-tools.js.map

package/dist/tools/invoice-tools.js.map

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

package/dist/tools/project-tools.d.ts

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import type { FreeAgentClient } from '../api/freeagent-client.js';
+export declare const createProjectSchema: z.ZodObject<{
+    contact_id: z.ZodString;
+    name: z.ZodString;
+    budget_units: z.ZodEnum<["Hours", "Days", "Monetary"]>;
+    budget: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    normal_billing_rate: z.ZodOptional<z.ZodNumber>;
+    hours_per_day: z.ZodOptional<z.ZodNumber>;
+    is_ir35: z.ZodDefault<z.ZodBoolean>;
+    starts_on: z.ZodOptional<z.ZodString>;
+    ends_on: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    contact_id: string;
+    currency: string;
+    name: string;
+    budget_units: "Hours" | "Days" | "Monetary";
+    is_ir35: boolean;
+    budget?: number | undefined;
+    normal_billing_rate?: number | undefined;
+    hours_per_day?: number | undefined;
+    starts_on?: string | undefined;
+    ends_on?: string | undefined;
+}, {
+    contact_id: string;
+    name: string;
+    budget_units: "Hours" | "Days" | "Monetary";
+    currency?: string | undefined;
+    budget?: number | undefined;
+    normal_billing_rate?: number | undefined;
+    hours_per_day?: number | undefined;
+    is_ir35?: boolean | undefined;
+    starts_on?: string | undefined;
+    ends_on?: string | undefined;
+}>;
+export type CreateProjectInput = z.infer<typeof createProjectSchema>;
+export declare function createProject(client: FreeAgentClient, input: CreateProjectInput, contactNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMProject>;
+export declare const updateProjectSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    budget: z.ZodOptional<z.ZodNumber>;
+    normal_billing_rate: z.ZodOptional<z.ZodNumber>;
+    hours_per_day: z.ZodOptional<z.ZodNumber>;
+    starts_on: z.ZodOptional<z.ZodString>;
+    ends_on: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["Active", "Completed", "Cancelled", "Hidden"]>>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    status?: "Active" | "Cancelled" | "Hidden" | "Completed" | undefined;
+    name?: string | undefined;
+    budget?: number | undefined;
+    normal_billing_rate?: number | undefined;
+    hours_per_day?: number | undefined;
+    starts_on?: string | undefined;
+    ends_on?: string | undefined;
+}, {
+    project_id: string;
+    status?: "Active" | "Cancelled" | "Hidden" | "Completed" | undefined;
+    name?: string | undefined;
+    budget?: number | undefined;
+    normal_billing_rate?: number | undefined;
+    hours_per_day?: number | undefined;
+    starts_on?: string | undefined;
+    ends_on?: string | undefined;
+}>;
+export type UpdateProjectInput = z.infer<typeof updateProjectSchema>;
+export declare function updateProject(client: FreeAgentClient, input: UpdateProjectInput, contactNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMProject>;
+export declare const createTaskSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    name: z.ZodString;
+    is_billable: z.ZodDefault<z.ZodBoolean>;
+    billing_rate: z.ZodOptional<z.ZodNumber>;
+    billing_period: z.ZodOptional<z.ZodEnum<["hour", "day", "week", "month", "year"]>>;
+    budget: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    name: string;
+    is_billable: boolean;
+    budget?: number | undefined;
+    billing_rate?: number | undefined;
+    billing_period?: "hour" | "day" | "week" | "month" | "year" | undefined;
+}, {
+    project_id: string;
+    name: string;
+    budget?: number | undefined;
+    is_billable?: boolean | undefined;
+    billing_rate?: number | undefined;
+    billing_period?: "hour" | "day" | "week" | "month" | "year" | undefined;
+}>;
+export type CreateTaskInput = z.infer<typeof createTaskSchema>;
+export declare function createTask(client: FreeAgentClient, input: CreateTaskInput): Promise<import("../types/llm/index.js").LLMTask>;
+export declare const createTimeslipSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    task_id: z.ZodString;
+    user_id: z.ZodString;
+    dated_on: z.ZodString;
+    hours: z.ZodNumber;
+    comment: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    dated_on: string;
+    project_id: string;
+    task_id: string;
+    user_id: string;
+    hours: number;
+    comment?: string | undefined;
+}, {
+    dated_on: string;
+    project_id: string;
+    task_id: string;
+    user_id: string;
+    hours: number;
+    comment?: string | undefined;
+}>;
+export type CreateTimeslipInput = z.infer<typeof createTimeslipSchema>;
+export declare function createTimeslip(client: FreeAgentClient, input: CreateTimeslipInput): Promise<import("../types/llm/index.js").LLMTimeslip>;
+//# sourceMappingURL=project-tools.d.ts.map

package/dist/tools/project-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-tools.d.ts","sourceRoot":"","sources":["../../src/tools/project-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AASlE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,kBAAkB,EACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,uDA+BxC;AAGD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,kBAAkB,EACzB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,uDA6BxC;AAGD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,wBAAsB,UAAU,CAC9B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,eAAe,oDAyBvB;AAGD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,wBAAsB,cAAc,CAClC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,mBAAmB,wDAuB3B"}

package/dist/tools/project-tools.js

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+import { transformProject, transformTask, transformTimeslip } from '../transformers/project-transformer.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { normalizeContactId, normalizeProjectId } from '../utils/validators.js';
+import { FREEAGENT_API_BASE } from '../config.js';
+import { sanitizeInput } from '../utils/sanitizer.js';
+// Create project schema
+export const createProjectSchema = z.object({
+    contact_id: z.string().min(1),
+    name: z.string().min(1),
+    budget_units: z.enum(['Hours', 'Days', 'Monetary']),
+    budget: z.number().optional(),
+    currency: z.string().length(3).default('GBP'),
+    normal_billing_rate: z.number().optional(),
+    hours_per_day: z.number().optional(),
+    is_ir35: z.boolean().default(false),
+    starts_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    ends_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+});
+export async function createProject(client, input, contactNameLookup) {
+    try {
+        const validated = createProjectSchema.parse(input);
+        const projectData = {
+            contact: normalizeContactId(validated.contact_id, FREEAGENT_API_BASE),
+            name: sanitizeInput(validated.name),
+            budget_units: validated.budget_units,
+            currency: validated.currency.toUpperCase(),
+            is_ir35: validated.is_ir35,
+        };
+        if (validated.budget !== undefined)
+            projectData['budget'] = validated.budget.toString();
+        if (validated.normal_billing_rate !== undefined) {
+            projectData['normal_billing_rate'] = validated.normal_billing_rate.toString();
+        }
+        if (validated.hours_per_day !== undefined) {
+            projectData['hours_per_day'] = validated.hours_per_day.toString();
+        }
+        if (validated.starts_on)
+            projectData['starts_on'] = validated.starts_on;
+        if (validated.ends_on)
+            projectData['ends_on'] = validated.ends_on;
+        const response = await client.post('/projects', {
+            project: projectData,
+        });
+        return transformProject(response.project, contactNameLookup);
+    }
+    catch (error) {
+        handleToolError(error, 'create_project');
+    }
+}
+// Update project schema
+export const updateProjectSchema = z.object({
+    project_id: z.string().min(1),
+    name: z.string().optional(),
+    budget: z.number().optional(),
+    normal_billing_rate: z.number().optional(),
+    hours_per_day: z.number().optional(),
+    starts_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    ends_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    status: z.enum(['Active', 'Completed', 'Cancelled', 'Hidden']).optional(),
+});
+export async function updateProject(client, input, contactNameLookup) {
+    try {
+        const validated = updateProjectSchema.parse(input);
+        const { project_id, ...fields } = validated;
+        const projectData = {};
+        if (fields.name !== undefined)
+            projectData['name'] = sanitizeInput(fields.name);
+        if (fields.budget !== undefined)
+            projectData['budget'] = fields.budget.toString();
+        if (fields.normal_billing_rate !== undefined) {
+            projectData['normal_billing_rate'] = fields.normal_billing_rate.toString();
+        }
+        if (fields.hours_per_day !== undefined) {
+            projectData['hours_per_day'] = fields.hours_per_day.toString();
+        }
+        if (fields.starts_on !== undefined)
+            projectData['starts_on'] = fields.starts_on;
+        if (fields.ends_on !== undefined)
+            projectData['ends_on'] = fields.ends_on;
+        if (fields.status !== undefined)
+            projectData['status'] = fields.status;
+        const response = await client.put(`/projects/${project_id}`, { project: projectData });
+        return transformProject(response.project, contactNameLookup);
+    }
+    catch (error) {
+        handleToolError(error, 'update_project');
+    }
+}
+// Create task schema
+export const createTaskSchema = z.object({
+    project_id: z.string().min(1),
+    name: z.string().min(1),
+    is_billable: z.boolean().default(true),
+    billing_rate: z.number().optional(),
+    billing_period: z.enum(['hour', 'day', 'week', 'month', 'year']).optional(),
+    budget: z.number().optional(),
+});
+export async function createTask(client, input) {
+    try {
+        const validated = createTaskSchema.parse(input);
+        const taskData = {
+            project: normalizeProjectId(validated.project_id, FREEAGENT_API_BASE),
+            name: sanitizeInput(validated.name),
+            is_billable: validated.is_billable,
+        };
+        if (validated.billing_rate !== undefined) {
+            taskData['billing_rate'] = validated.billing_rate.toString();
+        }
+        if (validated.billing_period)
+            taskData['billing_period'] = validated.billing_period;
+        if (validated.budget !== undefined)
+            taskData['budget'] = validated.budget.toString();
+        const response = await client.post('/tasks', {
+            task: taskData,
+        });
+        return transformTask(response.task);
+    }
+    catch (error) {
+        handleToolError(error, 'create_task');
+    }
+}
+// Create timeslip schema
+export const createTimeslipSchema = z.object({
+    project_id: z.string().min(1),
+    task_id: z.string().min(1),
+    user_id: z.string().min(1),
+    dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    hours: z.number().positive(),
+    comment: z.string().optional(),
+});
+export async function createTimeslip(client, input) {
+    try {
+        const validated = createTimeslipSchema.parse(input);
+        const timeslipData = {
+            project: normalizeProjectId(validated.project_id, FREEAGENT_API_BASE),
+            task: `${FREEAGENT_API_BASE}/tasks/${validated.task_id}`,
+            user: `${FREEAGENT_API_BASE}/users/${validated.user_id}`,
+            dated_on: validated.dated_on,
+            hours: validated.hours.toString(),
+        };
+        if (validated.comment)
+            timeslipData['comment'] = sanitizeInput(validated.comment);
+        const response = await client.post('/timeslips', {
+            timeslip: timeslipData,
+        });
+        return transformTimeslip(response.timeslip);
+    }
+    catch (error) {
+        handleToolError(error, 'create_timeslip');
+    }
+}
+//# sourceMappingURL=project-tools.js.map

package/dist/tools/project-tools.js.map

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

package/dist/tools/query-tools.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import type { FreeAgentClient } from '../api/freeagent-client.js';
+import type { LLMInvoice, LLMBankAccount, LLMBankTransaction } from '../types/llm/index.js';
+export declare const listUnpaidInvoicesSchema: z.ZodObject<{
+    contact_id: z.ZodOptional<z.ZodString>;
+    include_overdue_only: z.ZodDefault<z.ZodBoolean>;
+    from_date: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    include_overdue_only: boolean;
+    from_date?: string | undefined;
+    contact_id?: string | undefined;
+}, {
+    from_date?: string | undefined;
+    contact_id?: string | undefined;
+    include_overdue_only?: boolean | undefined;
+}>;
+export type ListUnpaidInvoicesInput = z.infer<typeof listUnpaidInvoicesSchema>;
+export interface UnpaidInvoicesSummary {
+    invoices: LLMInvoice[];
+    totalCount: number;
+    totalDue: number;
+    totalOverdue: number;
+    overdueCount: number;
+    currency: string;
+}
+export declare function listUnpaidInvoices(client: FreeAgentClient, input: ListUnpaidInvoicesInput, contactNameLookup?: Map<string, string>): Promise<UnpaidInvoicesSummary>;
+export declare const getBankSummarySchema: z.ZodObject<{
+    view: z.ZodDefault<z.ZodEnum<["all", "standard", "paypal_accounts", "credit_card_accounts"]>>;
+}, "strip", z.ZodTypeAny, {
+    view: "all" | "standard" | "paypal_accounts" | "credit_card_accounts";
+}, {
+    view?: "all" | "standard" | "paypal_accounts" | "credit_card_accounts" | undefined;
+}>;
+export type GetBankSummaryInput = z.infer<typeof getBankSummarySchema>;
+export interface BankSummary {
+    accounts: LLMBankAccount[];
+    totalBalance: number;
+    currency: string;
+    accountCount: number;
+}
+export declare function getBankSummary(client: FreeAgentClient, input: GetBankSummaryInput): Promise<BankSummary>;
+export declare const searchTransactionsSchema: z.ZodObject<{
+    bank_account_id: z.ZodString;
+    query: z.ZodString;
+    from_date: z.ZodOptional<z.ZodString>;
+    to_date: z.ZodOptional<z.ZodString>;
+    unexplained_only: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    bank_account_id: string;
+    query: string;
+    unexplained_only: boolean;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+}, {
+    bank_account_id: string;
+    query: string;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    unexplained_only?: boolean | undefined;
+}>;
+export type SearchTransactionsInput = z.infer<typeof searchTransactionsSchema>;
+export interface TransactionSearchResult {
+    transactions: LLMBankTransaction[];
+    matchCount: number;
+    searchQuery: string;
+}
+export declare function searchTransactions(client: FreeAgentClient, input: SearchTransactionsInput): Promise<TransactionSearchResult>;
+export declare const getUnexplainedTransactionsSchema: z.ZodObject<{
+    bank_account_id: z.ZodString;
+    from_date: z.ZodOptional<z.ZodString>;
+    to_date: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    bank_account_id: string;
+    limit: number;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+}, {
+    bank_account_id: string;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type GetUnexplainedTransactionsInput = z.infer<typeof getUnexplainedTransactionsSchema>;
+export interface UnexplainedTransactionsResult {
+    transactions: LLMBankTransaction[];
+    count: number;
+    totalUnexplainedAmount: number;
+}
+export declare function getUnexplainedTransactions(client: FreeAgentClient, input: GetUnexplainedTransactionsInput): Promise<UnexplainedTransactionsResult>;
+//# sourceMappingURL=query-tools.d.ts.map

package/dist/tools/query-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tools.d.ts","sourceRoot":"","sources":["../../src/tools/query-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAKlE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,uBAAuB,EAC9B,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,qBAAqB,CAAC,CAiChC;AAGD,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,WAAW,CAAC,CAoBtB;AAGD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA+BlC;AAGD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EAK3C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE/F,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,6BAA6B,CAAC,CA4BxC"}