@taxdao/fintax-mcp 0.2.0

package/dist/tools/core-read/query-fund-balances.js

@@ -0,0 +1,150 @@
+import { fundBalanceListUpstreamSchema, fundBalanceSnapshotListUpstreamSchema, fundBalanceUpstreamSchema, queryFundBalancesInputSchema, queryFundBalancesOutputSchema, } from '../../schemas/domains/fund-balances.js';
+import { createPublicInputSchema } from '../../schemas/public-input.js';
+function balance(item) {
+    return {
+        id: item.id,
+        account_id: item.account_id ?? null,
+        sub_account_id: item.sub_account_id,
+        sub_account_code: item.sub_account_code,
+        sub_account_name: item.sub_account_name,
+        account_name: item.account_name ?? null,
+        symbol: item.symbol,
+        asset_scope: item.asset_scope,
+        chain: item.chain ?? null,
+        contract_address: item.contract_address ?? null,
+        api_balance: item.api_balance,
+        txn_balance: item.txn_balance,
+        discrepancy: item.discrepancy,
+        recon_status: item.recon_status,
+        usd_price: item.usd_price,
+        usd_amount: item.usd_amount,
+        last_api_sync_at: item.last_api_sync_at ?? null,
+        last_txn_calc_at: item.last_txn_calc_at ?? null,
+        version: item.version ?? null,
+    };
+}
+function group(item) {
+    return {
+        account_id: item.account_id,
+        account_name: item.account_name ?? null,
+        symbol: item.symbol ?? null,
+        api_balance: item.api_balance,
+        txn_balance: item.txn_balance,
+        discrepancy: item.discrepancy,
+        usd_amount: item.usd_amount,
+        recon_status: item.recon_status,
+        last_api_sync_at: item.last_api_sync_at ?? null,
+        last_txn_calc_at: item.last_txn_calc_at ?? null,
+        sub_account_count: item.sub_account_count,
+        symbol_count: item.symbol_count,
+        discrepancy_count: item.discrepancy_count,
+    };
+}
+export const queryFundBalancesTool = {
+    name: 'query_fund_balances',
+    title: 'Query FinTax Fund Balances',
+    description: 'Query fund-balance lists, individual balance details, or historical snapshots without modifying data. Aggregate list values come directly from business data and are not recalculated by MCP. Balance synchronization batch results are not currently available.',
+    risk: 'R0',
+    exposurePack: 'core-read',
+    capabilityIds: [
+        'suite.fnd.balance.list',
+        'suite.fnd.balance.detail',
+        'suite.fnd.balance.snapshots',
+    ],
+    fileAccess: 'none',
+    publicInputSchema: createPublicInputSchema(queryFundBalancesInputSchema),
+    inputSchema: queryFundBalancesInputSchema,
+    outputSchema: queryFundBalancesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    async execute(rawInput, context) {
+        const input = queryFundBalancesInputSchema.parse(rawInput);
+        if (input.view === 'list') {
+            const upstream = fundBalanceListUpstreamSchema.parse(await context.callCapability('suite.fnd.balance.list', {
+                ...input.filters,
+                sort: input.sort,
+                page: input.page,
+                page_size: input.page_size,
+            }));
+            return {
+                ok: true,
+                data: {
+                    view: input.view,
+                    total_balance_rows: upstream.total,
+                    total_accounts: upstream.total_accounts,
+                    zero_hidden_count: upstream.zero_hidden_count,
+                    items: upstream.items.map(balance),
+                    account_groups: upstream.account_groups.map(group),
+                    symbol_groups: upstream.symbol_groups.map(group),
+                },
+                page: {
+                    number: upstream.page,
+                    size: upstream.page_size,
+                    total_items: upstream.total_accounts,
+                    has_more: upstream.page * upstream.page_size < upstream.total_accounts,
+                },
+                warnings: [],
+                trace_id: context.traceId,
+                source_refs: [{ service: 'suite', operation: 'fnd.balance.list' }],
+            };
+        }
+        if (input.view === 'detail') {
+            const upstream = fundBalanceUpstreamSchema.parse(await context.callCapability('suite.fnd.balance.detail', {
+                balance_id: input.balance_id,
+            }));
+            return {
+                ok: true,
+                data: { view: input.view, item: balance(upstream) },
+                warnings: [],
+                trace_id: context.traceId,
+                source_refs: [{ service: 'suite', operation: 'fnd.balance.detail' }],
+            };
+        }
+        const upstream = fundBalanceSnapshotListUpstreamSchema.parse(await context.callCapability('suite.fnd.balance.snapshots', {
+            balance_id: input.balance_id,
+            from: input.from,
+            to: input.to,
+            page: input.page,
+            page_size: input.page_size,
+        }));
+        return {
+            ok: true,
+            data: {
+                view: input.view,
+                balance_id: input.balance_id,
+                items: upstream.items.map((item) => ({
+                    id: item.id,
+                    snapshot_date: item.snapshot_date,
+                    api_balance: item.api_balance,
+                    txn_balance: item.txn_balance,
+                    discrepancy: item.discrepancy,
+                    recon_status: item.recon_status,
+                    usd_price: item.usd_price,
+                    usd_amount: item.usd_amount,
+                    snapshot_trigger: item.snapshot_trigger,
+                    version: item.version ?? null,
+                })),
+            },
+            page: {
+                number: upstream.page,
+                size: upstream.page_size,
+                total_items: upstream.total,
+                has_more: upstream.page * upstream.page_size < upstream.total,
+            },
+            warnings: [],
+            trace_id: context.traceId,
+            source_refs: [{ service: 'suite', operation: 'fnd.balance.snapshots' }],
+        };
+    },
+    summarize(output) {
+        const parsed = queryFundBalancesOutputSchema.parse(output);
+        if (parsed.data.view === 'detail')
+            return 'Returned one fund-balance detail record.';
+        return `Returned ${parsed.data.items.length} items for ${parsed.data.view}.`;
+    },
+};
+//# sourceMappingURL=query-fund-balances.js.map

package/dist/tools/core-read/query-fund-balances.js.map

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

package/dist/tools/core-read/query-journals.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../tool-definition.js';
+export declare const queryJournalsTool: ToolDefinition;

package/dist/tools/core-read/query-journals.js

@@ -0,0 +1,277 @@
+import { FinTaxError } from '../../errors/fintax-error.js';
+import { journalAttachmentsUpstreamSchema, journalDocumentsUpstreamSchema, journalListUpstreamSchema, journalSourceLinksUpstreamSchema, queryJournalsInputSchema, queryJournalsOutputSchema, } from '../../schemas/domains/journals.js';
+import { createPublicInputSchema } from '../../schemas/public-input.js';
+async function optionalRead(enabled, read) {
+    if (!enabled)
+        return { status: 'skipped' };
+    try {
+        return { status: 'succeeded', value: await read() };
+    }
+    catch {
+        return { status: 'failed' };
+    }
+}
+function attribute(item) {
+    return {
+        slot: item.slot,
+        name: item.name,
+        value: item.value,
+        code: item.code,
+    };
+}
+function listAttributes(item) {
+    if (item.attributes.length > 0)
+        return item.attributes.map(attribute);
+    const raw = item;
+    return Array.from({ length: 12 }, (_, index) => {
+        const slot = `attribute${index + 1}`;
+        const value = raw[slot];
+        if (typeof value !== 'string')
+            return undefined;
+        return { slot, name: null, value, code: value };
+    }).filter((value) => value !== undefined);
+}
+function listLine(item) {
+    return {
+        id: item.id ?? null,
+        line_no: item.line_no ?? null,
+        coa_code: item.coa_code,
+        coa_name: item.coa_name ?? null,
+        description: item.description ?? null,
+        base_currency: item.base_currency,
+        base_debit: item.base_debit,
+        base_credit: item.base_credit,
+        origin_currency: item.origin_currency ?? null,
+        origin_debit: item.origin_debit ?? null,
+        origin_credit: item.origin_credit ?? null,
+        attributes: listAttributes(item),
+        source_id: null,
+        source_type: null,
+        rate_amount: null,
+        rate_time: null,
+    };
+}
+function documentLine(item) {
+    return {
+        id: item.id,
+        line_no: null,
+        coa_code: item.coa_code,
+        coa_name: item.coa_name,
+        description: item.description,
+        base_currency: item.base_currency,
+        base_debit: item.base_debit,
+        base_credit: item.base_credit,
+        origin_currency: item.origin_currency,
+        origin_debit: item.origin_debit,
+        origin_credit: item.origin_credit,
+        attributes: item.attributes.map(attribute),
+        source_id: item.source_id,
+        source_type: item.source_type,
+        rate_amount: item.rate_amount,
+        rate_time: item.rate_time,
+    };
+}
+function listJournal(item, includeLines) {
+    return {
+        id: item.id,
+        journal_number: item.journal_number,
+        period_name: item.period_name,
+        entry_source: item.entry_source,
+        source_type: item.source_type,
+        journal_type: item.journal_type,
+        biz_date: item.biz_date,
+        gl_date: item.gl_date,
+        description: item.description ?? null,
+        org_id: item.org_id,
+        ledger_id: item.ledger_id,
+        org_name: item.org_name ?? null,
+        rule_h_id: null,
+        version: item.version ?? null,
+        attachment_count: item.attachment_count,
+        approval_status: item.approval_status,
+        verification_status: item.verification_status ?? null,
+        approved_by: item.approved_by ?? null,
+        approved_at: item.approved_at ?? null,
+        created_at: item.created_at ?? null,
+        updated_at: item.updated_at ?? null,
+        ...(includeLines ? { lines: item.lines.map(listLine) } : {}),
+    };
+}
+function detailJournal(item, ruleId, includeLines) {
+    return {
+        id: item.id,
+        journal_number: item.journal_number,
+        period_name: item.period_name,
+        entry_source: item.entry_source,
+        source_type: item.source_type,
+        journal_type: item.journal_type,
+        biz_date: item.biz_date,
+        gl_date: item.gl_date,
+        description: item.description,
+        org_id: item.org_id,
+        ledger_id: item.ledger_id,
+        org_name: null,
+        rule_h_id: ruleId,
+        version: item.version,
+        attachment_count: null,
+        approval_status: item.approval_status,
+        verification_status: item.verification_status,
+        approved_by: null,
+        approved_at: null,
+        created_at: null,
+        updated_at: null,
+        ...(includeLines ? { lines: item.lines.map(documentLine) } : {}),
+    };
+}
+function sourceLink(item) {
+    return {
+        source_ref_type: item.source_ref_type,
+        source_ref_id: item.source_ref_id,
+        source_ref_no: item.source_ref_no ?? null,
+        target_route: item.target_route ?? null,
+    };
+}
+function attachment(item) {
+    return {
+        id: item.id,
+        file_name: item.file_name,
+        content_type: item.content_type ?? null,
+        size_bytes: item.size_bytes,
+        created_by: item.created_by ?? null,
+        created_by_name: item.created_by_name ?? null,
+        created_at: item.created_at ?? null,
+    };
+}
+function findStoredJournal(response, journalId) {
+    for (const matchedRule of response.matched_rules) {
+        const item = matchedRule.journals.find((journal) => journal.id === journalId);
+        if (item !== undefined) {
+            return { item, ruleId: matchedRule.rule_h_id };
+        }
+    }
+    throw new FinTaxError('UPSTREAM_UNAVAILABLE', 'FinTax did not return the requested journal detail');
+}
+async function detail(input, context) {
+    const upstream = journalDocumentsUpstreamSchema.parse(await context.callCapability('suite.acct.journal.detail', {
+        journal_id: input.journal_id,
+    }));
+    const stored = findStoredJournal(upstream, input.journal_id);
+    const includeSourceLinks = input.include.includes('source_links');
+    const includeAttachments = input.include.includes('attachments');
+    const [sourceResult, attachmentResult] = await Promise.all([
+        optionalRead(includeSourceLinks, () => context.callCapability('suite.acct.journal.source_links', {
+            journal_id: input.journal_id,
+        })),
+        optionalRead(includeAttachments, () => context.callCapability('suite.acct.journal.attachments', {
+            journal_id: input.journal_id,
+        })),
+    ]);
+    const warnings = [];
+    const sourceRefs = [
+        { service: 'suite', operation: 'acct.journal.detail' },
+    ];
+    let sourceLinks;
+    if (sourceResult.status === 'succeeded') {
+        sourceLinks = journalSourceLinksUpstreamSchema
+            .parse(sourceResult.value)
+            .items.map(sourceLink);
+        sourceRefs.push({
+            service: 'suite',
+            operation: 'acct.journal.source_links',
+        });
+    }
+    else if (sourceResult.status === 'failed') {
+        warnings.push('Journal source links could not be read; the primary journal was still returned.');
+    }
+    let attachments;
+    if (attachmentResult.status === 'succeeded') {
+        const parsed = journalAttachmentsUpstreamSchema.parse(attachmentResult.value);
+        attachments = {
+            items: parsed.items.map(attachment),
+            mutable: parsed.mutable,
+            approval_status: parsed.approval_status,
+        };
+        sourceRefs.push({
+            service: 'suite',
+            operation: 'acct.journal.attachments',
+        });
+    }
+    else if (attachmentResult.status === 'failed') {
+        warnings.push('Journal attachments could not be read; the primary journal was still returned.');
+    }
+    return {
+        ok: true,
+        data: {
+            view: input.view,
+            item: {
+                ...detailJournal(stored.item, stored.ruleId, input.include.includes('lines')),
+                ...(sourceLinks === undefined ? {} : { source_links: sourceLinks }),
+                ...(attachments === undefined ? {} : { attachments }),
+            },
+        },
+        warnings,
+        trace_id: context.traceId,
+        source_refs: sourceRefs,
+    };
+}
+export const queryJournalsTool = {
+    name: 'query_journals',
+    title: 'Query FinTax Accounting Journals',
+    description: 'Query paginated accounting journals or retrieve one journal with optional lines, source links, and attachments without modifying data. Detail responses already contain saved lines and exchange rates and do not fetch new rates. Use export_journals for exports. If supporting source or attachment reads fail, the primary journal is still returned with warnings.',
+    risk: 'R0',
+    exposurePack: 'core-read',
+    capabilityIds: [
+        'suite.acct.journal.list',
+        'suite.acct.journal.detail',
+        'suite.acct.journal.source_links',
+        'suite.acct.journal.attachments',
+    ],
+    fileAccess: 'none',
+    publicInputSchema: createPublicInputSchema(queryJournalsInputSchema),
+    inputSchema: queryJournalsInputSchema,
+    outputSchema: queryJournalsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    async execute(rawInput, context) {
+        const input = queryJournalsInputSchema.parse(rawInput);
+        if (input.view === 'detail')
+            return detail(input, context);
+        const upstream = journalListUpstreamSchema.parse(await context.callCapability('suite.acct.journal.list', {
+            filters: input.filters,
+            page: input.page,
+            page_size: input.page_size,
+        }));
+        return {
+            ok: true,
+            data: {
+                view: input.view,
+                org_scope_narrowed: upstream.org_scope_narrowed,
+                items: upstream.items.map((item) => listJournal(item, input.include.includes('lines'))),
+            },
+            page: {
+                number: upstream.page,
+                size: upstream.page_size,
+                total_items: upstream.total,
+                has_more: upstream.page * upstream.page_size < upstream.total,
+            },
+            warnings: upstream.org_scope_narrowed
+                ? [
+                    "The organization-subtree result was narrowed by the current user's data permissions.",
+                ]
+                : [],
+            trace_id: context.traceId,
+            source_refs: [{ service: 'suite', operation: 'acct.journal.list' }],
+        };
+    },
+    summarize(output) {
+        const parsed = queryJournalsOutputSchema.parse(output);
+        if (parsed.data.view === 'detail')
+            return 'Returned one accounting-journal detail.';
+        return `Returned ${parsed.data.items.length} accounting journals.`;
+    },
+};
+//# sourceMappingURL=query-journals.js.map

package/dist/tools/core-read/query-journals.js.map

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

package/dist/tools/core-read/query-master-data.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../tool-definition.js';
+export declare const queryMasterDataTool: ToolDefinition;