@tailormade/billit-mcp 1.1.1 → 1.1.2
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.
- package/dist/api/client.d.ts.map +1 -1
- package/dist/api/client.js +5 -4
- package/dist/api/client.js.map +1 -1
- package/dist/index.js +14 -4
- package/dist/index.js.map +1 -1
- package/dist/tools/documents.d.ts.map +1 -1
- package/dist/tools/documents.js +8 -15
- package/dist/tools/documents.js.map +1 -1
- package/dist/tools/financial.d.ts.map +1 -1
- package/dist/tools/financial.js +26 -30
- package/dist/tools/financial.js.map +1 -1
- package/dist/tools/orders.d.ts.map +1 -1
- package/dist/tools/orders.js +40 -28
- package/dist/tools/orders.js.map +1 -1
- package/dist/tools/parties.d.ts.map +1 -1
- package/dist/tools/parties.js +13 -16
- package/dist/tools/parties.js.map +1 -1
- package/dist/tools/peppol.d.ts.map +1 -1
- package/dist/tools/peppol.js +31 -19
- package/dist/tools/peppol.js.map +1 -1
- package/dist/tools/products.d.ts.map +1 -1
- package/dist/tools/products.js +7 -14
- package/dist/tools/products.js.map +1 -1
- package/dist/tools/toprocess.d.ts.map +1 -1
- package/dist/tools/toprocess.js +11 -3
- package/dist/tools/toprocess.js.map +1 -1
- package/dist/tools/utils.d.ts +26 -0
- package/dist/tools/utils.d.ts.map +1 -1
- package/dist/tools/utils.js +53 -1
- package/dist/tools/utils.js.map +1 -1
- package/dist/tools/workflows.d.ts.map +1 -1
- package/dist/tools/workflows.js +47 -52
- package/dist/tools/workflows.js.map +1 -1
- package/package.json +1 -1
package/dist/tools/parties.js
CHANGED
|
@@ -4,7 +4,7 @@ exports.registerPartyTools = registerPartyTools;
|
|
|
4
4
|
const zod_1 = require("zod");
|
|
5
5
|
const utils_js_1 = require("./utils.js");
|
|
6
6
|
function registerPartyTools(server, client) {
|
|
7
|
-
server.tool("billit_list_parties", "List parties (customers and/or suppliers) in Billit. Returns array with PartyID, CommercialName, VATNumber, Email, PartyType. Supports OData $filter, $orderby, full-text search. Next steps: billit_get_party for full details, billit_create_order to create an invoice for a party.\n\nEXAMPLES:\n- filter=\"PartyType eq 'Customer'\"\n- filter=\"DisplayName eq 'Acme NV'\"\n- orderby='CommercialName asc'
|
|
7
|
+
server.tool("billit_list_parties", (0, utils_js_1.withLlmTip)("List parties (customers and/or suppliers) in Billit. Returns array with PartyID, CommercialName, VATNumber, Email, PartyType. Supports OData $filter, $orderby, full-text search. Next steps: billit_get_party for full details, billit_create_order to create an invoice for a party.\n\nEXAMPLES:\n- filter=\"PartyType eq 'Customer'\"\n- filter=\"DisplayName eq 'Acme NV'\"\n- orderby='CommercialName asc'", "ERROR: fullTextSearch in $filter → CAUSE: fullTextSearch is a separate query param → FIX: pass as 'fullTextSearch' param, not inside $filter.\nPartyName/DisplayName may be empty in list responses — use billit_get_party to retrieve the full party name."), {
|
|
8
8
|
party_type: zod_1.z.enum(["Customer", "Supplier", "Both"]).optional().describe("Shortcut filter by party type. Equivalent to filter=\"PartyType eq '...'\"."),
|
|
9
9
|
filter: zod_1.z.string().optional().describe("OData $filter expression. Examples: \"DisplayName eq 'Acme NV'\", \"PartyType eq 'Customer'\". NOTE: If you also provide party_type, it will be merged with AND unless your filter already contains a PartyType condition."),
|
|
10
10
|
orderby: zod_1.z.string().optional().describe("OData $orderby expression. Examples: 'CommercialName asc', 'DisplayName desc'"),
|
|
@@ -14,23 +14,12 @@ function registerPartyTools(server, client) {
|
|
|
14
14
|
company_id: utils_js_1.companyId,
|
|
15
15
|
}, async ({ party_type, filter, orderby, search, top, skip, company_id }) => {
|
|
16
16
|
const filters = [];
|
|
17
|
-
if (party_type && !(filter && /PartyType/i.test(filter))) {
|
|
17
|
+
if (party_type && !(filter && /PartyType\s+eq\b/i.test(filter))) {
|
|
18
18
|
filters.push(`PartyType eq '${party_type}'`);
|
|
19
19
|
}
|
|
20
20
|
if (filter)
|
|
21
21
|
filters.push(filter);
|
|
22
|
-
const
|
|
23
|
-
if (filters.length)
|
|
24
|
-
params.set("$filter", filters.join(" and "));
|
|
25
|
-
if (orderby)
|
|
26
|
-
params.set("$orderby", orderby);
|
|
27
|
-
if (search)
|
|
28
|
-
params.set("fullTextSearch", search);
|
|
29
|
-
if (top)
|
|
30
|
-
params.set("$top", String(top));
|
|
31
|
-
if (skip)
|
|
32
|
-
params.set("$skip", String(skip));
|
|
33
|
-
const qs = params.toString();
|
|
22
|
+
const qs = (0, utils_js_1.buildODataParams)({ filter: filters.length ? filters.join(" and ") : undefined, search, orderby, top, skip });
|
|
34
23
|
const data = await client.request("GET", `/v1/parties${qs ? `?${qs}` : ""}`, undefined, company_id);
|
|
35
24
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
36
25
|
});
|
|
@@ -41,7 +30,7 @@ function registerPartyTools(server, client) {
|
|
|
41
30
|
const data = await client.request("GET", `/v1/parties/${party_id}`, undefined, company_id);
|
|
42
31
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
43
32
|
});
|
|
44
|
-
server.tool("billit_create_party", "Create a new customer or supplier party in Billit. Use billit_search_company first to auto-fill company details from KBO/VAT lookup. Returns the created PartyID. Next steps: billit_create_order to create an invoice for this party
|
|
33
|
+
server.tool("billit_create_party", (0, utils_js_1.withLlmTip)("Create a new customer or supplier party in Billit. Use billit_search_company first to auto-fill company details from KBO/VAT lookup. Returns the created PartyID. Next steps: billit_create_order to create an invoice for this party.", "Use billit_search_company with the company VAT/KBO number to look up official company data (name, address) before creating. This avoids typos and ensures correct data."), {
|
|
45
34
|
commercial_name: zod_1.z.string().describe("Company or person name (required)"),
|
|
46
35
|
party_type: zod_1.z.enum(["Customer", "Supplier", "Both"]).optional().describe("'Customer', 'Supplier', or 'Both' (default: Customer)"),
|
|
47
36
|
vat_number: zod_1.z.string().optional().describe("VAT number in BE format: BE0123456789"),
|
|
@@ -58,6 +47,7 @@ function registerPartyTools(server, client) {
|
|
|
58
47
|
city: zod_1.z.string().optional().describe("City name"),
|
|
59
48
|
country_code: zod_1.z.string().optional().describe("ISO country code (default: BE)"),
|
|
60
49
|
address_type: zod_1.z.enum(["InvoiceAddress", "DeliveryAddress"]).optional().describe("Address type: 'InvoiceAddress' (default) or 'DeliveryAddress'"),
|
|
50
|
+
dry_run: utils_js_1.coerceBool.describe("When true, validates input and returns what would be created without calling the API (default: false)"),
|
|
61
51
|
company_id: utils_js_1.companyId,
|
|
62
52
|
}, async (params) => {
|
|
63
53
|
const body = {
|
|
@@ -82,6 +72,9 @@ function registerPartyTools(server, client) {
|
|
|
82
72
|
CountryCode: params.country_code ?? "BE",
|
|
83
73
|
}];
|
|
84
74
|
}
|
|
75
|
+
if (params.dry_run) {
|
|
76
|
+
return (0, utils_js_1.respond)(`Dry run: would create party '${params.commercial_name}' (${params.party_type ?? "Customer"}). No changes made.`);
|
|
77
|
+
}
|
|
85
78
|
const data = await client.request("POST", "/v1/parties", body, params.company_id);
|
|
86
79
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
87
80
|
});
|
|
@@ -94,8 +87,9 @@ function registerPartyTools(server, client) {
|
|
|
94
87
|
language: zod_1.z.enum(["NL", "FR", "EN", "DE"]).optional().describe("Updated language: NL, FR, EN, or DE"),
|
|
95
88
|
iban: zod_1.z.string().optional().describe("Updated IBAN"),
|
|
96
89
|
bic: zod_1.z.string().optional().describe("Updated BIC/SWIFT"),
|
|
90
|
+
dry_run: utils_js_1.coerceBool.describe("When true, returns what would be updated without calling the API (default: false)"),
|
|
97
91
|
company_id: utils_js_1.companyId,
|
|
98
|
-
}, async ({ party_id, commercial_name, vat_number, email, phone, language, iban, bic, company_id }) => {
|
|
92
|
+
}, async ({ party_id, commercial_name, vat_number, email, phone, language, iban, bic, dry_run, company_id }) => {
|
|
99
93
|
const body = {};
|
|
100
94
|
if (commercial_name !== undefined)
|
|
101
95
|
body.CommercialName = commercial_name;
|
|
@@ -111,6 +105,9 @@ function registerPartyTools(server, client) {
|
|
|
111
105
|
body.IBAN = iban;
|
|
112
106
|
if (bic !== undefined)
|
|
113
107
|
body.BIC = bic;
|
|
108
|
+
if (dry_run) {
|
|
109
|
+
return (0, utils_js_1.respond)(`Dry run: would update party ${party_id} with ${JSON.stringify(body)}. No changes made.`);
|
|
110
|
+
}
|
|
114
111
|
const data = await client.request("PATCH", `/v1/parties/${party_id}`, body, company_id);
|
|
115
112
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
116
113
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"parties.js","sourceRoot":"","sources":["../../src/tools/parties.ts"],"names":[],"mappings":";;AAKA,
|
|
1
|
+
{"version":3,"file":"parties.js","sourceRoot":"","sources":["../../src/tools/parties.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"peppol.d.ts","sourceRoot":"","sources":["../../src/tools/peppol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,
|
|
1
|
+
{"version":3,"file":"peppol.d.ts","sourceRoot":"","sources":["../../src/tools/peppol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QAuH1E"}
|
package/dist/tools/peppol.js
CHANGED
|
@@ -10,51 +10,63 @@ function registerPeppolTools(server, client) {
|
|
|
10
10
|
skip: zod_1.z.coerce.number().optional().describe("Items to skip for pagination (default: 0)"),
|
|
11
11
|
company_id: utils_js_1.companyId,
|
|
12
12
|
}, async ({ orderby, top, skip, company_id }) => {
|
|
13
|
-
const
|
|
14
|
-
if (orderby)
|
|
15
|
-
params.set("$orderby", orderby);
|
|
16
|
-
if (top)
|
|
17
|
-
params.set("$top", String(top));
|
|
18
|
-
if (skip)
|
|
19
|
-
params.set("$skip", String(skip));
|
|
20
|
-
const qs = params.toString();
|
|
13
|
+
const qs = (0, utils_js_1.buildODataParams)({ orderby, top, skip });
|
|
21
14
|
const data = await client.request("GET", `/v1/peppol/inbox${qs ? `?${qs}` : ""}`, undefined, company_id);
|
|
22
15
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
23
16
|
});
|
|
24
17
|
server.tool("billit_peppol_confirm_inbox", "Accept an incoming Peppol message. Marks the item as processed and accepted. Use after reviewing an incoming e-invoice.", {
|
|
25
18
|
inbox_item_id: zod_1.z.string().describe("Inbox item ID from billit_peppol_list_inbox result"),
|
|
19
|
+
dry_run: utils_js_1.coerceBool.describe("When true, preview the action without executing it (default: false)"),
|
|
26
20
|
company_id: utils_js_1.companyId,
|
|
27
|
-
}, async ({ inbox_item_id, company_id }) => {
|
|
28
|
-
|
|
21
|
+
}, async ({ inbox_item_id, dry_run, company_id }) => {
|
|
22
|
+
if (dry_run) {
|
|
23
|
+
return (0, utils_js_1.respond)(JSON.stringify({ dry_run: true, would: `Confirm Peppol inbox item ${inbox_item_id}` }, null, 2));
|
|
24
|
+
}
|
|
25
|
+
const data = await client.request("POST", `/v1/peppol/inbox/${encodeURIComponent(inbox_item_id)}/confirm`, undefined, company_id);
|
|
29
26
|
return (0, utils_js_1.respond)(JSON.stringify(data ?? { success: true }, null, 2));
|
|
30
27
|
});
|
|
31
28
|
server.tool("billit_peppol_refuse_inbox", "Refuse/reject an incoming Peppol message. Use when an incoming e-invoice is incorrect or unexpected.", {
|
|
32
29
|
inbox_item_id: zod_1.z.string().describe("Inbox item ID from billit_peppol_list_inbox result"),
|
|
30
|
+
dry_run: utils_js_1.coerceBool.describe("When true, preview the action without executing it (default: false)"),
|
|
33
31
|
company_id: utils_js_1.companyId,
|
|
34
|
-
}, async ({ inbox_item_id, company_id }) => {
|
|
35
|
-
|
|
32
|
+
}, async ({ inbox_item_id, dry_run, company_id }) => {
|
|
33
|
+
if (dry_run) {
|
|
34
|
+
return (0, utils_js_1.respond)(JSON.stringify({ dry_run: true, would: `Refuse Peppol inbox item ${inbox_item_id}` }, null, 2));
|
|
35
|
+
}
|
|
36
|
+
const data = await client.request("POST", `/v1/peppol/inbox/${encodeURIComponent(inbox_item_id)}/refuse`, undefined, company_id);
|
|
36
37
|
return (0, utils_js_1.respond)(JSON.stringify(data ?? { success: true }, null, 2));
|
|
37
38
|
});
|
|
38
|
-
server.tool("billit_peppol_send_order", "Send a specific order directly via the Peppol e-invoicing network. Use billit_peppol_lookup_participant first to verify the customer is a Peppol participant. Prerequisites: order must be confirmed (ApprovalStatus=approved)
|
|
39
|
+
server.tool("billit_peppol_send_order", (0, utils_js_1.withLlmTip)("Send a specific order directly via the Peppol e-invoicing network. Use billit_peppol_lookup_participant first to verify the customer is a Peppol participant. Prerequisites: order must be confirmed (ApprovalStatus=approved).", "ERROR: Peppol send fails → CAUSE: customer not registered on Peppol → FIX: call billit_peppol_lookup_participant with their VAT/CBE number first. If not on Peppol, use billit_send_order (falls back to email) instead."), {
|
|
39
40
|
order_id: zod_1.z.coerce.number().describe("Numeric order ID to send via Peppol"),
|
|
41
|
+
dry_run: utils_js_1.coerceBool.describe("When true, preview the action without executing it (default: false)"),
|
|
40
42
|
company_id: utils_js_1.companyId,
|
|
41
|
-
}, async ({ order_id, company_id }) => {
|
|
43
|
+
}, async ({ order_id, dry_run, company_id }) => {
|
|
44
|
+
if (dry_run) {
|
|
45
|
+
return (0, utils_js_1.respond)(JSON.stringify({ dry_run: true, would: `Send order ${order_id} via Peppol` }, null, 2));
|
|
46
|
+
}
|
|
42
47
|
const data = await client.request("POST", "/v1/peppol/sendOrder", { OrderID: order_id }, company_id);
|
|
43
48
|
return (0, utils_js_1.respond)(JSON.stringify(data ?? { success: true }, null, 2));
|
|
44
49
|
});
|
|
45
50
|
server.tool("billit_peppol_lookup_participant", "Check if a company is registered as a Peppol participant. Returns participant information including endpoint and supported document types. Use before billit_peppol_send_order to verify the customer is reachable.", {
|
|
46
51
|
vat_or_cbe: zod_1.z.string().describe("Company VAT number (e.g. BE0123456789) or CBE/KBO enterprise number to look up on Peppol"),
|
|
47
|
-
|
|
48
|
-
|
|
52
|
+
company_id: utils_js_1.companyId,
|
|
53
|
+
}, async ({ vat_or_cbe, company_id }) => {
|
|
54
|
+
const data = await client.request("GET", `/v1/peppol/participantInformation/${encodeURIComponent(vat_or_cbe)}`, undefined, company_id);
|
|
49
55
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
50
56
|
});
|
|
51
|
-
server.tool("billit_peppol_register", "Register the current Billit party as a Peppol participant. Enables receiving e-invoices via Peppol and sending outgoing invoices via the network. One-time setup operation.", {
|
|
57
|
+
server.tool("billit_peppol_register", "Register the current Billit party as a Peppol participant. Enables receiving e-invoices via Peppol and sending outgoing invoices via the network. One-time setup operation.", {
|
|
58
|
+
dry_run: utils_js_1.coerceBool.describe("When true, preview the action without executing it (default: false)"),
|
|
59
|
+
company_id: utils_js_1.companyId,
|
|
60
|
+
}, async ({ dry_run, company_id }) => {
|
|
61
|
+
if (dry_run) {
|
|
62
|
+
return (0, utils_js_1.respond)(JSON.stringify({ dry_run: true, would: "Register party as Peppol participant" }, null, 2));
|
|
63
|
+
}
|
|
52
64
|
const data = await client.request("POST", "/v1/peppol/participants", undefined, company_id);
|
|
53
65
|
return (0, utils_js_1.respond)(JSON.stringify(data ?? { success: true }, null, 2));
|
|
54
66
|
});
|
|
55
|
-
server.tool("billit_peppol_unregister", "Unregister the current Billit party from the Peppol network. After this, the party can no longer receive or send via Peppol. Use with caution
|
|
67
|
+
server.tool("billit_peppol_unregister", (0, utils_js_1.withLlmTip)("Unregister the current Billit party from the Peppol network. After this, the party can no longer receive or send via Peppol. Use with caution. Supports dry_run=true to preview without making changes.", "Unregistering from Peppol is immediate and affects all incoming e-invoices. Always confirm with the user before calling this."), {
|
|
56
68
|
company_id: utils_js_1.companyId,
|
|
57
|
-
dry_run:
|
|
69
|
+
dry_run: utils_js_1.coerceBool
|
|
58
70
|
.describe("If true, returns what would happen without actually unregistering. Default: false."),
|
|
59
71
|
}, async ({ company_id, dry_run }) => {
|
|
60
72
|
if (dry_run) {
|
package/dist/tools/peppol.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"peppol.js","sourceRoot":"","sources":["../../src/tools/peppol.ts"],"names":[],"mappings":";;AAKA,
|
|
1
|
+
{"version":3,"file":"peppol.js","sourceRoot":"","sources":["../../src/tools/peppol.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,
|
|
1
|
+
{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA4D3E"}
|
package/dist/tools/products.js
CHANGED
|
@@ -12,18 +12,7 @@ function registerProductTools(server, client) {
|
|
|
12
12
|
skip: zod_1.z.coerce.number().optional().describe("Items to skip for pagination (default: 0)"),
|
|
13
13
|
company_id: utils_js_1.companyId,
|
|
14
14
|
}, async ({ filter, orderby, search, top, skip, company_id }) => {
|
|
15
|
-
const
|
|
16
|
-
if (filter)
|
|
17
|
-
params.set("$filter", filter);
|
|
18
|
-
if (orderby)
|
|
19
|
-
params.set("$orderby", orderby);
|
|
20
|
-
if (search)
|
|
21
|
-
params.set("fullTextSearch", search);
|
|
22
|
-
if (top)
|
|
23
|
-
params.set("$top", String(top));
|
|
24
|
-
if (skip)
|
|
25
|
-
params.set("$skip", String(skip));
|
|
26
|
-
const qs = params.toString();
|
|
15
|
+
const qs = (0, utils_js_1.buildODataParams)({ filter, search, orderby, top, skip });
|
|
27
16
|
const data = await client.request("GET", `/v1/products${qs ? `?${qs}` : ""}`, undefined, company_id);
|
|
28
17
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
29
18
|
});
|
|
@@ -34,14 +23,15 @@ function registerProductTools(server, client) {
|
|
|
34
23
|
const data = await client.request("GET", `/v1/products/${product_id}`, undefined, company_id);
|
|
35
24
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
36
25
|
});
|
|
37
|
-
server.tool("billit_create_product", "Create a new product in the Billit catalog, or update an existing product if one with the same reference already exists. Use to maintain a reusable product list for order lines
|
|
26
|
+
server.tool("billit_create_product", (0, utils_js_1.withLlmTip)("Create a new product in the Billit catalog, or update an existing product if one with the same reference already exists. Use to maintain a reusable product list for order lines.", "If a product with the same 'reference' already exists, this acts as an upsert (update). Use a unique reference code to distinguish products."), {
|
|
38
27
|
description: zod_1.z.string().describe("Product or service description (required)"),
|
|
39
28
|
reference: zod_1.z.string().optional().describe("Unique product reference/SKU code. If a product with this reference exists, it will be updated."),
|
|
40
29
|
unit_price: zod_1.z.coerce.number().optional().describe("Default unit price (excl. VAT) as decimal"),
|
|
41
30
|
vat_percentage: zod_1.z.coerce.number().optional().describe("VAT percentage as number (e.g. 21 for 21%, 0 for VAT exempt)"),
|
|
42
31
|
unit: zod_1.z.string().optional().describe("Unit of measure (e.g. 'piece', 'hour', 'kg')"),
|
|
32
|
+
dry_run: utils_js_1.coerceBool.describe("When true, validates input and returns what would be created without calling the API (default: false)"),
|
|
43
33
|
company_id: utils_js_1.companyId,
|
|
44
|
-
}, async ({ description, reference, unit_price, vat_percentage, unit, company_id }) => {
|
|
34
|
+
}, async ({ description, reference, unit_price, vat_percentage, unit, dry_run, company_id }) => {
|
|
45
35
|
const body = { Description: description };
|
|
46
36
|
if (reference !== undefined)
|
|
47
37
|
body.Reference = reference;
|
|
@@ -51,6 +41,9 @@ function registerProductTools(server, client) {
|
|
|
51
41
|
body.VATPercentage = vat_percentage;
|
|
52
42
|
if (unit !== undefined)
|
|
53
43
|
body.Unit = unit;
|
|
44
|
+
if (dry_run) {
|
|
45
|
+
return (0, utils_js_1.respond)(`Dry run: would create product '${description}'${reference ? ` (ref: ${reference})` : ""}. No changes made.`);
|
|
46
|
+
}
|
|
54
47
|
const data = await client.request("POST", "/v1/products", body, company_id);
|
|
55
48
|
return (0, utils_js_1.respond)(JSON.stringify(data, null, 2));
|
|
56
49
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":";;AAKA,
|
|
1
|
+
{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"toprocess.d.ts","sourceRoot":"","sources":["../../src/tools/toprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,
|
|
1
|
+
{"version":3,"file":"toprocess.d.ts","sourceRoot":"","sources":["../../src/tools/toprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QA0C7E"}
|
package/dist/tools/toprocess.js
CHANGED
|
@@ -4,12 +4,16 @@ exports.registerToProcessTools = registerToProcessTools;
|
|
|
4
4
|
const zod_1 = require("zod");
|
|
5
5
|
const utils_js_1 = require("./utils.js");
|
|
6
6
|
function registerToProcessTools(server, client) {
|
|
7
|
-
server.tool("billit_submit_for_processing", "Submit a file (e.g. incoming invoice PDF) to Billit for automated processing. Billit will parse the document and create a corresponding order. Returns an uploadID that can be used to cancel. Use for processing incoming supplier invoices without manual data entry
|
|
7
|
+
server.tool("billit_submit_for_processing", (0, utils_js_1.withLlmTip)("Submit a file (e.g. incoming invoice PDF) to Billit for automated processing. Billit will parse the document and create a corresponding order. Returns an uploadID that can be used to cancel. Use for processing incoming supplier invoices without manual data entry.", "file_base64 must be base64-encoded file content. Processing is async — Billit parses the document and creates an order in the background. Use billit_list_orders with direction='Cost' after processing to find the created order."), {
|
|
8
8
|
file_base64: zod_1.z.string().describe("Base64-encoded file content of the document to process"),
|
|
9
9
|
file_name: zod_1.z.string().describe("File name including extension (e.g. 'supplier-invoice-001.pdf')"),
|
|
10
10
|
content_type: zod_1.z.string().optional().describe("MIME type (default: 'application/pdf'). Billit processes PDF and common image formats."),
|
|
11
|
+
dry_run: utils_js_1.coerceBool.describe("When true, preview the action without executing it (default: false)"),
|
|
11
12
|
company_id: utils_js_1.companyId,
|
|
12
|
-
}, async ({ file_base64, file_name, content_type, company_id }) => {
|
|
13
|
+
}, async ({ file_base64, file_name, content_type, dry_run, company_id }) => {
|
|
14
|
+
if (dry_run) {
|
|
15
|
+
return (0, utils_js_1.respond)(JSON.stringify({ dry_run: true, would: `Submit file '${file_name}' (${content_type ?? "application/pdf"}) for processing` }, null, 2));
|
|
16
|
+
}
|
|
13
17
|
const body = {
|
|
14
18
|
FileBase64: file_base64, FileName: file_name, ContentType: content_type ?? "application/pdf",
|
|
15
19
|
};
|
|
@@ -18,8 +22,12 @@ function registerToProcessTools(server, client) {
|
|
|
18
22
|
});
|
|
19
23
|
server.tool("billit_cancel_processing", "Cancel a pending processing upload. Use if a wrong file was submitted. Only works while the upload is still pending — cannot cancel already-processed documents.", {
|
|
20
24
|
upload_id: zod_1.z.string().describe("Upload ID returned by billit_submit_for_processing"),
|
|
25
|
+
dry_run: utils_js_1.coerceBool.describe("When true, preview the action without executing it (default: false)"),
|
|
21
26
|
company_id: utils_js_1.companyId,
|
|
22
|
-
}, async ({ upload_id, company_id }) => {
|
|
27
|
+
}, async ({ upload_id, dry_run, company_id }) => {
|
|
28
|
+
if (dry_run) {
|
|
29
|
+
return (0, utils_js_1.respond)(JSON.stringify({ dry_run: true, would: `Cancel processing for upload ${upload_id}` }, null, 2));
|
|
30
|
+
}
|
|
23
31
|
const data = await client.request("DELETE", `/v1/toProcess/${upload_id}`, undefined, company_id);
|
|
24
32
|
return (0, utils_js_1.respond)(JSON.stringify(data ?? { success: true }, null, 2));
|
|
25
33
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"toprocess.js","sourceRoot":"","sources":["../../src/tools/toprocess.ts"],"names":[],"mappings":";;AAKA,
|
|
1
|
+
{"version":3,"file":"toprocess.js","sourceRoot":"","sources":["../../src/tools/toprocess.ts"],"names":[],"mappings":";;AAKA,wDA0CC;AA9CD,6BAAwB;AAExB,yCAAwE;AAExE,SAAgB,sBAAsB,CAAC,MAAiB,EAAE,MAAoB;IAC5E,MAAM,CAAC,IAAI,CACT,8BAA8B,EAC9B,IAAA,qBAAU,EACR,yQAAyQ,EACzQ,oOAAoO,CACrO,EACD;QACE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAC1F,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;QACjG,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;QACtI,OAAO,EAAE,qBAAU,CAAC,QAAQ,CAAC,qEAAqE,CAAC;QACnG,UAAU,EAAE,oBAAS;KACtB,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;QACtE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,SAAS,MAAM,YAAY,IAAI,iBAAiB,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxJ,CAAC;QACD,MAAM,IAAI,GAA4B;YACpC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,IAAI,iBAAiB;SAC7F,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC7E,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,kKAAkK,EAClK;QACE,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACpF,OAAO,EAAE,qBAAU,CAAC,QAAQ,CAAC,qEAAqE,CAAC;QACnG,UAAU,EAAE,oBAAS;KACtB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,gCAAgC,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACjG,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC,CACF,CAAC;AACJ,CAAC"}
|
package/dist/tools/utils.d.ts
CHANGED
|
@@ -5,5 +5,31 @@ export declare function respond(text: string): {
|
|
|
5
5
|
text: string;
|
|
6
6
|
}[];
|
|
7
7
|
};
|
|
8
|
+
/** Append an LLM tip to a tool description, separated by a horizontal rule.
|
|
9
|
+
* Keeps description focused on What/When/Output/Next while surfacing gotchas,
|
|
10
|
+
* spec-gaps, and ERROR→CAUSE→FIX in a clearly separated section. */
|
|
11
|
+
export declare function withLlmTip(description: string, tip: string): string;
|
|
12
|
+
export declare const coerceBool: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodString, z.ZodTransform<boolean, string>>]>>;
|
|
8
13
|
export declare const companyId: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
|
|
14
|
+
/** Paginate through all Income/Invoice orders since a date. Returns collected orders. */
|
|
15
|
+
export declare function paginateOrders(client: {
|
|
16
|
+
request<T>(method: string, path: string, body?: unknown, partyIdOverride?: number): Promise<T>;
|
|
17
|
+
}, fromDate: string, companyId?: number, maxPages?: number): Promise<{
|
|
18
|
+
OrderID: number;
|
|
19
|
+
OrderNumber: string;
|
|
20
|
+
OrderDate: string;
|
|
21
|
+
TotalIncl: number;
|
|
22
|
+
CounterParty: {
|
|
23
|
+
DisplayName: string;
|
|
24
|
+
VATNumber?: string;
|
|
25
|
+
};
|
|
26
|
+
}[]>;
|
|
27
|
+
/** Build OData query string from common list-tool params. Returns empty string if no params set. */
|
|
28
|
+
export declare function buildODataParams(opts: {
|
|
29
|
+
filter?: string;
|
|
30
|
+
search?: string;
|
|
31
|
+
orderby?: string;
|
|
32
|
+
top?: number;
|
|
33
|
+
skip?: number;
|
|
34
|
+
}): string;
|
|
9
35
|
//# sourceMappingURL=utils.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM;;;;;EAEnC;AAED,eAAO,MAAM,SAAS,4CACwJ,CAAC"}
|
|
1
|
+
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM;;;;;EAEnC;AAED;;qEAEqE;AACrE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,eAAO,MAAM,UAAU,6GAA6E,CAAC;AAErG,eAAO,MAAM,SAAS,4CACwJ,CAAC;AAE/K,yFAAyF;AACzF,wBAAsB,cAAc,CAClC,MAAM,EAAE;IAAE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,EAC1G,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,SAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAAE,CAAC,CAyBtJ;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAQT"}
|
package/dist/tools/utils.js
CHANGED
|
@@ -1,11 +1,63 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.companyId = void 0;
|
|
3
|
+
exports.companyId = exports.coerceBool = void 0;
|
|
4
4
|
exports.respond = respond;
|
|
5
|
+
exports.withLlmTip = withLlmTip;
|
|
6
|
+
exports.paginateOrders = paginateOrders;
|
|
7
|
+
exports.buildODataParams = buildODataParams;
|
|
5
8
|
const zod_1 = require("zod");
|
|
6
9
|
function respond(text) {
|
|
7
10
|
return { content: [{ type: "text", text }] };
|
|
8
11
|
}
|
|
12
|
+
/** Append an LLM tip to a tool description, separated by a horizontal rule.
|
|
13
|
+
* Keeps description focused on What/When/Output/Next while surfacing gotchas,
|
|
14
|
+
* spec-gaps, and ERROR→CAUSE→FIX in a clearly separated section. */
|
|
15
|
+
function withLlmTip(description, tip) {
|
|
16
|
+
return `${description}\n\n---\n\n${tip}`;
|
|
17
|
+
}
|
|
18
|
+
exports.coerceBool = zod_1.z.union([zod_1.z.boolean(), zod_1.z.string().transform(v => v === "true")]).optional();
|
|
9
19
|
exports.companyId = zod_1.z.coerce.number().optional()
|
|
10
20
|
.describe("Billit PartyID of the company to act as. If not set, uses BILLIT_PARTY_ID env. If env is 0, call billit_get_account_info first to discover available companies.");
|
|
21
|
+
/** Paginate through all Income/Invoice orders since a date. Returns collected orders. */
|
|
22
|
+
async function paginateOrders(client, fromDate, companyId, maxPages = 100) {
|
|
23
|
+
if (!/^\d{4}-\d{2}-\d{2}$/.test(fromDate)) {
|
|
24
|
+
throw new Error(`Invalid fromDate format: '${fromDate}'. Expected YYYY-MM-DD.`);
|
|
25
|
+
}
|
|
26
|
+
const pageSize = 120;
|
|
27
|
+
const allOrders = [];
|
|
28
|
+
let skip = 0;
|
|
29
|
+
for (let page = 0; page < maxPages; page++) {
|
|
30
|
+
const filter = `OrderDirection eq 'Income' and OrderType eq 'Invoice' and OrderDate ge datetime'${fromDate}T00:00:00'`;
|
|
31
|
+
const params = new URLSearchParams({
|
|
32
|
+
"$filter": filter,
|
|
33
|
+
"$top": String(pageSize),
|
|
34
|
+
"$skip": String(skip),
|
|
35
|
+
"$orderby": "OrderDate desc",
|
|
36
|
+
});
|
|
37
|
+
const res = await client.request("GET", `/v1/orders?${params.toString()}`, undefined, companyId);
|
|
38
|
+
const items = res?.Items ?? [];
|
|
39
|
+
allOrders.push(...items);
|
|
40
|
+
if (items.length < pageSize)
|
|
41
|
+
break;
|
|
42
|
+
skip += pageSize;
|
|
43
|
+
if (page === maxPages - 1)
|
|
44
|
+
throw new Error(`Pagination limit reached (${maxPages} pages / ${maxPages * pageSize} items). Use a more recent since_date to narrow scope.`);
|
|
45
|
+
}
|
|
46
|
+
return allOrders;
|
|
47
|
+
}
|
|
48
|
+
/** Build OData query string from common list-tool params. Returns empty string if no params set. */
|
|
49
|
+
function buildODataParams(opts) {
|
|
50
|
+
const params = new URLSearchParams();
|
|
51
|
+
if (opts.filter?.trim())
|
|
52
|
+
params.set("$filter", opts.filter);
|
|
53
|
+
if (opts.search)
|
|
54
|
+
params.set("fullTextSearch", opts.search);
|
|
55
|
+
if (opts.orderby)
|
|
56
|
+
params.set("$orderby", opts.orderby);
|
|
57
|
+
if (opts.top !== undefined)
|
|
58
|
+
params.set("$top", String(opts.top));
|
|
59
|
+
if (opts.skip !== undefined)
|
|
60
|
+
params.set("$skip", String(opts.skip));
|
|
61
|
+
return params.toString();
|
|
62
|
+
}
|
|
11
63
|
//# sourceMappingURL=utils.js.map
|
package/dist/tools/utils.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":";;;AAEA,0BAEC;
|
|
1
|
+
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":";;;AAEA,0BAEC;AAKD,gCAEC;AAQD,wCA8BC;AAGD,4CAcC;AAlED,6BAAwB;AAExB,SAAgB,OAAO,CAAC,IAAY;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;qEAEqE;AACrE,SAAgB,UAAU,CAAC,WAAmB,EAAE,GAAW;IACzD,OAAO,GAAG,WAAW,cAAc,GAAG,EAAE,CAAC;AAC3C,CAAC;AAEY,QAAA,UAAU,GAAG,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,OAAO,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAExF,QAAA,SAAS,GAAG,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClD,QAAQ,CAAC,iKAAiK,CAAC,CAAC;AAE/K,yFAAyF;AAClF,KAAK,UAAU,cAAc,CAClC,MAA0G,EAC1G,QAAgB,EAChB,SAAkB,EAClB,QAAQ,GAAG,GAAG;IAEd,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,yBAAyB,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC;IACrB,MAAM,SAAS,GAAgJ,EAAE,CAAC;IAClK,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,mFAAmF,QAAQ,YAAY,CAAC;QACvH,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;YACxB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;YACrB,UAAU,EAAE,gBAAgB;SAC7B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAA8B,KAAK,EAAE,cAAc,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9H,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;YAAE,MAAM;QACnC,IAAI,IAAI,QAAQ,CAAC;QACjB,IAAI,IAAI,KAAK,QAAQ,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,YAAY,QAAQ,GAAG,QAAQ,wDAAwD,CAAC,CAAC;IAC3K,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oGAAoG;AACpG,SAAgB,gBAAgB,CAAC,IAMhC;IACC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,OAAO;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/tools/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/tools/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqDhD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QAoN5E"}
|