@stupidcodefactory/freeagent-mcp-server 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/README.md +187 -0
  2. package/dist/api/freeagent-client.d.ts +12 -0
  3. package/dist/api/freeagent-client.d.ts.map +1 -0
  4. package/dist/api/freeagent-client.js +114 -0
  5. package/dist/api/freeagent-client.js.map +1 -0
  6. package/dist/api/index.d.ts +7 -0
  7. package/dist/api/index.d.ts.map +1 -0
  8. package/dist/api/index.js +4 -0
  9. package/dist/api/index.js.map +1 -0
  10. package/dist/api/rate-limiter.d.ts +15 -0
  11. package/dist/api/rate-limiter.d.ts.map +1 -0
  12. package/dist/api/rate-limiter.js +62 -0
  13. package/dist/api/rate-limiter.js.map +1 -0
  14. package/dist/api/retry-handler.d.ts +14 -0
  15. package/dist/api/retry-handler.d.ts.map +1 -0
  16. package/dist/api/retry-handler.js +49 -0
  17. package/dist/api/retry-handler.js.map +1 -0
  18. package/dist/auth/index.d.ts +7 -0
  19. package/dist/auth/index.d.ts.map +1 -0
  20. package/dist/auth/index.js +4 -0
  21. package/dist/auth/index.js.map +1 -0
  22. package/dist/auth/oauth.d.ts +16 -0
  23. package/dist/auth/oauth.d.ts.map +1 -0
  24. package/dist/auth/oauth.js +64 -0
  25. package/dist/auth/oauth.js.map +1 -0
  26. package/dist/auth/token-manager.d.ts +10 -0
  27. package/dist/auth/token-manager.d.ts.map +1 -0
  28. package/dist/auth/token-manager.js +71 -0
  29. package/dist/auth/token-manager.js.map +1 -0
  30. package/dist/auth/token-store.d.ts +10 -0
  31. package/dist/auth/token-store.d.ts.map +1 -0
  32. package/dist/auth/token-store.js +84 -0
  33. package/dist/auth/token-store.js.map +1 -0
  34. package/dist/config.d.ts +73 -0
  35. package/dist/config.d.ts.map +1 -0
  36. package/dist/config.js +46 -0
  37. package/dist/config.js.map +1 -0
  38. package/dist/index.d.ts +3 -0
  39. package/dist/index.d.ts.map +1 -0
  40. package/dist/index.js +44 -0
  41. package/dist/index.js.map +1 -0
  42. package/dist/prompts/cash-flow-forecast.d.ts +12 -0
  43. package/dist/prompts/cash-flow-forecast.d.ts.map +1 -0
  44. package/dist/prompts/cash-flow-forecast.js +93 -0
  45. package/dist/prompts/cash-flow-forecast.js.map +1 -0
  46. package/dist/prompts/index.d.ts +8 -0
  47. package/dist/prompts/index.d.ts.map +1 -0
  48. package/dist/prompts/index.js +8 -0
  49. package/dist/prompts/index.js.map +1 -0
  50. package/dist/prompts/invoice-from-description.d.ts +12 -0
  51. package/dist/prompts/invoice-from-description.d.ts.map +1 -0
  52. package/dist/prompts/invoice-from-description.js +49 -0
  53. package/dist/prompts/invoice-from-description.js.map +1 -0
  54. package/dist/prompts/monthly-expense-summary.d.ts +12 -0
  55. package/dist/prompts/monthly-expense-summary.d.ts.map +1 -0
  56. package/dist/prompts/monthly-expense-summary.js +84 -0
  57. package/dist/prompts/monthly-expense-summary.js.map +1 -0
  58. package/dist/prompts/overdue-invoice-followup.d.ts +12 -0
  59. package/dist/prompts/overdue-invoice-followup.d.ts.map +1 -0
  60. package/dist/prompts/overdue-invoice-followup.js +63 -0
  61. package/dist/prompts/overdue-invoice-followup.js.map +1 -0
  62. package/dist/prompts/project-profitability.d.ts +12 -0
  63. package/dist/prompts/project-profitability.d.ts.map +1 -0
  64. package/dist/prompts/project-profitability.js +103 -0
  65. package/dist/prompts/project-profitability.js.map +1 -0
  66. package/dist/prompts/quarterly-tax-estimate.d.ts +12 -0
  67. package/dist/prompts/quarterly-tax-estimate.d.ts.map +1 -0
  68. package/dist/prompts/quarterly-tax-estimate.js +132 -0
  69. package/dist/prompts/quarterly-tax-estimate.js.map +1 -0
  70. package/dist/prompts/transaction-categorization.d.ts +12 -0
  71. package/dist/prompts/transaction-categorization.d.ts.map +1 -0
  72. package/dist/prompts/transaction-categorization.js +81 -0
  73. package/dist/prompts/transaction-categorization.js.map +1 -0
  74. package/dist/resources/bank-accounts.d.ts +8 -0
  75. package/dist/resources/bank-accounts.d.ts.map +1 -0
  76. package/dist/resources/bank-accounts.js +34 -0
  77. package/dist/resources/bank-accounts.js.map +1 -0
  78. package/dist/resources/bank-transactions.d.ts +11 -0
  79. package/dist/resources/bank-transactions.d.ts.map +1 -0
  80. package/dist/resources/bank-transactions.js +34 -0
  81. package/dist/resources/bank-transactions.js.map +1 -0
  82. package/dist/resources/bills.d.ts +13 -0
  83. package/dist/resources/bills.d.ts.map +1 -0
  84. package/dist/resources/bills.js +38 -0
  85. package/dist/resources/bills.js.map +1 -0
  86. package/dist/resources/categories.d.ts +4 -0
  87. package/dist/resources/categories.d.ts.map +1 -0
  88. package/dist/resources/categories.js +21 -0
  89. package/dist/resources/categories.js.map +1 -0
  90. package/dist/resources/company.d.ts +3 -0
  91. package/dist/resources/company.d.ts.map +1 -0
  92. package/dist/resources/company.js +12 -0
  93. package/dist/resources/company.js.map +1 -0
  94. package/dist/resources/contacts.d.ts +9 -0
  95. package/dist/resources/contacts.d.ts.map +1 -0
  96. package/dist/resources/contacts.js +37 -0
  97. package/dist/resources/contacts.js.map +1 -0
  98. package/dist/resources/expenses.d.ts +12 -0
  99. package/dist/resources/expenses.d.ts.map +1 -0
  100. package/dist/resources/expenses.js +36 -0
  101. package/dist/resources/expenses.js.map +1 -0
  102. package/dist/resources/index.d.ts +20 -0
  103. package/dist/resources/index.d.ts.map +1 -0
  104. package/dist/resources/index.js +12 -0
  105. package/dist/resources/index.js.map +1 -0
  106. package/dist/resources/invoices.d.ts +14 -0
  107. package/dist/resources/invoices.d.ts.map +1 -0
  108. package/dist/resources/invoices.js +40 -0
  109. package/dist/resources/invoices.js.map +1 -0
  110. package/dist/resources/projects.d.ts +10 -0
  111. package/dist/resources/projects.d.ts.map +1 -0
  112. package/dist/resources/projects.js +39 -0
  113. package/dist/resources/projects.js.map +1 -0
  114. package/dist/resources/timeslips.d.ts +12 -0
  115. package/dist/resources/timeslips.d.ts.map +1 -0
  116. package/dist/resources/timeslips.js +36 -0
  117. package/dist/resources/timeslips.js.map +1 -0
  118. package/dist/resources/users.d.ts +5 -0
  119. package/dist/resources/users.d.ts.map +1 -0
  120. package/dist/resources/users.js +30 -0
  121. package/dist/resources/users.js.map +1 -0
  122. package/dist/server.d.ts +9 -0
  123. package/dist/server.d.ts.map +1 -0
  124. package/dist/server.js +568 -0
  125. package/dist/server.js.map +1 -0
  126. package/dist/tools/bank-tools.d.ts +112 -0
  127. package/dist/tools/bank-tools.d.ts.map +1 -0
  128. package/dist/tools/bank-tools.js +143 -0
  129. package/dist/tools/bank-tools.js.map +1 -0
  130. package/dist/tools/bill-tools.d.ts +129 -0
  131. package/dist/tools/bill-tools.d.ts.map +1 -0
  132. package/dist/tools/bill-tools.js +121 -0
  133. package/dist/tools/bill-tools.js.map +1 -0
  134. package/dist/tools/contact-tools.d.ts +147 -0
  135. package/dist/tools/contact-tools.d.ts.map +1 -0
  136. package/dist/tools/contact-tools.js +140 -0
  137. package/dist/tools/contact-tools.js.map +1 -0
  138. package/dist/tools/index.d.ts +13 -0
  139. package/dist/tools/index.d.ts.map +1 -0
  140. package/dist/tools/index.js +13 -0
  141. package/dist/tools/index.js.map +1 -0
  142. package/dist/tools/invoice-tools.d.ts +171 -0
  143. package/dist/tools/invoice-tools.d.ts.map +1 -0
  144. package/dist/tools/invoice-tools.js +168 -0
  145. package/dist/tools/invoice-tools.js.map +1 -0
  146. package/dist/tools/project-tools.d.ts +117 -0
  147. package/dist/tools/project-tools.d.ts.map +1 -0
  148. package/dist/tools/project-tools.js +153 -0
  149. package/dist/tools/project-tools.js.map +1 -0
  150. package/dist/tools/query-tools.d.ts +91 -0
  151. package/dist/tools/query-tools.d.ts.map +1 -0
  152. package/dist/tools/query-tools.js +127 -0
  153. package/dist/tools/query-tools.js.map +1 -0
  154. package/dist/transformers/bank-transformer.d.ts +8 -0
  155. package/dist/transformers/bank-transformer.d.ts.map +1 -0
  156. package/dist/transformers/bank-transformer.js +46 -0
  157. package/dist/transformers/bank-transformer.js.map +1 -0
  158. package/dist/transformers/bill-transformer.d.ts +6 -0
  159. package/dist/transformers/bill-transformer.d.ts.map +1 -0
  160. package/dist/transformers/bill-transformer.js +34 -0
  161. package/dist/transformers/bill-transformer.js.map +1 -0
  162. package/dist/transformers/category-transformer.d.ts +5 -0
  163. package/dist/transformers/category-transformer.d.ts.map +1 -0
  164. package/dist/transformers/category-transformer.js +14 -0
  165. package/dist/transformers/category-transformer.js.map +1 -0
  166. package/dist/transformers/common.d.ts +7 -0
  167. package/dist/transformers/common.d.ts.map +1 -0
  168. package/dist/transformers/common.js +33 -0
  169. package/dist/transformers/common.js.map +1 -0
  170. package/dist/transformers/company-transformer.d.ts +4 -0
  171. package/dist/transformers/company-transformer.d.ts.map +1 -0
  172. package/dist/transformers/company-transformer.js +10 -0
  173. package/dist/transformers/company-transformer.js.map +1 -0
  174. package/dist/transformers/contact-transformer.d.ts +5 -0
  175. package/dist/transformers/contact-transformer.d.ts.map +1 -0
  176. package/dist/transformers/contact-transformer.js +18 -0
  177. package/dist/transformers/contact-transformer.js.map +1 -0
  178. package/dist/transformers/expense-transformer.d.ts +5 -0
  179. package/dist/transformers/expense-transformer.d.ts.map +1 -0
  180. package/dist/transformers/expense-transformer.js +19 -0
  181. package/dist/transformers/expense-transformer.js.map +1 -0
  182. package/dist/transformers/index.d.ts +11 -0
  183. package/dist/transformers/index.d.ts.map +1 -0
  184. package/dist/transformers/index.js +11 -0
  185. package/dist/transformers/index.js.map +1 -0
  186. package/dist/transformers/invoice-transformer.d.ts +6 -0
  187. package/dist/transformers/invoice-transformer.d.ts.map +1 -0
  188. package/dist/transformers/invoice-transformer.js +39 -0
  189. package/dist/transformers/invoice-transformer.js.map +1 -0
  190. package/dist/transformers/project-transformer.d.ts +9 -0
  191. package/dist/transformers/project-transformer.d.ts.map +1 -0
  192. package/dist/transformers/project-transformer.js +53 -0
  193. package/dist/transformers/project-transformer.js.map +1 -0
  194. package/dist/transformers/user-transformer.d.ts +5 -0
  195. package/dist/transformers/user-transformer.d.ts.map +1 -0
  196. package/dist/transformers/user-transformer.js +14 -0
  197. package/dist/transformers/user-transformer.js.map +1 -0
  198. package/dist/types/freeagent/index.d.ts +256 -0
  199. package/dist/types/freeagent/index.d.ts.map +1 -0
  200. package/dist/types/freeagent/index.js +3 -0
  201. package/dist/types/freeagent/index.js.map +1 -0
  202. package/dist/types/llm/index.d.ts +159 -0
  203. package/dist/types/llm/index.d.ts.map +1 -0
  204. package/dist/types/llm/index.js +3 -0
  205. package/dist/types/llm/index.js.map +1 -0
  206. package/dist/utils/error-handler.d.ts +11 -0
  207. package/dist/utils/error-handler.d.ts.map +1 -0
  208. package/dist/utils/error-handler.js +57 -0
  209. package/dist/utils/error-handler.js.map +1 -0
  210. package/dist/utils/index.d.ts +5 -0
  211. package/dist/utils/index.d.ts.map +1 -0
  212. package/dist/utils/index.js +5 -0
  213. package/dist/utils/index.js.map +1 -0
  214. package/dist/utils/sanitizer.d.ts +4 -0
  215. package/dist/utils/sanitizer.d.ts.map +1 -0
  216. package/dist/utils/sanitizer.js +42 -0
  217. package/dist/utils/sanitizer.js.map +1 -0
  218. package/dist/utils/validators.d.ts +19 -0
  219. package/dist/utils/validators.d.ts.map +1 -0
  220. package/dist/utils/validators.js +83 -0
  221. package/dist/utils/validators.js.map +1 -0
  222. package/dist/utils/zod-to-json-schema.d.ts +24 -0
  223. package/dist/utils/zod-to-json-schema.d.ts.map +1 -0
  224. package/dist/utils/zod-to-json-schema.js +141 -0
  225. package/dist/utils/zod-to-json-schema.js.map +1 -0
  226. package/package.json +48 -0
@@ -0,0 +1,112 @@
1
+ import { z } from 'zod';
2
+ import type { FreeAgentClient } from '../api/freeagent-client.js';
3
+ export declare const explainTransactionSchema: z.ZodObject<{
4
+ transaction_id: z.ZodString;
5
+ category: z.ZodString;
6
+ description: z.ZodOptional<z.ZodString>;
7
+ dated_on: z.ZodOptional<z.ZodString>;
8
+ gross_value: z.ZodOptional<z.ZodNumber>;
9
+ sales_tax_rate: z.ZodOptional<z.ZodNumber>;
10
+ project_id: z.ZodOptional<z.ZodString>;
11
+ }, "strip", z.ZodTypeAny, {
12
+ transaction_id: string;
13
+ category: string;
14
+ description?: string | undefined;
15
+ sales_tax_rate?: number | undefined;
16
+ dated_on?: string | undefined;
17
+ project_id?: string | undefined;
18
+ gross_value?: number | undefined;
19
+ }, {
20
+ transaction_id: string;
21
+ category: string;
22
+ description?: string | undefined;
23
+ sales_tax_rate?: number | undefined;
24
+ dated_on?: string | undefined;
25
+ project_id?: string | undefined;
26
+ gross_value?: number | undefined;
27
+ }>;
28
+ export type ExplainTransactionInput = z.infer<typeof explainTransactionSchema>;
29
+ export declare function explainTransaction(client: FreeAgentClient, input: ExplainTransactionInput, bankAccountNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMBankTransaction>;
30
+ export declare const matchTransactionToInvoiceSchema: z.ZodObject<{
31
+ transaction_id: z.ZodString;
32
+ invoice_id: z.ZodString;
33
+ dated_on: z.ZodOptional<z.ZodString>;
34
+ }, "strip", z.ZodTypeAny, {
35
+ invoice_id: string;
36
+ transaction_id: string;
37
+ dated_on?: string | undefined;
38
+ }, {
39
+ invoice_id: string;
40
+ transaction_id: string;
41
+ dated_on?: string | undefined;
42
+ }>;
43
+ export type MatchTransactionToInvoiceInput = z.infer<typeof matchTransactionToInvoiceSchema>;
44
+ export declare function matchTransactionToInvoice(client: FreeAgentClient, input: MatchTransactionToInvoiceInput, bankAccountNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMBankTransaction>;
45
+ export declare const matchTransactionToBillSchema: z.ZodObject<{
46
+ transaction_id: z.ZodString;
47
+ bill_id: z.ZodString;
48
+ dated_on: z.ZodOptional<z.ZodString>;
49
+ }, "strip", z.ZodTypeAny, {
50
+ transaction_id: string;
51
+ bill_id: string;
52
+ dated_on?: string | undefined;
53
+ }, {
54
+ transaction_id: string;
55
+ bill_id: string;
56
+ dated_on?: string | undefined;
57
+ }>;
58
+ export type MatchTransactionToBillInput = z.infer<typeof matchTransactionToBillSchema>;
59
+ export declare function matchTransactionToBill(client: FreeAgentClient, input: MatchTransactionToBillInput, bankAccountNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMBankTransaction>;
60
+ export declare const splitTransactionSchema: z.ZodObject<{
61
+ transaction_id: z.ZodString;
62
+ splits: z.ZodArray<z.ZodObject<{
63
+ category: z.ZodString;
64
+ gross_value: z.ZodNumber;
65
+ description: z.ZodOptional<z.ZodString>;
66
+ sales_tax_rate: z.ZodOptional<z.ZodNumber>;
67
+ }, "strip", z.ZodTypeAny, {
68
+ category: string;
69
+ gross_value: number;
70
+ description?: string | undefined;
71
+ sales_tax_rate?: number | undefined;
72
+ }, {
73
+ category: string;
74
+ gross_value: number;
75
+ description?: string | undefined;
76
+ sales_tax_rate?: number | undefined;
77
+ }>, "many">;
78
+ }, "strip", z.ZodTypeAny, {
79
+ transaction_id: string;
80
+ splits: {
81
+ category: string;
82
+ gross_value: number;
83
+ description?: string | undefined;
84
+ sales_tax_rate?: number | undefined;
85
+ }[];
86
+ }, {
87
+ transaction_id: string;
88
+ splits: {
89
+ category: string;
90
+ gross_value: number;
91
+ description?: string | undefined;
92
+ sales_tax_rate?: number | undefined;
93
+ }[];
94
+ }>;
95
+ export type SplitTransactionInput = z.infer<typeof splitTransactionSchema>;
96
+ export declare function splitTransaction(client: FreeAgentClient, input: SplitTransactionInput, bankAccountNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMBankTransaction>;
97
+ export declare const unexplainTransactionSchema: z.ZodObject<{
98
+ transaction_id: z.ZodString;
99
+ explanation_id: z.ZodString;
100
+ }, "strip", z.ZodTypeAny, {
101
+ transaction_id: string;
102
+ explanation_id: string;
103
+ }, {
104
+ transaction_id: string;
105
+ explanation_id: string;
106
+ }>;
107
+ export type UnexplainTransactionInput = z.infer<typeof unexplainTransactionSchema>;
108
+ export declare function unexplainTransaction(client: FreeAgentClient, input: UnexplainTransactionInput): Promise<{
109
+ success: boolean;
110
+ message: string;
111
+ }>;
112
+ //# sourceMappingURL=bank-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bank-tools.d.ts","sourceRoot":"","sources":["../../src/tools/bank-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AASlE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,uBAAuB,EAC9B,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,+DAkC5C;AAGD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAI1C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE7F,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,8BAA8B,EACrC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,+DAsB5C;AAGD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAIvC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEvF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,2BAA2B,EAClC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,+DAsB5C;AAUD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,qBAAqB,EAC5B,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,+DAqC5C;AAGD,eAAO,MAAM,0BAA0B;;;;;;;;;EAGrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,yBAAyB;;;GAajC"}
@@ -0,0 +1,143 @@
1
+ import { z } from 'zod';
2
+ import { transformBankTransaction } from '../transformers/bank-transformer.js';
3
+ import { handleToolError } from '../utils/error-handler.js';
4
+ import { normalizeCategoryUrl, normalizeInvoiceId, normalizeBillId, normalizeProjectId } from '../utils/validators.js';
5
+ import { FREEAGENT_API_BASE } from '../config.js';
6
+ import { sanitizeInput } from '../utils/sanitizer.js';
7
+ // Explain transaction schema
8
+ export const explainTransactionSchema = z.object({
9
+ transaction_id: z.string().min(1),
10
+ category: z.string().min(1),
11
+ description: z.string().optional(),
12
+ dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
13
+ gross_value: z.number().optional(),
14
+ sales_tax_rate: z.number().optional(),
15
+ project_id: z.string().optional(),
16
+ });
17
+ export async function explainTransaction(client, input, bankAccountNameLookup) {
18
+ try {
19
+ const validated = explainTransactionSchema.parse(input);
20
+ const explanationData = {
21
+ category: normalizeCategoryUrl(validated.category, FREEAGENT_API_BASE),
22
+ };
23
+ if (validated.description) {
24
+ explanationData['description'] = sanitizeInput(validated.description);
25
+ }
26
+ if (validated.dated_on) {
27
+ explanationData['dated_on'] = validated.dated_on;
28
+ }
29
+ if (validated.gross_value !== undefined) {
30
+ explanationData['gross_value'] = validated.gross_value.toString();
31
+ }
32
+ if (validated.sales_tax_rate !== undefined) {
33
+ explanationData['sales_tax_rate'] = validated.sales_tax_rate.toString();
34
+ }
35
+ if (validated.project_id) {
36
+ explanationData['rebill_to_project'] = normalizeProjectId(validated.project_id, FREEAGENT_API_BASE);
37
+ }
38
+ const response = await client.post(`/bank_transactions/${validated.transaction_id}/bank_transaction_explanations`, { bank_transaction_explanation: explanationData });
39
+ return transformBankTransaction(response.bank_transaction, bankAccountNameLookup);
40
+ }
41
+ catch (error) {
42
+ handleToolError(error, 'explain_transaction');
43
+ }
44
+ }
45
+ // Match transaction to invoice schema
46
+ export const matchTransactionToInvoiceSchema = z.object({
47
+ transaction_id: z.string().min(1),
48
+ invoice_id: z.string().min(1),
49
+ dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
50
+ });
51
+ export async function matchTransactionToInvoice(client, input, bankAccountNameLookup) {
52
+ try {
53
+ const validated = matchTransactionToInvoiceSchema.parse(input);
54
+ const explanationData = {
55
+ paid_invoice: normalizeInvoiceId(validated.invoice_id, FREEAGENT_API_BASE),
56
+ };
57
+ if (validated.dated_on) {
58
+ explanationData['dated_on'] = validated.dated_on;
59
+ }
60
+ const response = await client.post(`/bank_transactions/${validated.transaction_id}/bank_transaction_explanations`, { bank_transaction_explanation: explanationData });
61
+ return transformBankTransaction(response.bank_transaction, bankAccountNameLookup);
62
+ }
63
+ catch (error) {
64
+ handleToolError(error, 'match_transaction_to_invoice');
65
+ }
66
+ }
67
+ // Match transaction to bill schema
68
+ export const matchTransactionToBillSchema = z.object({
69
+ transaction_id: z.string().min(1),
70
+ bill_id: z.string().min(1),
71
+ dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
72
+ });
73
+ export async function matchTransactionToBill(client, input, bankAccountNameLookup) {
74
+ try {
75
+ const validated = matchTransactionToBillSchema.parse(input);
76
+ const explanationData = {
77
+ paid_bill: normalizeBillId(validated.bill_id, FREEAGENT_API_BASE),
78
+ };
79
+ if (validated.dated_on) {
80
+ explanationData['dated_on'] = validated.dated_on;
81
+ }
82
+ const response = await client.post(`/bank_transactions/${validated.transaction_id}/bank_transaction_explanations`, { bank_transaction_explanation: explanationData });
83
+ return transformBankTransaction(response.bank_transaction, bankAccountNameLookup);
84
+ }
85
+ catch (error) {
86
+ handleToolError(error, 'match_transaction_to_bill');
87
+ }
88
+ }
89
+ // Split transaction schema
90
+ const splitItemSchema = z.object({
91
+ category: z.string().min(1),
92
+ gross_value: z.number(),
93
+ description: z.string().optional(),
94
+ sales_tax_rate: z.number().optional(),
95
+ });
96
+ export const splitTransactionSchema = z.object({
97
+ transaction_id: z.string().min(1),
98
+ splits: z.array(splitItemSchema).min(2),
99
+ });
100
+ export async function splitTransaction(client, input, bankAccountNameLookup) {
101
+ try {
102
+ const validated = splitTransactionSchema.parse(input);
103
+ // Create multiple explanations for the transaction
104
+ let result = null;
105
+ for (const split of validated.splits) {
106
+ const explanationData = {
107
+ category: normalizeCategoryUrl(split.category, FREEAGENT_API_BASE),
108
+ gross_value: split.gross_value.toString(),
109
+ };
110
+ if (split.description) {
111
+ explanationData['description'] = sanitizeInput(split.description);
112
+ }
113
+ if (split.sales_tax_rate !== undefined) {
114
+ explanationData['sales_tax_rate'] = split.sales_tax_rate.toString();
115
+ }
116
+ const response = await client.post(`/bank_transactions/${validated.transaction_id}/bank_transaction_explanations`, { bank_transaction_explanation: explanationData });
117
+ result = response.bank_transaction;
118
+ }
119
+ if (!result) {
120
+ throw new Error('Failed to split transaction');
121
+ }
122
+ return transformBankTransaction(result, bankAccountNameLookup);
123
+ }
124
+ catch (error) {
125
+ handleToolError(error, 'split_transaction');
126
+ }
127
+ }
128
+ // Unexplain transaction schema
129
+ export const unexplainTransactionSchema = z.object({
130
+ transaction_id: z.string().min(1),
131
+ explanation_id: z.string().min(1),
132
+ });
133
+ export async function unexplainTransaction(client, input) {
134
+ try {
135
+ const validated = unexplainTransactionSchema.parse(input);
136
+ await client.delete(`/bank_transactions/${validated.transaction_id}/bank_transaction_explanations/${validated.explanation_id}`);
137
+ return { success: true, message: 'Transaction explanation removed' };
138
+ }
139
+ catch (error) {
140
+ handleToolError(error, 'unexplain_transaction');
141
+ }
142
+ }
143
+ //# sourceMappingURL=bank-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bank-tools.js","sourceRoot":"","sources":["../../src/tools/bank-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,129 @@
1
+ import { z } from 'zod';
2
+ import type { FreeAgentClient } from '../api/freeagent-client.js';
3
+ export declare const createBillSchema: z.ZodObject<{
4
+ contact_id: z.ZodString;
5
+ reference: z.ZodString;
6
+ dated_on: z.ZodString;
7
+ due_on: z.ZodOptional<z.ZodString>;
8
+ currency: z.ZodDefault<z.ZodString>;
9
+ bill_items: z.ZodArray<z.ZodObject<{
10
+ category: z.ZodString;
11
+ description: z.ZodOptional<z.ZodString>;
12
+ total_value: z.ZodNumber;
13
+ sales_tax_rate: z.ZodOptional<z.ZodNumber>;
14
+ project_id: z.ZodOptional<z.ZodString>;
15
+ }, "strip", z.ZodTypeAny, {
16
+ category: string;
17
+ total_value: number;
18
+ description?: string | undefined;
19
+ sales_tax_rate?: number | undefined;
20
+ project_id?: string | undefined;
21
+ }, {
22
+ category: string;
23
+ total_value: number;
24
+ description?: string | undefined;
25
+ sales_tax_rate?: number | undefined;
26
+ project_id?: string | undefined;
27
+ }>, "many">;
28
+ comments: z.ZodOptional<z.ZodString>;
29
+ ec_status: z.ZodOptional<z.ZodEnum<["UK/Non-EC", "EC w/ VAT", "EC VAT Exempt", "EC Reverse Charge"]>>;
30
+ }, "strip", z.ZodTypeAny, {
31
+ contact_id: string;
32
+ dated_on: string;
33
+ currency: string;
34
+ reference: string;
35
+ bill_items: {
36
+ category: string;
37
+ total_value: number;
38
+ description?: string | undefined;
39
+ sales_tax_rate?: number | undefined;
40
+ project_id?: string | undefined;
41
+ }[];
42
+ comments?: string | undefined;
43
+ ec_status?: "UK/Non-EC" | "EC w/ VAT" | "EC VAT Exempt" | "EC Reverse Charge" | undefined;
44
+ due_on?: string | undefined;
45
+ }, {
46
+ contact_id: string;
47
+ dated_on: string;
48
+ reference: string;
49
+ bill_items: {
50
+ category: string;
51
+ total_value: number;
52
+ description?: string | undefined;
53
+ sales_tax_rate?: number | undefined;
54
+ project_id?: string | undefined;
55
+ }[];
56
+ currency?: string | undefined;
57
+ comments?: string | undefined;
58
+ ec_status?: "UK/Non-EC" | "EC w/ VAT" | "EC VAT Exempt" | "EC Reverse Charge" | undefined;
59
+ due_on?: string | undefined;
60
+ }>;
61
+ export type CreateBillInput = z.infer<typeof createBillSchema>;
62
+ export declare function createBill(client: FreeAgentClient, input: CreateBillInput, contactNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMBill>;
63
+ export declare const updateBillSchema: z.ZodObject<{
64
+ bill_id: z.ZodString;
65
+ reference: z.ZodOptional<z.ZodString>;
66
+ dated_on: z.ZodOptional<z.ZodString>;
67
+ due_on: z.ZodOptional<z.ZodString>;
68
+ comments: z.ZodOptional<z.ZodString>;
69
+ bill_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
70
+ category: z.ZodString;
71
+ description: z.ZodOptional<z.ZodString>;
72
+ total_value: z.ZodNumber;
73
+ sales_tax_rate: z.ZodOptional<z.ZodNumber>;
74
+ project_id: z.ZodOptional<z.ZodString>;
75
+ }, "strip", z.ZodTypeAny, {
76
+ category: string;
77
+ total_value: number;
78
+ description?: string | undefined;
79
+ sales_tax_rate?: number | undefined;
80
+ project_id?: string | undefined;
81
+ }, {
82
+ category: string;
83
+ total_value: number;
84
+ description?: string | undefined;
85
+ sales_tax_rate?: number | undefined;
86
+ project_id?: string | undefined;
87
+ }>, "many">>;
88
+ }, "strip", z.ZodTypeAny, {
89
+ bill_id: string;
90
+ dated_on?: string | undefined;
91
+ comments?: string | undefined;
92
+ reference?: string | undefined;
93
+ due_on?: string | undefined;
94
+ bill_items?: {
95
+ category: string;
96
+ total_value: number;
97
+ description?: string | undefined;
98
+ sales_tax_rate?: number | undefined;
99
+ project_id?: string | undefined;
100
+ }[] | undefined;
101
+ }, {
102
+ bill_id: string;
103
+ dated_on?: string | undefined;
104
+ comments?: string | undefined;
105
+ reference?: string | undefined;
106
+ due_on?: string | undefined;
107
+ bill_items?: {
108
+ category: string;
109
+ total_value: number;
110
+ description?: string | undefined;
111
+ sales_tax_rate?: number | undefined;
112
+ project_id?: string | undefined;
113
+ }[] | undefined;
114
+ }>;
115
+ export type UpdateBillInput = z.infer<typeof updateBillSchema>;
116
+ export declare function updateBill(client: FreeAgentClient, input: UpdateBillInput, contactNameLookup?: Map<string, string>): Promise<import("../types/llm/index.js").LLMBill>;
117
+ export declare const deleteBillSchema: z.ZodObject<{
118
+ bill_id: z.ZodString;
119
+ }, "strip", z.ZodTypeAny, {
120
+ bill_id: string;
121
+ }, {
122
+ bill_id: string;
123
+ }>;
124
+ export type DeleteBillInput = z.infer<typeof deleteBillSchema>;
125
+ export declare function deleteBill(client: FreeAgentClient, input: DeleteBillInput): Promise<{
126
+ success: boolean;
127
+ message: string;
128
+ }>;
129
+ //# sourceMappingURL=bill-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bill-tools.d.ts","sourceRoot":"","sources":["../../src/tools/bill-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAkBlE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS3B,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,EACtB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,oDAkCxC;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,EACtB,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,oDAkCxC;AAGD,eAAO,MAAM,gBAAgB;;;;;;EAE3B,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;;;GAWvB"}
@@ -0,0 +1,121 @@
1
+ import { z } from 'zod';
2
+ import { transformBill } from '../transformers/bill-transformer.js';
3
+ import { handleToolError } from '../utils/error-handler.js';
4
+ import { normalizeContactId, normalizeCategoryUrl, normalizeProjectId } from '../utils/validators.js';
5
+ import { FREEAGENT_API_BASE } from '../config.js';
6
+ import { sanitizeInput } from '../utils/sanitizer.js';
7
+ // Bill item schema
8
+ const billItemSchema = z.object({
9
+ category: z.string().min(1),
10
+ description: z.string().optional(),
11
+ total_value: z.number(),
12
+ sales_tax_rate: z.number().optional(),
13
+ project_id: z.string().optional(),
14
+ });
15
+ // Create bill schema
16
+ export const createBillSchema = z.object({
17
+ contact_id: z.string().min(1),
18
+ reference: z.string().min(1),
19
+ dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
20
+ due_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
21
+ currency: z.string().length(3).default('GBP'),
22
+ bill_items: z.array(billItemSchema).min(1),
23
+ comments: z.string().optional(),
24
+ ec_status: z.enum(['UK/Non-EC', 'EC w/ VAT', 'EC VAT Exempt', 'EC Reverse Charge']).optional(),
25
+ });
26
+ export async function createBill(client, input, contactNameLookup) {
27
+ try {
28
+ const validated = createBillSchema.parse(input);
29
+ const billData = {
30
+ contact: normalizeContactId(validated.contact_id, FREEAGENT_API_BASE),
31
+ reference: sanitizeInput(validated.reference),
32
+ dated_on: validated.dated_on,
33
+ currency: validated.currency.toUpperCase(),
34
+ bill_items: validated.bill_items.map((item) => {
35
+ const itemData = {
36
+ category: normalizeCategoryUrl(item.category, FREEAGENT_API_BASE),
37
+ total_value: item.total_value.toString(),
38
+ };
39
+ if (item.description)
40
+ itemData['description'] = sanitizeInput(item.description);
41
+ if (item.sales_tax_rate !== undefined)
42
+ itemData['sales_tax_rate'] = item.sales_tax_rate.toString();
43
+ if (item.project_id)
44
+ itemData['project'] = normalizeProjectId(item.project_id, FREEAGENT_API_BASE);
45
+ return itemData;
46
+ }),
47
+ };
48
+ if (validated.due_on)
49
+ billData['due_on'] = validated.due_on;
50
+ if (validated.comments)
51
+ billData['comments'] = sanitizeInput(validated.comments);
52
+ if (validated.ec_status)
53
+ billData['ec_status'] = validated.ec_status;
54
+ const response = await client.post('/bills', {
55
+ bill: billData,
56
+ });
57
+ return transformBill(response.bill, contactNameLookup);
58
+ }
59
+ catch (error) {
60
+ handleToolError(error, 'create_bill');
61
+ }
62
+ }
63
+ // Update bill schema
64
+ export const updateBillSchema = z.object({
65
+ bill_id: z.string().min(1),
66
+ reference: z.string().optional(),
67
+ dated_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
68
+ due_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
69
+ comments: z.string().optional(),
70
+ bill_items: z.array(billItemSchema).min(1).optional(),
71
+ });
72
+ export async function updateBill(client, input, contactNameLookup) {
73
+ try {
74
+ const validated = updateBillSchema.parse(input);
75
+ const { bill_id, ...fields } = validated;
76
+ const billData = {};
77
+ if (fields.reference !== undefined)
78
+ billData['reference'] = sanitizeInput(fields.reference);
79
+ if (fields.dated_on !== undefined)
80
+ billData['dated_on'] = fields.dated_on;
81
+ if (fields.due_on !== undefined)
82
+ billData['due_on'] = fields.due_on;
83
+ if (fields.comments !== undefined)
84
+ billData['comments'] = sanitizeInput(fields.comments);
85
+ if (fields.bill_items) {
86
+ billData['bill_items'] = fields.bill_items.map((item) => {
87
+ const itemData = {
88
+ category: normalizeCategoryUrl(item.category, FREEAGENT_API_BASE),
89
+ total_value: item.total_value.toString(),
90
+ };
91
+ if (item.description)
92
+ itemData['description'] = sanitizeInput(item.description);
93
+ if (item.sales_tax_rate !== undefined)
94
+ itemData['sales_tax_rate'] = item.sales_tax_rate.toString();
95
+ if (item.project_id)
96
+ itemData['project'] = normalizeProjectId(item.project_id, FREEAGENT_API_BASE);
97
+ return itemData;
98
+ });
99
+ }
100
+ const response = await client.put(`/bills/${bill_id}`, { bill: billData });
101
+ return transformBill(response.bill, contactNameLookup);
102
+ }
103
+ catch (error) {
104
+ handleToolError(error, 'update_bill');
105
+ }
106
+ }
107
+ // Delete bill schema
108
+ export const deleteBillSchema = z.object({
109
+ bill_id: z.string().min(1),
110
+ });
111
+ export async function deleteBill(client, input) {
112
+ try {
113
+ const validated = deleteBillSchema.parse(input);
114
+ await client.delete(`/bills/${validated.bill_id}`);
115
+ return { success: true, message: 'Bill deleted' };
116
+ }
117
+ catch (error) {
118
+ handleToolError(error, 'delete_bill');
119
+ }
120
+ }
121
+ //# sourceMappingURL=bill-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bill-tools.js","sourceRoot":"","sources":["../../src/tools/bill-tools.ts"],"names":[],"mappings":"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"}