@axiom-billing/mcp 0.1.0

package/dist/prompts/index.js

@@ -0,0 +1,97 @@
+/**
+ * Prompts are user-facing workflow starters — they appear as slash commands
+ * or quick-actions in MCP-aware UIs. Each one expands to a `messages` array
+ * the host injects into the conversation. The bodies are instruction templates
+ * that ground the model in Axiom's tools and resources; they do NOT execute
+ * tool calls themselves.
+ */
+function userMessage(text) {
+    return { role: 'user', content: { type: 'text', text } };
+}
+const monthEndClose = {
+    name: 'month-end-close',
+    description: 'Walk through a month-end close: review unmatched bank transactions, run P&L and balance sheet, flag anomalies.',
+    arguments: [
+        { name: 'period', description: 'Period to close in YYYY-MM format (e.g. "2026-05").', required: true },
+    ],
+    build: (args) => {
+        const period = args.period ?? '<period>';
+        return {
+            description: `Month-end close for ${period}`,
+            messages: [userMessage(`Help me close the books for ${period}. Work through these steps using the Axiom MCP tools and resources:\n\n` +
+                    `1. Read \`axiom://company/profile\` to confirm fiscal-year alignment.\n` +
+                    `2. Read \`axiom://chart-of-accounts\` so you can refer to accounts by name.\n` +
+                    `3. Call \`list_unmatched_bank_transactions\` and walk each row — propose a match using \`propose_reconciliation\`.\n` +
+                    `4. Call \`get_report\` with reportId="profit-and-loss-cash-basis" for dateFrom=${period}-01 to the period end.\n` +
+                    `5. Call \`get_report\` with reportId="balance-sheet" dated at the period end.\n` +
+                    `6. Flag anomalies: account balances that swung >20% MoM, negative liabilities, zero-activity accounts that used to be active.\n` +
+                    `7. Summarize what's safe to close vs what needs the bookkeeper's attention.`)],
+        };
+    },
+};
+const reconcileBankAccount = {
+    name: 'reconcile-bank-account',
+    description: 'Reconcile a bank account: list unmatched transactions, propose ledger matches for each, summarize anything that needs human review.',
+    arguments: [
+        { name: 'accountId', description: 'Bank account id (chart-of-accounts code). Omit to reconcile all bank accounts.', required: false },
+        { name: 'period', description: 'Period to reconcile in YYYY-MM. Omit for current period.', required: false },
+    ],
+    build: (args) => {
+        const scope = args.accountId ? `account ${args.accountId}` : 'all bank accounts';
+        const period = args.period ?? 'the current period';
+        return {
+            description: `Reconcile ${scope} for ${period}`,
+            messages: [userMessage(`Reconcile ${scope} for ${period}.\n\n` +
+                    `1. Call \`list_unmatched_bank_transactions\`.\n` +
+                    `2. For each row, call \`propose_reconciliation\` with the bankTransactionId. Read \`axiom://ledger/{transactionId}\` for any candidate match the suggestion references.\n` +
+                    `3. Group results into: (a) high-confidence auto-matches, (b) ambiguous matches needing review, (c) bank tx with no ledger candidate (likely missing journal entry).\n` +
+                    `4. For category (c), describe what journal entry should be created — do NOT call \`create_invoice_draft\` or any write tool. Hand off the list to the human.`)],
+        };
+    },
+};
+const reviewArAging = {
+    name: 'review-ar-aging',
+    description: 'Review AR aging buckets, highlight overdue customers, and draft suggested follow-up actions.',
+    arguments: [
+        { name: 'asOfDate', description: 'Aging cut-off in YYYY-MM-DD. Defaults to today.', required: false },
+    ],
+    build: (args) => {
+        const asOf = args.asOfDate ?? 'today';
+        return {
+            description: `Review AR aging as of ${asOf}`,
+            messages: [userMessage(`Review AR aging as of ${asOf}.\n\n` +
+                    `1. Call \`summarize_ar_aging\`${args.asOfDate ? ` with asOfDate="${args.asOfDate}"` : ''}.\n` +
+                    `2. For each contact with >60 days outstanding, read \`axiom://contact/{contactId}\` for context (terms, prior payment history).\n` +
+                    `3. Call \`list_open_invoices\` for those contacts to itemize what's overdue.\n` +
+                    `4. Draft a short follow-up action per contact: friendly reminder (<30), firm reminder (30–60), collections escalation (>60).\n` +
+                    `5. Do NOT send anything. Output a table the bookkeeper can review and dispatch manually.`)],
+        };
+    },
+};
+const prepare1040cInputs = {
+    name: 'prepare-1040c-inputs',
+    description: 'Collect and validate the tax inputs the /reports/1040c endpoint needs before posting.',
+    arguments: [
+        { name: 'taxYear', description: 'Tax year (e.g. "2026").', required: true },
+    ],
+    build: (args) => {
+        const year = args.taxYear ?? '<taxYear>';
+        return {
+            description: `Prepare Schedule C inputs for ${year}`,
+            messages: [userMessage(`Gather the inputs required to file Schedule C (Form 1040) for tax year ${year}.\n\n` +
+                    `1. Read \`axiom://company/profile\` — confirm the entity is a sole proprietorship (Schedule C only applies to sole props / single-member LLCs).\n` +
+                    `2. Read \`axiom://chart-of-accounts\` to map account categories to Schedule C lines (gross receipts, returns, COGS, expenses by category).\n` +
+                    `3. Call \`get_report\` with reportId="profit-and-loss-cash-basis", dateFrom=${year}-01-01, dateTo=${year}-12-31.\n` +
+                    `4. Call \`get_report\` with reportId="general-ledger-detail" for the same range to verify P&L totals roll up correctly.\n` +
+                    `5. Summarize: (a) the Schedule C inputs you've collected, (b) anything ambiguous that needs the owner's confirmation (home-office %, vehicle mileage, depreciation method), (c) accounts that don't map cleanly to a Schedule C line.\n` +
+                    `6. Do NOT post to /reports/1040c yet — that's the next step after the owner confirms the inputs.`)],
+        };
+    },
+};
+export const ALL_PROMPTS = [
+    monthEndClose,
+    reconcileBankAccount,
+    reviewArAging,
+    prepare1040cInputs,
+];
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Resources expose read-only Axiom state to MCP clients via URI. Unlike tools,
+ * resources are addressable: a client can paste `axiom://chart-of-accounts`
+ * into a context window and the MCP host knows how to fetch it.
+ *
+ * Two flavors:
+ *   - StaticResource: fixed URI, listed in `resources/list`.
+ *   - TemplatedResource: parametric URI like `axiom://contact/{contactId}`,
+ *     listed in `resources/templates/list`. Clients construct the concrete URI
+ *     themselves (often after a tool call returns an id).
+ */
+export interface StaticResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    read: (companyId: string) => Promise<unknown>;
+}
+export interface TemplatedResource {
+    uriTemplate: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    match: (uri: string) => Record<string, string> | null;
+    read: (companyId: string, params: Record<string, string>) => Promise<unknown>;
+}
+export declare const STATIC_RESOURCES: StaticResource[];
+export declare const TEMPLATED_RESOURCES: TemplatedResource[];
+/** Look up which resource (static or templated) handles a given URI. */
+export declare function resolveResource(uri: string): {
+    kind: 'static';
+    resource: StaticResource;
+} | {
+    kind: 'templated';
+    resource: TemplatedResource;
+    params: Record<string, string>;
+} | null;

package/dist/resources/index.js

@@ -0,0 +1,79 @@
+import { axiomApi } from '../apiClient.js';
+// ── Static resources ────────────────────────────────────────────────────────
+const companyProfile = {
+    uri: 'axiom://company/profile',
+    name: 'Company profile',
+    description: 'Profile, fiscal-year settings, and contact info for the bound company.',
+    mimeType: 'application/json',
+    read: async (companyId) => await axiomApi.get(`/companies/${companyId}`),
+};
+const chartOfAccounts = {
+    uri: 'axiom://chart-of-accounts',
+    name: 'Chart of accounts',
+    description: 'All accounts (code, name, type, classification) for the bound company. Use as grounding when discussing accounts by name.',
+    mimeType: 'application/json',
+    read: async (companyId) => await axiomApi.get(`/companies/${companyId}/chart-of-accounts`),
+};
+const reportsCatalog = {
+    uri: 'axiom://reports/catalog',
+    name: 'Reports catalog',
+    description: 'List of available reports with their accepted date parameters. Use to pick a reportId for the `get_report` tool.',
+    mimeType: 'application/json',
+    read: async (companyId) => await axiomApi.get(`/companies/${companyId}/reports/catalog`),
+};
+// ── Templated resources ─────────────────────────────────────────────────────
+const contactTemplate = {
+    uriTemplate: 'axiom://contact/{contactId}',
+    name: 'Contact (templated)',
+    description: 'A single contact (customer or supplier) by id. Construct the URI after a `find_contact` call returns the id.',
+    mimeType: 'application/json',
+    match: (uri) => {
+        const m = /^axiom:\/\/contact\/([^/]+)$/.exec(uri);
+        return m ? { contactId: m[1] } : null;
+    },
+    read: async (companyId, params) => await axiomApi.get(`/companies/${companyId}/contacts/${params.contactId}`),
+};
+const ledgerTemplate = {
+    uriTemplate: 'axiom://ledger/{transactionId}',
+    name: 'Ledger transaction (templated)',
+    description: 'A single ledger transaction by id. Returns all legs (debits/credits) and account metadata.',
+    mimeType: 'application/json',
+    match: (uri) => {
+        const m = /^axiom:\/\/ledger\/([^/]+)$/.exec(uri);
+        return m ? { transactionId: m[1] } : null;
+    },
+    read: async (companyId, params) => {
+        const all = await axiomApi.get(`/companies/${companyId}/ledger`);
+        // The unversioned ledger endpoint returns either the bare object or an
+        // envelope depending on version — handle both.
+        const transactions = 'transactions' in all
+            ? all.transactions
+            : all.data?.transactions ?? [];
+        const tx = transactions.find(t => t.transactionId === params.transactionId);
+        if (!tx)
+            throw new Error(`Transaction ${params.transactionId} not found.`);
+        return tx;
+    },
+};
+export const STATIC_RESOURCES = [
+    companyProfile,
+    chartOfAccounts,
+    reportsCatalog,
+];
+export const TEMPLATED_RESOURCES = [
+    contactTemplate,
+    ledgerTemplate,
+];
+/** Look up which resource (static or templated) handles a given URI. */
+export function resolveResource(uri) {
+    const direct = STATIC_RESOURCES.find(r => r.uri === uri);
+    if (direct)
+        return { kind: 'static', resource: direct };
+    for (const t of TEMPLATED_RESOURCES) {
+        const params = t.match(uri);
+        if (params)
+            return { kind: 'templated', resource: t, params };
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+import { createServer as createHttpServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { zodToJsonSchema } from './zodToJsonSchema.js';
+import { ALL_TOOLS } from './tools/index.js';
+import { STATIC_RESOURCES, TEMPLATED_RESOURCES, resolveResource, } from './resources/index.js';
+import { ALL_PROMPTS } from './prompts/index.js';
+import { logger } from './logger.js';
+import { axiomApi } from './apiClient.js';
+const SERVER_NAME = 'axiom-mcp';
+const SERVER_VERSION = '0.1.0';
+/**
+ * MCP server entry point. Stdio by default; `--http <port>` (default 8210)
+ * exposes the Streamable HTTP transport at `POST /mcp` for inspectors and
+ * curl-based testing.
+ */
+async function main() {
+    const mode = parseMode(process.argv.slice(2));
+    const server = buildServer();
+    logger.bind(server);
+    if (mode.kind === 'http') {
+        await startHttp(server, mode.port);
+    }
+    else {
+        await startStdio(server);
+    }
+}
+function buildServer() {
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        capabilities: {
+            tools: { listChanged: true },
+            resources: { listChanged: true },
+            prompts: { listChanged: true },
+            logging: {},
+        },
+    });
+    // ── tools ──────────────────────────────────────────────────────────────
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: ALL_TOOLS.map(t => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.inputSchema),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = ALL_TOOLS.find(t => t.name === request.params.name);
+        if (!tool) {
+            logger.warning(`tool not found: ${request.params.name}`);
+            return {
+                content: [{ type: 'text', text: `Unknown tool: ${request.params.name}` }],
+                isError: true,
+            };
+        }
+        logger.info(`tool ${tool.name} called`);
+        try {
+            const result = await tool.handler(request.params.arguments ?? {});
+            logger.debug(`tool ${tool.name} succeeded`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.error(`tool ${tool.name} failed: ${message}`);
+            return {
+                content: [{ type: 'text', text: `Tool error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── resources ──────────────────────────────────────────────────────────
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: STATIC_RESOURCES.map(r => ({
+            uri: r.uri,
+            name: r.name,
+            description: r.description,
+            mimeType: r.mimeType,
+        })),
+    }));
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+        resourceTemplates: TEMPLATED_RESOURCES.map(r => ({
+            uriTemplate: r.uriTemplate,
+            name: r.name,
+            description: r.description,
+            mimeType: r.mimeType,
+        })),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        const resolved = resolveResource(uri);
+        if (!resolved) {
+            logger.warning(`resource not found: ${uri}`);
+            throw new Error(`Resource ${uri} is not exposed by this server.`);
+        }
+        const companyId = axiomApi.getCompanyId();
+        logger.info(`reading resource ${uri}`);
+        const data = resolved.kind === 'static'
+            ? await resolved.resource.read(companyId)
+            : await resolved.resource.read(companyId, resolved.params);
+        return {
+            contents: [{
+                    uri,
+                    mimeType: resolved.resource.mimeType,
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+    // ── prompts ────────────────────────────────────────────────────────────
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: ALL_PROMPTS.map(p => ({
+            name: p.name,
+            description: p.description,
+            arguments: p.arguments,
+        })),
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const prompt = ALL_PROMPTS.find(p => p.name === request.params.name);
+        if (!prompt) {
+            throw new Error(`Prompt ${request.params.name} is not exposed by this server.`);
+        }
+        // The SDK types `params.arguments` as `Record<string, string> | undefined`,
+        // but we accept undefined per-arg and let each prompt validate required ones.
+        const args = (request.params.arguments ?? {});
+        for (const a of prompt.arguments) {
+            if (a.required && !args[a.name]) {
+                throw new Error(`Prompt ${prompt.name} requires argument "${a.name}".`);
+            }
+        }
+        logger.info(`prompt ${prompt.name} built`);
+        return prompt.build(args);
+    });
+    // ── logging ────────────────────────────────────────────────────────────
+    server.setRequestHandler(SetLevelRequestSchema, async (request) => {
+        logger.setLevel(request.params.level);
+        return {};
+    });
+    return server;
+}
+async function startStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Process stderr — protocol logging isn't useful until the client has
+    // negotiated, and even then they may not subscribe. This line confirms the
+    // server reached the run loop.
+    console.error(`${SERVER_NAME} v${SERVER_VERSION} ready (stdio)`);
+    logger.info(`${SERVER_NAME} v${SERVER_VERSION} ready`, { transport: 'stdio' });
+}
+async function startHttp(server, port) {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+    });
+    await server.connect(transport);
+    const http = createHttpServer((req, res) => {
+        if (req.url === '/' || req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                server: SERVER_NAME,
+                version: SERVER_VERSION,
+                transport: 'streamable-http',
+                endpoint: '/mcp',
+            }));
+            return;
+        }
+        if (req.url?.startsWith('/mcp')) {
+            transport.handleRequest(req, res).catch((err) => {
+                console.error('handleRequest failed:', err);
+                if (!res.headersSent) {
+                    res.writeHead(500, { 'Content-Type': 'text/plain' });
+                    res.end('Internal server error');
+                }
+            });
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not found');
+    });
+    http.listen(port, '127.0.0.1', () => {
+        console.log(`${SERVER_NAME} v${SERVER_VERSION} listening on http://127.0.0.1:${port}/mcp`);
+        logger.info(`${SERVER_NAME} v${SERVER_VERSION} ready`, { transport: 'streamable-http', port });
+    });
+}
+function parseMode(argv) {
+    const i = argv.indexOf('--http');
+    if (i === -1)
+        return { kind: 'stdio' };
+    const next = argv[i + 1];
+    const port = next && /^\d+$/.test(next) ? Number(next) : 8210;
+    return { kind: 'http', port };
+}
+main().catch(err => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType;
+    handler: (input: unknown) => Promise<unknown>;
+}
+export declare const ALL_TOOLS: ToolDefinition[];

package/dist/tools/index.js

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+import { axiomApi } from '../apiClient.js';
+// ── Read tools (v1) ─────────────────────────────────────────────────────────
+const FindContactInput = z.object({
+    query: z.string().describe('Substring to match against contact name or email.'),
+});
+const findContact = {
+    name: 'find_contact',
+    description: 'Find contacts (customers / suppliers) by name or email substring.',
+    inputSchema: FindContactInput,
+    handler: async (raw) => {
+        const input = FindContactInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        const res = await axiomApi.get(`/companies/${companyId}/contacts?search=${encodeURIComponent(input.query)}`);
+        return res.data;
+    },
+};
+const SummarizeArAgingInput = z.object({
+    asOfDate: z.string().optional().describe('Optional ISO date; defaults to today.'),
+});
+const summarizeArAging = {
+    name: 'summarize_ar_aging',
+    description: 'Summarize accounts-receivable aging buckets (current, 30, 60, 90+ days).',
+    inputSchema: SummarizeArAgingInput,
+    handler: async (raw) => {
+        SummarizeArAgingInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        const open = await axiomApi.get(`/companies/${companyId}/reports/open-invoices`);
+        return open.data;
+    },
+};
+const ListOpenInvoicesInput = z.object({
+    contactId: z.string().optional(),
+});
+const listOpenInvoices = {
+    name: 'list_open_invoices',
+    description: 'List unpaid invoices for the bound company, optionally filtered by contactId.',
+    inputSchema: ListOpenInvoicesInput,
+    handler: async (raw) => {
+        const input = ListOpenInvoicesInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        const path = input.contactId
+            ? `/companies/${companyId}/reports/open-invoices?contactId=${encodeURIComponent(input.contactId)}`
+            : `/companies/${companyId}/reports/open-invoices`;
+        const res = await axiomApi.get(path);
+        return res.data;
+    },
+};
+const ListUnmatchedBankTxInput = z.object({});
+const listUnmatchedBankTransactions = {
+    name: 'list_unmatched_bank_transactions',
+    description: 'List bank transactions that have not yet been matched to a ledger entry.',
+    inputSchema: ListUnmatchedBankTxInput,
+    handler: async () => {
+        const companyId = axiomApi.getCompanyId();
+        const res = await axiomApi.get(`/v1/companies/${companyId}/bank-transactions`);
+        return (res.data ?? []).filter(t => t.status === 'posted' || t.status === 'pending');
+    },
+};
+const ExplainLedgerEntryInput = z.object({
+    transactionId: z.string(),
+});
+const explainLedgerEntry = {
+    name: 'explain_ledger_entry',
+    description: 'Fetch all legs of a ledger transaction with account metadata so you can summarize it.',
+    inputSchema: ExplainLedgerEntryInput,
+    handler: async (raw) => {
+        const input = ExplainLedgerEntryInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        // The unversioned route is the only one currently exposing this; v1 alias comes later.
+        const all = await axiomApi.get(`/companies/${companyId}/ledger`);
+        const tx = all.transactions?.find(t => t.transactionId === input.transactionId);
+        if (!tx)
+            throw new Error(`Transaction ${input.transactionId} not found.`);
+        return tx;
+    },
+};
+const GetReportInput = z.object({
+    reportId: z.enum([
+        'profit-and-loss-cash-basis',
+        'balance-sheet',
+        'income-statement',
+        'general-ledger-detail',
+        'open-invoices',
+        'sales-by-customer',
+        'sales-by-item',
+        'inventory-valuation',
+        'purchase-history',
+    ]),
+    dateFrom: z.string().optional(),
+    dateTo: z.string().optional(),
+});
+// MCP-facing reportId → actual API path segment. Lets the public tool contract
+// stay stable while the backend uses its own naming.
+const REPORT_PATH_BY_ID = {
+    'profit-and-loss-cash-basis': 'profit-and-loss',
+    'balance-sheet': 'balance-sheet',
+    'income-statement': 'income-statement',
+    'general-ledger-detail': 'general-ledger',
+    'open-invoices': 'open-invoices',
+    'sales-by-customer': 'sales-by-customer',
+    'sales-by-item': 'sales-by-item',
+    'inventory-valuation': 'inventory-valuation',
+    'purchase-history': 'purchase-history',
+};
+const getReport = {
+    name: 'get_report',
+    description: 'Run a standard Axiom report and return its data.',
+    inputSchema: GetReportInput,
+    handler: async (raw) => {
+        const input = GetReportInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        const segment = REPORT_PATH_BY_ID[input.reportId];
+        const params = new URLSearchParams();
+        if (input.dateFrom)
+            params.set('dateFrom', input.dateFrom);
+        if (input.dateTo)
+            params.set('dateTo', input.dateTo);
+        const path = `/companies/${companyId}/reports/${segment}` +
+            (params.size ? `?${params.toString()}` : '');
+        return await axiomApi.get(path);
+    },
+};
+// ── Write tools (v2 — gated by approval policy) ─────────────────────────────
+const CreateInvoiceDraftInput = z.object({
+    contactId: z.string(),
+    items: z.array(z.object({
+        description: z.string(),
+        amount: z.number(),
+        quantity: z.number().int().positive().optional(),
+    })),
+    dueDate: z.string().optional(),
+});
+const createInvoiceDraft = {
+    name: 'create_invoice_draft',
+    description: 'Create an invoice in DRAFT state. The user must explicitly finalize it from the UI; this tool never finalizes.',
+    inputSchema: CreateInvoiceDraftInput,
+    handler: async (raw) => {
+        const input = CreateInvoiceDraftInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        return await axiomApi.post(`/v1/companies/${companyId}/approvals`, {
+            tool: 'create_invoice_draft',
+            payload: input,
+        });
+    },
+};
+const RecordPaymentInput = z.object({
+    invoiceId: z.string(),
+    amount: z.number().positive(),
+    method: z.string().optional(),
+    receivedDate: z.string().optional(),
+});
+const recordPayment = {
+    name: 'record_payment',
+    description: 'Record a payment against an invoice. Requires explicit human approval per the per-company policy.',
+    inputSchema: RecordPaymentInput,
+    handler: async (raw) => {
+        const input = RecordPaymentInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        return await axiomApi.post(`/v1/companies/${companyId}/approvals`, {
+            tool: 'record_payment',
+            payload: input,
+        });
+    },
+};
+const ProposeReconciliationInput = z.object({
+    bankTransactionId: z.string(),
+});
+const proposeReconciliation = {
+    name: 'propose_reconciliation',
+    description: 'Look at a bank transaction and propose a matching ledger entry. Read-only suggestion — never writes.',
+    inputSchema: ProposeReconciliationInput,
+    handler: async (raw) => {
+        const input = ProposeReconciliationInput.parse(raw);
+        const companyId = axiomApi.getCompanyId();
+        const all = await axiomApi.get(`/v1/companies/${companyId}/bank-transactions`);
+        const target = all.data?.find(t => t.id === input.bankTransactionId);
+        if (!target)
+            throw new Error(`Bank transaction ${input.bankTransactionId} not found.`);
+        return {
+            target,
+            suggestion: `Look for a ledger entry near ${target.postedDate} with amount ${target.amount}. Use match endpoint to confirm.`,
+        };
+    },
+};
+export const ALL_TOOLS = [
+    findContact,
+    summarizeArAging,
+    listOpenInvoices,
+    listUnmatchedBankTransactions,
+    explainLedgerEntry,
+    getReport,
+    createInvoiceDraft,
+    recordPayment,
+    proposeReconciliation,
+];
+//# sourceMappingURL=index.js.map