@codemill-solutions/yuki-mcp 1.0.0

package/dist/tools/relations.js

@@ -0,0 +1,271 @@
+import { z } from "zod";
+import { XmlValue, escapeXml } from "../yuki-client.js";
+/**
+ * Register tools for working with Yuki relations (contacts).
+ *
+ * Relations are debitors (customers) and creditors (suppliers) in Yuki.
+ * The Contact service uses domainID (the same GUID as your administrationID).
+ *
+ * Yuki service: Contact.asmx
+ * Method:       SearchContacts(sessionID, domainID, searchOption, searchValue,
+ *                              sortOrder, modifiedAfter, active, pageNumber)
+ * Max results:  100 per page — use pageNumber for pagination.
+ */
+export function registerRelationTools(server, client) {
+    /**
+     * search_relations
+     *
+     * Search for contacts / relations (debitors and creditors) in Yuki.
+     * Returns up to 100 matches per page with ID, name, code, type, and address.
+     *
+     * Use this to look up a relation ID before linking invoices, or to find
+     * contact details for a customer or supplier.
+     *
+     * Rate cost: 1 request per page.
+     */
+    server.registerTool("search_relations", {
+        description: "Search for Yuki relations (customers/suppliers) by name, code, VAT number, or other fields. " +
+            "Returns up to 100 contacts per page with IDs, codes, names, and contact details. " +
+            "Omit searchValue (or pass an empty string) to retrieve all contacts.",
+        inputSchema: {
+            searchValue: z
+                .string()
+                .optional()
+                .default("")
+                .describe("The value to search for (e.g. company name, relation code). " +
+                "Omit or pass an empty string to retrieve all contacts (subject to Yuki API support)."),
+            searchOption: z
+                .enum([
+                "All",
+                "Name",
+                "City",
+                "Postcode",
+                "Tag",
+                "Email",
+                "Website",
+                "Phone",
+                "Code",
+                "CoCNumber",
+                "VATNumber",
+                "BankAccount",
+                "ID",
+                "ContactType",
+                "HID",
+            ])
+                .optional()
+                .default("All")
+                .describe("Which field to search in. Defaults to 'All' (full-text search)."),
+            active: z
+                .enum(["Both", "Active", "Inactive"])
+                .optional()
+                .default("Active")
+                .describe("Filter by active status. Defaults to 'Active'."),
+            pageNumber: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .default(1)
+                .describe("Page number for pagination (100 results per page)."),
+            domainId: z
+                .string()
+                .optional()
+                .describe("Domain ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ searchValue, searchOption, active, pageNumber, domainId }) => {
+        try {
+            const domain = domainId ?? client.defaultDomainId;
+            if (!domain) {
+                throw new Error("domainId is required (or set YUKI_DOMAIN_ID env var)");
+            }
+            const sessionID = await client.getSessionID();
+            // Note: Contact.asmx uses 'domainID', not 'administrationID'
+            const result = await client.callSoap({
+                service: "Contact.asmx",
+                method: "SearchContacts",
+                params: {
+                    sessionID,
+                    domainID: domain,
+                    searchOption: searchOption ?? "All",
+                    searchValue,
+                    sortOrder: "Name",
+                    // modifiedAfter is optional — omit to get all
+                    active: active ?? "Active",
+                    pageNumber: pageNumber ?? 1,
+                },
+            });
+            const relations = normalizeContacts(result);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            count: relations.length,
+                            page: pageNumber ?? 1,
+                            relations,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Register the upsert_contact write tool.
+ * Call this from registerRelationTools — same server/client instance.
+ */
+export function registerContactWriteTools(server, client) {
+    /**
+     * upsert_contact
+     *
+     * Create a new contact or update an existing one in Yuki.
+     * When a contactCode is provided and matches an existing record, Yuki
+     * will update that contact. Otherwise a new contact is created.
+     *
+     * Use this before process_sales_invoice or process_purchase_invoice when:
+     *   - A new customer or supplier needs to be registered
+     *   - Contact details (IBAN, address, VAT number) need to be updated
+     *   - You want to ensure a contact exists before linking invoices to it
+     *
+     * Note: Contact.asmx uses sessionID / domainID (uppercase D).
+     * Rate cost: 1 request.
+     */
+    server.registerTool("upsert_contact", {
+        description: "Create or update a contact (customer or supplier) in Yuki. " +
+            "When contactCode matches an existing record it will be updated; otherwise a new contact is created. " +
+            "Returns the Yuki response with the contact ID.",
+        inputSchema: {
+            contactCode: z.string().optional()
+                .describe("Unique contact code. Used to identify and update existing contacts."),
+            fullName: z.string().describe("Full company or person name"),
+            firstName: z.string().optional(),
+            middleName: z.string().optional(),
+            lastName: z.string().optional(),
+            contactType: z.enum(["Debtor", "Creditor", "Both", "Person"]).optional().default("Both")
+                .describe("Role: Debtor = customer, Creditor = supplier, Both = customer & supplier"),
+            emailAddress: z.string().optional(),
+            phone: z.string().optional().describe("Main phone number"),
+            mobile: z.string().optional(),
+            countryCode: z.string().optional().default("NL").describe("ISO 3166-1 alpha-2 country code"),
+            city: z.string().optional(),
+            zipcode: z.string().optional(),
+            addressLine1: z.string().optional(),
+            addressLine2: z.string().optional(),
+            vatNumber: z.string().optional().describe("VAT / BTW number (e.g. 'NL123456789B01')"),
+            cocNumber: z.string().optional().describe("KvK / Chamber of Commerce number"),
+            bankAccount: z.string().optional().describe("IBAN bank account number"),
+            bic: z.string().optional().describe("BIC / SWIFT code"),
+            website: z.string().optional(),
+            domainId: z.string().optional()
+                .describe("Domain ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ contactCode, fullName, firstName, middleName, lastName, contactType, emailAddress, phone, mobile, countryCode, city, zipcode, addressLine1, addressLine2, vatNumber, cocNumber, bankAccount, bic, website, domainId }) => {
+        try {
+            const domain = domainId ?? client.defaultDomainId;
+            if (!domain)
+                throw new Error("domainId is required (or set YUKI_DOMAIN_ID env var)");
+            const sessionID = await client.getSessionID();
+            const xmlDoc = buildContactXml({ contactCode, fullName, firstName, middleName,
+                lastName, contactType, emailAddress, phone, mobile, countryCode, city,
+                zipcode, addressLine1, addressLine2, vatNumber, cocNumber,
+                bankAccount, bic, website });
+            // Contact.asmx uses sessionID / domainID (uppercase D)
+            const result = await client.callSoap({
+                service: "Contact.asmx",
+                method: "UpdateContact",
+                params: {
+                    sessionID,
+                    domainID: domain,
+                    xmlDoc: new XmlValue(xmlDoc),
+                },
+            });
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: true, fullName, contactCode, result }, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+}
+// ── XML document builder ──────────────────────────────────────────────────────
+/** Build the xmlDoc string for UpdateContact. */
+function buildContactXml(args) {
+    const x = escapeXml;
+    return `<?xml version="1.0" encoding="utf-8"?>
+<Contacts xmlns="urn:xmlns:http://www.theyukicompany.com:contacts"
+          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <Contact>
+    ${args.contactCode ? `<ContactCode>${x(args.contactCode)}</ContactCode>` : ""}
+    <FullName>${x(args.fullName)}</FullName>
+    ${args.firstName ? `<FirstName>${x(args.firstName)}</FirstName>` : ""}
+    ${args.middleName ? `<MiddleName>${x(args.middleName)}</MiddleName>` : ""}
+    ${args.lastName ? `<LastName>${x(args.lastName)}</LastName>` : ""}
+    ${args.contactType ? `<ContactType>${x(args.contactType)}</ContactType>` : ""}
+    ${args.emailAddress ? `<EmailAddress>${x(args.emailAddress)}</EmailAddress>` : ""}
+    ${args.phone ? `<PhoneHome>${x(args.phone)}</PhoneHome>` : ""}
+    ${args.mobile ? `<MobileHome>${x(args.mobile)}</MobileHome>` : ""}
+    ${args.website ? `<Website>${x(args.website)}</Website>` : ""}
+    ${args.countryCode ? `<CountryCode>${x(args.countryCode)}</CountryCode>` : ""}
+    ${args.city ? `<City>${x(args.city)}</City>` : ""}
+    ${args.zipcode ? `<Zipcode>${x(args.zipcode)}</Zipcode>` : ""}
+    ${args.addressLine1 ? `<AddressLine_1>${x(args.addressLine1)}</AddressLine_1>` : ""}
+    ${args.addressLine2 ? `<AddressLine_2>${x(args.addressLine2)}</AddressLine_2>` : ""}
+    ${args.vatNumber ? `<VATNumber>${x(args.vatNumber)}</VATNumber>` : ""}
+    ${args.cocNumber ? `<CoCNumber>${x(args.cocNumber)}</CoCNumber>` : ""}
+    ${args.bankAccount ? `<BankAccount>${x(args.bankAccount)}</BankAccount>` : ""}
+    ${args.bic ? `<BIC>${x(args.bic)}</BIC>` : ""}
+  </Contact>
+</Contacts>`;
+}
+/** Unwrap the parsed SOAP result for contacts into a flat array. */
+function normalizeContacts(result) {
+    if (!result)
+        return [];
+    if (Array.isArray(result))
+        return result;
+    const rec = result;
+    const wrappers = ["Contacts", "contacts", "Relations", "relations"];
+    const itemTags = ["Contact", "contact", "Relation", "relation"];
+    for (const wrapper of wrappers) {
+        const c = rec[wrapper];
+        if (!c)
+            continue;
+        if (Array.isArray(c))
+            return c;
+        const inner = c;
+        for (const tag of itemTags) {
+            if (Array.isArray(inner[tag]))
+                return inner[tag];
+            if (inner[tag])
+                return [inner[tag]];
+        }
+    }
+    for (const tag of itemTags) {
+        if (Array.isArray(rec[tag]))
+            return rec[tag];
+        if (rec[tag])
+            return [rec[tag]];
+    }
+    return [result];
+}
+//# sourceMappingURL=relations.js.map

package/dist/tools/relations.js.map

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

package/dist/tools/transactions.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { YukiClient } from "../yuki-client.js";
+/**
+ * Register tools for retrieving GL account transactions from Yuki.
+ *
+ * Yuki exposes transactions per GL account code (e.g. "1200" for a bank account).
+ * Use get_gl_accounts first to find the right GL account code for a bank account.
+ *
+ * Yuki service: Accounting.asmx
+ * Method:       GLAccountTransactions(sessionID, administrationID, GLAccountCode,
+ *                                     StartDate, EndDate)
+ */
+export declare function registerTransactionTools(server: McpServer, client: YukiClient): void;
+/**
+ * Register the process_journal write tool.
+ * Call this from registerTransactionTools — same server/client instance.
+ */
+export declare function registerJournalWriteTools(server: McpServer, client: YukiClient): void;
+//# sourceMappingURL=transactions.d.ts.map

package/dist/tools/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../src/tools/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAuB,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CA0KN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CAwFN"}

package/dist/tools/transactions.js

@@ -0,0 +1,294 @@
+import { z } from "zod";
+import { XmlValue, escapeXml } from "../yuki-client.js";
+/**
+ * Register tools for retrieving GL account transactions from Yuki.
+ *
+ * Yuki exposes transactions per GL account code (e.g. "1200" for a bank account).
+ * Use get_gl_accounts first to find the right GL account code for a bank account.
+ *
+ * Yuki service: Accounting.asmx
+ * Method:       GLAccountTransactions(sessionID, administrationID, GLAccountCode,
+ *                                     StartDate, EndDate)
+ */
+export function registerTransactionTools(server, client) {
+    /**
+     * get_transactions
+     *
+     * Retrieve all journal entries / transactions for a specific GL account
+     * (e.g. a bank account) within a date range.
+     *
+     * Returns transaction date, description, debit/credit amounts, and
+     * the counterpart GL account. Use this to inspect bank movements or
+     * verify bookings for a specific account.
+     *
+     * To get bank transactions: first call get_gl_accounts to find the GL
+     * account code for your bank account (typically in the 1100–1299 range),
+     * then pass that code here.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("get_transactions", {
+        description: "Retrieve all journal entries for a specific GL account code within a date range. " +
+            "Use this for bank transactions (find the bank GL code with get_gl_accounts first). " +
+            "Returns date, description, debit/credit amounts, and counterpart GL account.",
+        inputSchema: {
+            glAccountCode: z
+                .string()
+                .describe("GL account code to retrieve transactions for (e.g. '1200' for a bank account). " +
+                "Use get_gl_accounts to find the right code."),
+            startDate: z
+                .string()
+                .describe("Start date in YYYY-MM-DD format (inclusive)"),
+            endDate: z
+                .string()
+                .describe("End date in YYYY-MM-DD format (inclusive)"),
+            administrationId: z
+                .string()
+                .optional()
+                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ glAccountCode, startDate, endDate, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId) {
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            }
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: "Accounting.asmx",
+                method: "GLAccountTransactions",
+                params: {
+                    sessionID,
+                    administrationID: adminId,
+                    GLAccountCode: glAccountCode,
+                    StartDate: startDate,
+                    EndDate: endDate,
+                },
+            });
+            const transactions = normalizeTransactions(result);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            count: transactions.length,
+                            glAccountCode,
+                            period: { startDate, endDate },
+                            transactions,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    /**
+     * get_transaction_details
+     *
+     * Check whether an outstanding item with a given reference still exists,
+     * and retrieve its current status and amount.
+     *
+     * Use this after get_sales_invoices or get_purchase_invoices to verify
+     * the current state of a specific invoice reference.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("get_transaction_details", {
+        description: "Check whether an outstanding item (invoice) with a given reference still exists in Yuki " +
+            "and retrieve its current open amount and status.",
+        inputSchema: {
+            reference: z
+                .string()
+                .describe("Invoice reference number as shown in Yuki (e.g. '2024-0042')"),
+            administrationId: z
+                .string()
+                .optional()
+                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ reference, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            const sessionID = await client.getSessionID();
+            // CheckOutstandingItemAdmin checks a specific reference within an administration
+            const result = await client.callSoap({
+                service: "Accounting.asmx",
+                method: "CheckOutstandingItemAdmin",
+                params: {
+                    sessionID,
+                    adminID: adminId,
+                    Reference: reference,
+                },
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: true, reference, result }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Register the process_journal write tool.
+ * Call this from registerTransactionTools — same server/client instance.
+ */
+export function registerJournalWriteTools(server, client) {
+    /**
+     * process_journal
+     *
+     * Post a general journal entry (memoriaal) in Yuki.
+     * This is the primary method for recording bank reconciliation,
+     * corrections, and any double-entry booking not covered by
+     * ProcessSalesInvoices or ProcessPurchaseInvoices.
+     *
+     * CRITICAL RULE — Yuki will reject the entry if the amounts don't balance:
+     *   - The sum of all entry amounts must equal exactly 0.00
+     *   - Positive amounts = debit, negative amounts = credit
+     *   - Example bank receipt: bank account +100.00, debtor account -100.00
+     *
+     * Use this for:
+     *   - Bank reconciliation: match a bank mutation to an outstanding invoice
+     *   - Opening balances
+     *   - Corrections and reclassifications
+     *   - Any custom double-entry booking
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("process_journal", {
+        description: "Post a general journal entry (memoriaal) in Yuki for bank reconciliation, corrections, or custom bookings. " +
+            "IMPORTANT: all entry amounts must sum to exactly 0 (positive = debit, negative = credit). " +
+            "Yuki will reject the entry if this rule is violated.",
+        inputSchema: {
+            subject: z.string().describe("Document subject / description shown in Yuki (e.g. 'Bank reconciliation April 2024')"),
+            journalType: z.enum(["GeneralJournal", "EndOfYearCorrection", "FiscalCorrection"])
+                .optional().default("GeneralJournal")
+                .describe("Journal type. Year-end and fiscal corrections must have entry dates on the last day of the financial year."),
+            entries: z.array(z.object({
+                entryDate: z.string().describe("Entry date in YYYY-MM-DD format"),
+                glAccount: z.string().describe("GL account code (e.g. '1200' for bank, '1300' for debtors)"),
+                amount: z.number().describe("Amount: positive = debit, negative = credit. All entries must sum to 0."),
+                description: z.string().optional().describe("Line description (max 256 characters)"),
+                contactCode: z.string().optional().describe("Yuki contact code to link this entry to a relation"),
+                contactName: z.string().optional().describe("Contact name (used if contactCode is not provided)"),
+            })).min(2).describe("Journal entries — must contain at least 2 lines and sum to zero"),
+            administrationId: z.string().optional().describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ subject, journalType, entries, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            // Validate balance before sending — save a request on obvious errors
+            const total = entries.reduce((sum, e) => sum + e.amount, 0);
+            if (Math.abs(total) > 0.001) {
+                throw new Error(`Journal entries do not balance: sum is ${total.toFixed(2)} (must be 0.00). ` +
+                    `Check your debit/credit amounts.`);
+            }
+            const sessionID = await client.getSessionID();
+            const xmlDoc = buildJournalXml({ administrationId: adminId, subject,
+                journalType, entries });
+            // Accounting.asmx uses sessionID / administrationID (uppercase D)
+            const result = await client.callSoap({
+                service: "Accounting.asmx",
+                method: "ProcessJournal",
+                params: {
+                    sessionID,
+                    administrationID: adminId,
+                    xmlDoc: new XmlValue(xmlDoc),
+                },
+            });
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: true, subject, entryCount: entries.length, result }, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text",
+                        text: JSON.stringify({ success: false, error: message }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+}
+// ── XML document builder ──────────────────────────────────────────────────────
+/** Build the xmlDoc string for ProcessJournal. */
+function buildJournalXml(args) {
+    const x = escapeXml;
+    const entriesXml = args.entries.map(e => `
+    <JournalEntry>
+      <EntryDate>${x(e.entryDate)}</EntryDate>
+      <GLAccount>${x(e.glAccount)}</GLAccount>
+      <Amount>${e.amount}</Amount>
+      ${e.description ? `<Description>${x(e.description.slice(0, 256))}</Description>` : ""}
+      ${e.contactCode ? `<ContactCode>${x(e.contactCode)}</ContactCode>` : ""}
+      ${!e.contactCode && e.contactName ? `<ContactName>${x(e.contactName)}</ContactName>` : ""}
+    </JournalEntry>`).join("");
+    return `<?xml version="1.0" encoding="utf-8"?>
+<Journal xmlns="urn:xmlns:http://www.theyukicompany.com:journal"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <AdministrationID>${x(args.administrationId)}</AdministrationID>
+  <DocumentSubject>${x(args.subject)}</DocumentSubject>
+  <JournalType>${x(args.journalType ?? "GeneralJournal")}</JournalType>
+  ${entriesXml}
+</Journal>`;
+}
+/** Unwrap the parsed SOAP GL transaction result into a flat array. */
+function normalizeTransactions(result) {
+    if (!result)
+        return [];
+    if (Array.isArray(result))
+        return result;
+    const rec = result;
+    const wrappers = ["Transactions", "GLTransactions", "Rows"];
+    const itemTags = ["Transaction", "GLTransaction", "Row"];
+    for (const wrapper of wrappers) {
+        const c = rec[wrapper];
+        if (!c)
+            continue;
+        if (Array.isArray(c))
+            return c;
+        const inner = c;
+        for (const tag of itemTags) {
+            if (Array.isArray(inner[tag]))
+                return inner[tag];
+            if (inner[tag])
+                return [inner[tag]];
+        }
+    }
+    for (const tag of itemTags) {
+        if (Array.isArray(rec[tag]))
+            return rec[tag];
+        if (rec[tag])
+            return [rec[tag]];
+    }
+    return [result];
+}
+//# sourceMappingURL=transactions.js.map

package/dist/tools/transactions.js.map

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