@useyona/einvoice-mcp 0.0.0-stage → 0.1.1

package/dist/resources.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODE_LIST_OF = exports.RESOURCE_URIS = void 0;
+exports.registerResources = registerResources;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const einvoice_js_1 = require("@useyona/einvoice-js");
+const result_1 = require("./result");
+const tools_1 = require("./tools");
+/** The resource URIs this server serves. */
+exports.RESOURCE_URIS = {
+    taxCategories: 'yona://reference/tax-categories',
+    units: 'yona://reference/units',
+    hsCodes: 'yona://reference/hs-codes',
+    organization: 'yona://organization',
+};
+/** The jurisdiction's code-list type behind each reference resource (`reference.getResource`). */
+exports.CODE_LIST_OF = {
+    [exports.RESOURCE_URIS.taxCategories]: 'tax-categories',
+    [exports.RESOURCE_URIS.units]: 'invoice-quantity-codes',
+};
+function json(uri, mode, data) {
+    return { contents: [{ uri, mimeType: 'application/json', text: (0, result_1.redact)(JSON.stringify({ mode, data: (0, result_1.compact)(data) }, null, 2)) }] };
+}
+/** An SDK failure as an MCP error: the code, the message and the request id, never a key or token. */
+function asMcpError(error) {
+    if (error instanceof einvoice_js_1.EInvoiceApiError) {
+        const parts = [error.errorCode, error.message, error.requestId ? `requestId ${error.requestId}` : undefined];
+        return new types_js_1.McpError(types_js_1.ErrorCode.InternalError, (0, result_1.redact)(parts.filter(Boolean).join(' — ')));
+    }
+    return new types_js_1.McpError(types_js_1.ErrorCode.InternalError, (0, result_1.redact)(error?.message ?? String(error)));
+}
+async function guarded(read) {
+    try {
+        return await read();
+    }
+    catch (error) {
+        throw asMcpError(error);
+    }
+}
+function registerResources(server, client) {
+    for (const [uri, type] of Object.entries(exports.CODE_LIST_OF)) {
+        const units = type === 'invoice-quantity-codes';
+        server.registerResource(units ? 'units' : 'tax-categories', uri, {
+            title: units ? 'Units of measure' : 'Tax categories',
+            description: units
+                ? 'The unit codes an invoice line or item may use (unitCode), e.g. EA.'
+                : 'The tax category ids a line or item may use (taxCategory), e.g. STANDARD_VAT, with their rates.',
+            mimeType: 'application/json',
+        }, (resourceUri, extra) => guarded(async () => json(resourceUri.href, client.mode, await client.reference.getResource(type, { signal: extra.signal }))));
+    }
+    const readHsCodes = (href, q, signal) => guarded(async () => {
+        const result = await client.reference.listHsCodes({ search: q || undefined, limit: 50 }, { signal });
+        return json(href, client.mode, { items: result.data, pagination: result.pagination });
+    });
+    const hsDescription = 'Harmonised System codes for goods (hsnCode). Add ?q=<words> to search, e.g. yona://reference/hs-codes?q=laptop. First 50 matches.';
+    server.registerResource('hs-codes', exports.RESOURCE_URIS.hsCodes, { title: 'HS codes', description: hsDescription, mimeType: 'application/json' }, (resourceUri, extra) => readHsCodes(resourceUri.href, undefined, extra.signal));
+    server.registerResource('hs-codes-search', new mcp_js_1.ResourceTemplate(`${exports.RESOURCE_URIS.hsCodes}{?q}`, { list: undefined }), { title: 'HS code search', description: hsDescription, mimeType: 'application/json' }, (resourceUri, variables, extra) => readHsCodes(resourceUri.href, Array.isArray(variables.q) ? variables.q[0] : variables.q, extra.signal));
+    server.registerResource('organization', exports.RESOURCE_URIS.organization, {
+        title: 'Organisation',
+        description: 'The organisation the API key belongs to: profile and readiness to report invoices.',
+        mimeType: 'application/json',
+    }, (resourceUri, extra) => guarded(async () => json(resourceUri.href, client.mode, await (0, tools_1.readOrganization)(client, { signal: extra.signal }))));
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":";;;AA4CA,8CAkDC;AA9FD,oEAAyE;AAEzE,iEAAuE;AAEvE,sDAAsD;AAEtD,qCAAyC;AACzC,mCAAyC;AAEzC,4CAA4C;AAC/B,QAAA,aAAa,GAAG;IACzB,aAAa,EAAE,iCAAiC;IAChD,KAAK,EAAE,wBAAwB;IAC/B,OAAO,EAAE,2BAA2B;IACpC,YAAY,EAAE,qBAAqB;CAC7B,CAAC;AAEX,kGAAkG;AACrF,QAAA,YAAY,GAAG;IACxB,CAAC,qBAAa,CAAC,aAAa,CAAC,EAAE,gBAAgB;IAC/C,CAAC,qBAAa,CAAC,KAAK,CAAC,EAAE,wBAAwB;CACzC,CAAC;AAEX,SAAS,IAAI,CAAC,GAAW,EAAE,IAAY,EAAE,IAAa;IAClD,OAAO,EAAC,QAAQ,EAAE,CAAC,EAAC,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAA,eAAM,EAAC,IAAI,CAAC,SAAS,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,IAAA,gBAAO,EAAC,IAAI,CAAC,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC;AACjI,CAAC;AAED,sGAAsG;AACtG,SAAS,UAAU,CAAC,KAAc;IAC9B,IAAI,KAAK,YAAY,8BAAgB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7G,OAAO,IAAI,mBAAQ,CAAC,oBAAS,CAAC,aAAa,EAAE,IAAA,eAAM,EAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,IAAI,mBAAQ,CAAC,oBAAS,CAAC,aAAa,EAAE,IAAA,eAAM,EAAE,KAAe,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAuC;IAC1D,IAAI,CAAC;QACD,OAAO,MAAM,IAAI,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAiB,EAAE,MAAgB;IACjE,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAY,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,KAAK,wBAAwB,CAAC;QAChD,MAAM,CAAC,gBAAgB,CACnB,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAClC,GAAG,EACH;YACI,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB;YACpD,WAAW,EAAE,KAAK;gBACd,CAAC,CAAC,qEAAqE;gBACvE,CAAC,CAAC,iGAAiG;YACvG,QAAQ,EAAE,kBAAkB;SAC/B,EACD,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CACnB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,EAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,CACjI,CAAC;IACN,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,CAAqB,EAAE,MAAmB,EAAE,EAAE,CAC7E,OAAO,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,KAAK,EAAE,EAAE,EAAC,EAAE,EAAC,MAAM,EAAC,CAAC,CAAC;QACjG,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAC,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IACP,MAAM,aAAa,GACf,mIAAmI,CAAC;IACxI,MAAM,CAAC,gBAAgB,CACnB,UAAU,EACV,qBAAa,CAAC,OAAO,EACrB,EAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAC,EAC7E,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CACjF,CAAC;IACF,MAAM,CAAC,gBAAgB,CACnB,iBAAiB,EACjB,IAAI,yBAAgB,CAAC,GAAG,qBAAa,CAAC,OAAO,MAAM,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,EACvE,EAAC,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAC,EACnF,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAC9B,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAC7G,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACnB,cAAc,EACd,qBAAa,CAAC,YAAY,EAC1B;QACI,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,oFAAoF;QACjG,QAAQ,EAAE,kBAAkB;KAC/B,EACD,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CACnB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,IAAA,wBAAgB,EAAC,MAAM,EAAE,EAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,CACvH,CAAC;AACN,CAAC"}

package/dist/result.d.ts

@@ -0,0 +1,42 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ApiMode } from '@useyona/einvoice-js';
+/** Replaces anything that looks like a key or token with `[redacted]`. */
+export declare function redact(text: string): string;
+/** Drops `null` and `undefined` fields recursively, so a model reads what is set. */
+export declare function compact<T>(value: T): T;
+/** The JSON a tool returns: the key's mode, the data, and the request id when the SDK exposes it. */
+export interface ToolPayload {
+    mode: ApiMode;
+    data?: unknown;
+    requestId?: string;
+    note?: string;
+}
+/** A successful tool result. */
+export declare function ok(mode: ApiMode, data: unknown, extra?: {
+    requestId?: string;
+    note?: string;
+}): CallToolResult;
+/** What a model sees of a refused call: the code, the message and the request id, never a key or token. */
+export interface ToolErrorPayload {
+    mode: ApiMode;
+    error: {
+        errorCode?: string;
+        status?: number;
+        message: string;
+        requestId?: string;
+        /** Field-level reasons (`field`, `message`), so a model can correct its input. */
+        errors?: Array<{
+            field: string;
+            message: string;
+        }>;
+        retryAfter?: number;
+    };
+}
+/** Maps any thrown value to a tool error result. */
+export declare function fail(mode: ApiMode, error: unknown): CallToolResult;
+/** A refusal decided by the MCP server itself (not the API), e.g. a destructive call without `confirm`. */
+export declare class ToolRefusal extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAalD,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAWtC;AAED,qGAAqG;AACrG,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gCAAgC;AAChC,wBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,GAAE;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,cAAc,CAIhH;AAED,2GAA2G;AAC3G,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kFAAkF;QAClF,MAAM,CAAC,EAAE,KAAK,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;QACjD,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAED,oDAAoD;AACpD,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAoBlE;AAED,2GAA2G;AAC3G,qBAAa,WAAY,SAAQ,KAAK;aACN,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5D"}

package/dist/result.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRefusal = void 0;
+exports.redact = redact;
+exports.compact = compact;
+exports.ok = ok;
+exports.fail = fail;
+const einvoice_js_1 = require("@useyona/einvoice-js");
+/**
+ * Anything that looks like a credential: an API key, a bearer token, a JWT. Every text the server
+ * returns passes through {@link redact}, so a value that slipped into an upstream message is never
+ * shown to the model.
+ */
+const SECRET_PATTERNS = [
+    /sk_(?:test|live)_[A-Za-z0-9_-]+/g,
+    /Bearer\s+[A-Za-z0-9._~+/=-]+/gi,
+    /eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]*/g,
+];
+/** Replaces anything that looks like a key or token with `[redacted]`. */
+function redact(text) {
+    let out = text;
+    for (const pattern of SECRET_PATTERNS)
+        out = out.replace(pattern, '[redacted]');
+    return out;
+}
+/** Drops `null` and `undefined` fields recursively, so a model reads what is set. */
+function compact(value) {
+    if (Array.isArray(value))
+        return value.map((v) => compact(v));
+    if (value && typeof value === 'object' && !(value instanceof Date)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (v === null || v === undefined)
+                continue;
+            out[k] = compact(v);
+        }
+        return out;
+    }
+    return value;
+}
+/** A successful tool result. */
+function ok(mode, data, extra = {}) {
+    const payload = { mode, ...(extra.note ? { note: extra.note } : {}), data: compact(data) };
+    if (extra.requestId)
+        payload.requestId = extra.requestId;
+    return { content: [{ type: 'text', text: redact(JSON.stringify(payload, null, 2)) }] };
+}
+/** Maps any thrown value to a tool error result. */
+function fail(mode, error) {
+    let body;
+    if (error instanceof einvoice_js_1.EInvoiceApiError) {
+        body = {
+            errorCode: error.errorCode,
+            status: error.status,
+            message: error.message,
+            requestId: error.requestId,
+            ...(error.errors.length ? { errors: error.errors.map((e) => ({ field: e.field, message: e.message })) } : {}),
+            ...(error.retryAfter !== undefined ? { retryAfter: error.retryAfter } : {}),
+        };
+    }
+    else if (error instanceof einvoice_js_1.EInvoiceError) {
+        body = { errorCode: error.name, message: error.message };
+    }
+    else if (error instanceof ToolRefusal) {
+        body = { errorCode: error.code, message: error.message };
+    }
+    else {
+        body = { message: `Unexpected error: ${error?.message ?? String(error)}` };
+    }
+    const payload = { mode, error: compact(body) };
+    return { isError: true, content: [{ type: 'text', text: redact(JSON.stringify(payload, null, 2)) }] };
+}
+/** A refusal decided by the MCP server itself (not the API), e.g. a destructive call without `confirm`. */
+class ToolRefusal extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ToolRefusal';
+    }
+}
+exports.ToolRefusal = ToolRefusal;
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { EInvoice } from '@useyona/einvoice-js';
+/** Options of {@link createYonaMcpServer}. */
+export interface YonaMcpServerOptions {
+    /**
+     * The Yona API client. Locally it is `new EInvoice({ apiKey })`; a host that holds its own
+     * credentials builds it with a custom transport. Its `mode` is reported in every result.
+     */
+    client: EInvoice;
+    /**
+     * Allow a live client. A live client is refused unless this is true: locally the binary sets it
+     * from `YONA_ALLOW_LIVE=true`, hosted from the `developers.mcp_live` flag.
+     */
+    allowLive?: boolean;
+}
+/** Thrown by {@link createYonaMcpServer} for a live client without `allowLive`. */
+export declare class LiveModeRefusedError extends Error {
+    constructor();
+}
+/**
+ * Builds the Yona MCP server: the tools, resources and prompts of the spec, over the given client.
+ * Connect it to any transport (stdio, streamable HTTP). Throws {@link LiveModeRefusedError} for a
+ * live client unless `allowLive` is true.
+ */
+export declare function createYonaMcpServer({ client, allowLive }: YonaMcpServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,KAAK,EAAC,QAAQ,EAAiB,MAAM,sBAAsB,CAAC;AAQnE,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,mFAAmF;AACnF,qBAAa,oBAAqB,SAAQ,KAAK;;CAQ9C;AAYD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAC,MAAM,EAAE,SAAiB,EAAC,EAAE,oBAAoB,GAAG,SAAS,CAwChG"}

package/dist/server.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveModeRefusedError = void 0;
+exports.createYonaMcpServer = createYonaMcpServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const idempotency_1 = require("./idempotency");
+const prompts_1 = require("./prompts");
+const resources_1 = require("./resources");
+const result_1 = require("./result");
+const tools_1 = require("./tools");
+const version_1 = require("./version");
+/** Thrown by {@link createYonaMcpServer} for a live client without `allowLive`. */
+class LiveModeRefusedError extends Error {
+    constructor() {
+        super('This is a live API key: live calls report real invoices to the tax authority and charge real credits. ' +
+            'Live mode is refused unless it is explicitly allowed (YONA_ALLOW_LIVE=true). Use a sandbox key (sk_test_…) to try things.');
+        this.name = 'LiveModeRefusedError';
+    }
+}
+exports.LiveModeRefusedError = LiveModeRefusedError;
+function instructions(mode) {
+    return [
+        `Yona e-invoicing (${mode} mode). Tools create buyers, items and invoices, validate them, and report them to the tax authority.`,
+        'Usual flow: get_organization → search_buyers / create_buyer → create_invoice (a draft) → validate_invoice → finalise_invoice → submit_invoice → get_submission_status.',
+        'submit_invoice, cancel_invoice and issue_credit_note cannot be undone and need confirm: true, which you set only after the user approved that exact action.',
+        'Every result carries "mode": in "live" mode a submission is a legal filing and spends real credits.',
+        'Reference data: yona://reference/tax-categories, yona://reference/units, yona://reference/hs-codes?q=…',
+    ].join('\n');
+}
+/**
+ * Builds the Yona MCP server: the tools, resources and prompts of the spec, over the given client.
+ * Connect it to any transport (stdio, streamable HTTP). Throws {@link LiveModeRefusedError} for a
+ * live client unless `allowLive` is true.
+ */
+function createYonaMcpServer({ client, allowLive = false }) {
+    if (client.mode === 'live' && !allowLive)
+        throw new LiveModeRefusedError();
+    const mode = client.mode;
+    const server = new mcp_js_1.McpServer({ name: version_1.SERVER_NAME, version: version_1.VERSION }, { instructions: instructions(mode) });
+    for (const tool of tools_1.TOOLS) {
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        }, async (input, extra) => {
+            try {
+                const { confirm, ...args } = input;
+                if (tool.destructive && confirm !== true) {
+                    throw new result_1.ToolRefusal('MCP_CONFIRM_REQUIRED', `${tool.name} cannot be undone. Ask the user to approve it, then call it again with confirm: true.`);
+                }
+                const options = { signal: extra.signal };
+                if (tool.keyed) {
+                    options.idempotencyKey = (0, idempotency_1.deriveIdempotencyKey)(tool.name, { requestId: extra.requestId, sessionId: extra.sessionId }, args);
+                }
+                const out = await tool.run({ client, options }, args);
+                return (0, result_1.ok)(mode, out.data, { requestId: out.requestId, note: out.note });
+            }
+            catch (error) {
+                return (0, result_1.fail)(mode, error);
+            }
+        });
+    }
+    (0, resources_1.registerResources)(server, client);
+    (0, prompts_1.registerPrompts)(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;AAiDA,kDAwCC;AAzFD,oEAAkE;AAElE,+CAAmD;AACnD,uCAA0C;AAC1C,2CAA8C;AAC9C,qCAA+C;AAC/C,mCAA8B;AAC9B,uCAA+C;AAgB/C,mFAAmF;AACnF,MAAa,oBAAqB,SAAQ,KAAK;IAC3C;QACI,KAAK,CACD,wGAAwG;YACpG,2HAA2H,CAClI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AARD,oDAQC;AAED,SAAS,YAAY,CAAC,IAAY;IAC9B,OAAO;QACH,qBAAqB,IAAI,uGAAuG;QAChI,wKAAwK;QACxK,6JAA6J;QAC7J,qGAAqG;QACrG,wGAAwG;KAC3G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,EAAC,MAAM,EAAE,SAAS,GAAG,KAAK,EAAuB;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC,EAAC,IAAI,EAAE,qBAAW,EAAE,OAAO,EAAE,iBAAO,EAAC,EAAE,EAAC,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC;IAExG,KAAK,MAAM,IAAI,IAAI,aAAK,EAAE,CAAC;QACvB,MAAM,CAAC,YAAY,CACf,IAAI,CAAC,IAAI,EACT;YACI,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAChC,EACD,KAAK,EAAE,KAA8B,EAAE,KAAK,EAAE,EAAE;YAC5C,IAAI,CAAC;gBACD,MAAM,EAAC,OAAO,EAAE,GAAG,IAAI,EAAC,GAAG,KAAK,CAAC;gBACjC,IAAI,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACvC,MAAM,IAAI,oBAAW,CACjB,sBAAsB,EACtB,GAAG,IAAI,CAAC,IAAI,uFAAuF,CACtG,CAAC;gBACN,CAAC;gBACD,MAAM,OAAO,GAAmB,EAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAC,CAAC;gBACvD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACb,OAAO,CAAC,cAAc,GAAG,IAAA,kCAAoB,EAAC,IAAI,CAAC,IAAI,EAAE,EAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAC,EAAE,IAAI,CAAC,CAAC;gBAC7H,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,EAAE,IAAI,CAAC,CAAC;gBACpD,OAAO,IAAA,WAAE,EAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAC,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAC,CAAC,CAAC;YAC1E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,IAAA,aAAI,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC,CACJ,CAAC;IACN,CAAC;IAED,IAAA,6BAAiB,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAA,yBAAe,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { EInvoice, RequestOptions } from '@useyona/einvoice-js';
+/** What a tool's handler receives besides its arguments. */
+export interface ToolContext {
+    client: EInvoice;
+    /** Request options for every SDK call: the abort signal, and the derived `Idempotency-Key` on writes. */
+    options: RequestOptions;
+}
+/** What a tool's handler returns: the data and, when the SDK exposed it, the request id. */
+export interface ToolOutput {
+    data: unknown;
+    requestId?: string;
+    note?: string;
+}
+export interface ToolDefinition {
+    name: string;
+    title: string;
+    /** Written for a model: what it does, when to use it, what it costs, what it cannot undo. */
+    description: string;
+    inputSchema: z.ZodRawShape;
+    annotations: ToolAnnotations;
+    /** The SDK methods the tool may call (`invoices.create`); the contract test checks each exists. */
+    sdk: readonly string[];
+    /** Requires `confirm: true` (and is annotated `destructiveHint: true`). */
+    destructive: boolean;
+    /** Sends a derived `Idempotency-Key` (writes, and charged calls the API keys). */
+    keyed: boolean;
+    run(ctx: ToolContext, args: any): Promise<ToolOutput>;
+}
+/** The organisation, its readiness and its profile; shared with the yona://organization resource. */
+export declare function readOrganization(client: EInvoice, options: RequestOptions): Promise<unknown>;
+export declare const TOOLS: readonly ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAC,QAAQ,EAAQ,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAoBzE,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,yGAAyG;IACzG,OAAO,EAAE,cAAc,CAAC;CAC3B;AAED,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,WAAW,EAAE,eAAe,CAAC;IAC7B,mGAAmG;IACnG,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,KAAK,EAAE,OAAO,CAAC;IAEf,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACzD;AAqCD,qGAAqG;AACrG,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlG;AAED,eAAO,MAAM,KAAK,EAAE,SAAS,cAAc,EA4Q1C,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS = void 0;
+exports.readOrganization = readOrganization;
+const zod_1 = require("zod");
+const schemas_1 = require("./schemas");
+const result_1 = require("../result");
+const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+/** A read that the API charges for (or that asks the tax authority): not read-only for a client's auto-approval. */
+const CHARGED_READ = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+const WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true };
+function define(def) {
+    const destructive = def.destructive ?? false;
+    return {
+        ...def,
+        inputSchema: destructive ? { ...def.inputSchema, confirm: schemas_1.confirm } : def.inputSchema,
+        annotations: { title: def.title, ...def.annotations },
+        destructive,
+        keyed: def.keyed ?? false,
+    };
+}
+/** A list answer as a model reads it. */
+function page(result) {
+    return { data: { items: result.data, pagination: result.pagination }, requestId: result.requestId };
+}
+const DESTRUCTIVE_NOTE = ' Requires confirm: true. Before calling, show the user what will happen and get their explicit approval in the conversation.';
+/** The organisation, its readiness and its profile; shared with the yona://organization resource. */
+async function readOrganization(client, options) {
+    const readiness = await client.organization.getReadiness(options);
+    const account = await client.billing.accounts.getMine(undefined, options);
+    const organization = await client.organization.get(account.organizationId, options);
+    return { organization, readiness };
+}
+exports.TOOLS = [
+    define({
+        name: 'get_organization',
+        title: 'Get organisation',
+        description: 'The organisation the API key belongs to: its profile (name, tax id, address) and its readiness to report invoices (what onboarding step is next, whether live mode is enabled). Call this first to know who is invoicing and whether invoices can be submitted. Free.',
+        inputSchema: {},
+        annotations: READ,
+        sdk: ['organization.getReadiness', 'billing.accounts.getMine', 'organization.get'],
+        run: async ({ client, options }) => ({ data: await readOrganization(client, options) }),
+    }),
+    define({
+        name: 'lookup_tin',
+        title: 'Look up a tax id',
+        description: 'Looks up a tax id (TIN) with the tax authority and returns the registered name and whether it can receive e-invoices. Use it before creating a buyer or when the user is unsure of a TIN. Charged per lookup (refunded when the authority cannot answer).',
+        inputSchema: schemas_1.lookupTinFields,
+        annotations: CHARGED_READ,
+        sdk: ['reference.lookupTaxId'],
+        keyed: true,
+        run: async ({ client, options }, { taxId, type }) => ({
+            data: await client.reference.lookupTaxId(taxId, type ? { type } : undefined, options),
+        }),
+    }),
+    define({
+        name: 'search_buyers',
+        title: 'Search buyers',
+        description: 'Lists the organisation’s saved buyers (customers), optionally filtered by text or tax-id verification status. Use it to find a buyerId before creating an invoice, and before create_buyer to avoid duplicates. Free.',
+        inputSchema: schemas_1.searchBuyersFields,
+        annotations: READ,
+        sdk: ['buyers.list'],
+        run: async ({ client, options }, args) => page(await client.buyers.list(args, options)),
+    }),
+    define({
+        name: 'get_buyer',
+        title: 'Get a buyer',
+        description: 'One saved buyer by id, with its tax id, address and verification status. Free.',
+        inputSchema: { buyerId: (0, schemas_1.id)('buyer') },
+        annotations: READ,
+        sdk: ['buyers.get'],
+        run: async ({ client, options }, { buyerId }) => ({ data: await client.buyers.get(buyerId, options) }),
+    }),
+    define({
+        name: 'create_buyer',
+        title: 'Create a buyer',
+        description: 'Saves a new buyer (customer) to invoice. B2B and B2G invoices need a buyer with a tax id; search_buyers first to avoid a duplicate. Charged per buyer created.',
+        inputSchema: schemas_1.buyerFields,
+        annotations: WRITE,
+        sdk: ['buyers.create'],
+        keyed: true,
+        run: async ({ client, options }, args) => ({ data: await client.buyers.create(args, options) }),
+    }),
+    define({
+        name: 'search_items',
+        title: 'Search items',
+        description: 'Lists the organisation’s saved items (goods and services with their codes, unit, price and tax category). An invoice line that names an itemId takes all of these from the item. Free.',
+        inputSchema: schemas_1.searchItemsFields,
+        annotations: READ,
+        sdk: ['items.list'],
+        run: async ({ client, options }, args) => page(await client.items.list(args, options)),
+    }),
+    define({
+        name: 'create_item',
+        title: 'Create an item',
+        description: 'Saves a good or service for reuse on invoice lines. Goods need an HS code (yona://reference/hs-codes), services an ISIC service code. The price is in MINOR units (kobo). Free.',
+        inputSchema: schemas_1.itemFields,
+        annotations: WRITE,
+        sdk: ['items.create'],
+        keyed: true,
+        run: async ({ client, options }, args) => ({ data: await client.items.create(args, options) }),
+    }),
+    define({
+        name: 'list_invoices',
+        title: 'List invoices',
+        description: 'Lists invoices the organisation issued, newest first, filtered by status, reporting state, payment status (e.g. unpaid), buyer, date or text. Use it to find an invoiceId or to answer questions about what was invoiced. Free.',
+        inputSchema: schemas_1.listInvoicesFields,
+        annotations: READ,
+        sdk: ['invoices.list'],
+        run: async ({ client, options }, args) => page(await client.invoices.list(args, options)),
+    }),
+    define({
+        name: 'get_invoice',
+        title: 'Get an invoice',
+        description: 'One invoice by id: its lines, totals, status, buyer, seller and reporting state. Free.',
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice') },
+        annotations: READ,
+        sdk: ['invoices.get'],
+        run: async ({ client, options }, { invoiceId }) => ({ data: await client.invoices.get(invoiceId, options) }),
+    }),
+    define({
+        name: 'create_invoice',
+        title: 'Create a draft invoice',
+        description: 'Creates a DRAFT invoice. Nothing is reported to the tax authority until finalise_invoice and submit_invoice. Prefer lines with an itemId; otherwise give description, unitCode, unitPrice (major units) and taxCategory per line. Then call validate_invoice. Charged as one invoice creation.',
+        inputSchema: schemas_1.invoiceFields,
+        annotations: WRITE,
+        sdk: ['invoices.create'],
+        keyed: true,
+        run: async ({ client, options }, args) => ({ data: await client.invoices.create(args, options) }),
+    }),
+    define({
+        name: 'update_invoice',
+        title: 'Update a draft invoice',
+        description: 'Changes a DRAFT invoice; only the fields given change, and lineItems, when given, replaces every line. A finalised or submitted invoice cannot be updated. Free.',
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice'), ...schemas_1.updateInvoiceFields },
+        annotations: { ...WRITE, idempotentHint: true },
+        sdk: ['invoices.update'],
+        run: async ({ client, options }, { invoiceId, ...changes }) => ({
+            data: await client.invoices.update(invoiceId, changes, options),
+        }),
+    }),
+    define({
+        name: 'validate_invoice',
+        title: 'Validate an invoice',
+        description: 'Checks an invoice with the tax authority’s rules without storing or submitting anything: give an invoiceId (a stored draft) or the document fields. Answers whether it is valid and, if not, why. Call it before finalise_invoice. Charged per validation (refunded when the authority cannot answer).',
+        inputSchema: schemas_1.validateInvoiceFields,
+        annotations: CHARGED_READ,
+        sdk: ['reference.validateInvoice'],
+        keyed: true,
+        run: async ({ client, options }, args) => {
+            if (!args.invoiceId && !args.lineItems) {
+                throw new result_1.ToolRefusal('MCP_INPUT', 'Give an invoiceId, or the document fields with lineItems.');
+            }
+            return { data: await client.reference.validateInvoice(args, options) };
+        },
+    }),
+    define({
+        name: 'finalise_invoice',
+        title: 'Finalise an invoice',
+        description: 'Finalises a draft: freezes the seller and buyer onto it and checks it against the jurisdiction’s rules. After this the invoice can no longer be changed with update_invoice (this server has no tool to reopen it). It is not yet reported: submit_invoice does that. Free.',
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice') },
+        annotations: { ...WRITE, idempotentHint: true },
+        sdk: ['invoices.finalise'],
+        run: async ({ client, options }, { invoiceId }) => ({ data: await client.invoices.finalise(invoiceId, options) }),
+    }),
+    define({
+        name: 'submit_invoice',
+        title: 'Submit an invoice to the tax authority',
+        description: 'Reports a finalised invoice to the tax authority (in live mode this is a legal filing; in sandbox it goes to the authority’s test environment). Charges credits. It cannot be withdrawn: a reported invoice is corrected only by cancel_invoice or issue_credit_note. Submission is asynchronous: follow it with get_submission_status. finalise: true finalises a draft first.' +
+            DESTRUCTIVE_NOTE,
+        inputSchema: {
+            invoiceId: (0, schemas_1.id)('invoice'),
+            finalise: zod_1.z.boolean().optional().describe('true: finalise the draft first, then submit.'),
+        },
+        annotations: DESTRUCTIVE,
+        destructive: true,
+        sdk: ['submissions.submit'],
+        keyed: true,
+        run: async ({ client, options }, { invoiceId, finalise }) => ({
+            data: await client.submissions.submit(invoiceId, finalise ? { finalise: 'true' } : undefined, options),
+        }),
+    }),
+    define({
+        name: 'get_submission_status',
+        title: 'Get submission status',
+        description: 'Where an invoice’s report to the tax authority stands: queued, transmitted, accepted, rejected or parked, with the authority’s reference and, when it failed or parked, the reason. Poll it after submit_invoice. Free.',
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice') },
+        annotations: READ,
+        sdk: ['submissions.getStatus'],
+        run: async ({ client, options }, { invoiceId }) => ({ data: await client.submissions.getStatus(invoiceId, options) }),
+    }),
+    define({
+        name: 'cancel_invoice',
+        title: 'Cancel an invoice',
+        description: 'Cancels an issued invoice: voided when the tax authority does not hold it, otherwise reversed by a credit note reported to the authority. Cannot be undone. A draft cannot be cancelled (it is simply never submitted).' +
+            DESTRUCTIVE_NOTE,
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice'), reason: zod_1.z.string().min(1).describe('Why the invoice is cancelled.') },
+        annotations: DESTRUCTIVE,
+        destructive: true,
+        sdk: ['invoices.cancel'],
+        keyed: true,
+        run: async ({ client, options }, { invoiceId, reason }) => ({
+            data: await client.invoices.cancel(invoiceId, { reason }, options),
+        }),
+    }),
+    define({
+        name: 'issue_credit_note',
+        title: 'Issue a credit note',
+        description: 'Issues a credit note against a reported invoice, in full, for some lines, or for an amount; it is reported to the tax authority and charges credits. Cannot be undone. Use preview: true first to show the user the result without writing or charging anything.' +
+            DESTRUCTIVE_NOTE,
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice'), ...schemas_1.creditNoteFields },
+        annotations: DESTRUCTIVE,
+        destructive: true,
+        sdk: ['invoices.issueCreditNote'],
+        keyed: true,
+        run: async ({ client, options }, { invoiceId, ...body }) => ({
+            data: await client.invoices.issueCreditNote(invoiceId, body, options),
+        }),
+    }),
+    define({
+        name: 'get_download_link',
+        title: 'Get a PDF download link',
+        description: 'A short-lived link to the invoice PDF, to give the user. The link expires (see expiresAt). Charged as one download.',
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice') },
+        annotations: CHARGED_READ,
+        sdk: ['output.getDownloadLink'],
+        keyed: true,
+        run: async ({ client, options }, { invoiceId }) => ({ data: await client.output.getDownloadLink(invoiceId, options) }),
+    }),
+    define({
+        name: 'create_share_link',
+        title: 'Create a share link',
+        description: 'Creates a public, revocable link to view an invoice, to send to the buyer. Anyone with the link can view the invoice until it expires or reaches maxViews. Free.',
+        inputSchema: { invoiceId: (0, schemas_1.id)('invoice'), ...schemas_1.shareLinkFields },
+        annotations: WRITE,
+        sdk: ['shareLinks.create'],
+        run: async ({ client, options }, { invoiceId, ...body }) => ({
+            data: await client.shareLinks.create(invoiceId, body, options),
+        }),
+    }),
+    define({
+        name: 'list_received_invoices',
+        title: 'List received invoices',
+        description: 'Lists invoices other businesses issued TO the organisation and reported to the tax authority (purchases), filtered by seller, payment status, date or text. Free.',
+        inputSchema: schemas_1.listInboundFields,
+        annotations: READ,
+        sdk: ['inboundInvoices.list'],
+        run: async ({ client, options }, args) => {
+            const result = await client.inboundInvoices.list(args, options);
+            return { data: { ...result.data, pagination: result.pagination }, requestId: result.requestId };
+        },
+    }),
+    define({
+        name: 'get_received_invoice',
+        title: 'Get a received invoice',
+        description: 'One received (purchase) invoice by id, with the seller and the document as the tax authority holds it. Free.',
+        inputSchema: { receivedInvoiceId: (0, schemas_1.id)('received invoice') },
+        annotations: READ,
+        sdk: ['inboundInvoices.get'],
+        run: async ({ client, options }, { receivedInvoiceId }) => ({
+            data: await client.inboundInvoices.get(receivedInvoiceId, options),
+        }),
+    }),
+    define({
+        name: 'get_balance',
+        title: 'Get credit balance',
+        description: 'The organisation’s credit balance for this key’s mode. Check it before charged actions (creating invoices or buyers, submitting, validating). Free.',
+        inputSchema: {},
+        annotations: READ,
+        sdk: ['billing.accounts.getMine'],
+        run: async ({ client, options }) => ({ data: await client.billing.accounts.getMine(undefined, options) }),
+    }),
+    define({
+        name: 'list_webhook_deliveries',
+        title: 'List webhook deliveries',
+        description: 'Lists the webhook deliveries Yona made to the organisation’s endpoints, by status, endpoint or event type, to debug an integration that missed an event. Free.',
+        inputSchema: schemas_1.listDeliveriesFields,
+        annotations: READ,
+        sdk: ['webhooks.deliveries.list'],
+        run: async ({ client, options }, args) => page(await client.webhooks.deliveries.list(args, options)),
+    }),
+];
+//# sourceMappingURL=index.js.map