@taxdao/fintax-mcp 0.2.0

package/dist/tools/core-read/export-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-transactions.js","sourceRoot":"","sources":["../../../src/tools/core-read/export-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,yBAAyB;CACzB,CAAC;AAEX,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,mEAAmE;IACzE,GAAG,EAAE,UAAU;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,4BAA4B;IACnC,WAAW,EACT,0PAA0P;IAC5P,IAAI,EAAE,IAAI;IACV,YAAY,EAAE,WAAW;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAC1C,UAAU,EAAE,gBAAgB;IAC5B,iBAAiB,EAAE,uBAAuB,CAAC,6BAA6B,CAAC;IACzE,WAAW,EAAE,6BAA6B;IAC1C,YAAY,EAAE,8BAA8B;IAC5C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB;IACD,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO;QAC7B,MAAM,KAAK,GAAG,6BAA6B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,+BAA+B,CAAC,KAAK,CACpD,MAAM,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE;YACjE,GAAG,KAAK,CAAC,OAAO;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CACH,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU,KAAK,CAAC,gBAAgB,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC;QACjF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1E,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE;oBAC1D,SAAS,EAAE,QAAQ,CAAC,QAAQ;oBAC5B,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;oBACrC,UAAU,EAAE,QAAQ,CAAC,IAAI;oBACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,QAAQ,CAAC,SAAS;iBAC/B;aACF;YACD,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,WAAW,EAAE;gBACX;oBACE,OAAO,EAAE,OAAO;oBAChB,SAAS,EAAE,OAAO,KAAK,CAAC,gBAAgB,SAAS;iBAClD;gBACD,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE;aACjD;SACF,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,MAAM;QACd,MAAM,MAAM,GAAG,8BAA8B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,aAAa,MAAM,CAAC,IAAI,CAAC,gBAAgB,uBAAuB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC;IAC3G,CAAC;CACF,CAAC"}

package/dist/tools/core-read/query-accounting-balances.d.ts

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

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

@@ -0,0 +1,135 @@
+import { accountingBalanceDynamicUpstreamSchema, accountingBalanceTreeUpstreamSchema, queryAccountingBalancesInputSchema, queryAccountingBalancesOutputSchema, } from '../../schemas/domains/accounting-balances.js';
+import { createPublicInputSchema } from '../../schemas/public-input.js';
+function treeNode(item) {
+    return {
+        coa_code: item.coa_code,
+        coa_name: item.coa_name,
+        node_type: item.node_type,
+        base_currency: item.base_currency,
+        base_opening: item.base_opening,
+        base_debit: item.base_debit,
+        base_credit: item.base_credit,
+        base_ending: item.base_ending,
+        origin_currency: item.origin_currency,
+        origin_opening: item.origin_opening,
+        origin_debit: item.origin_debit,
+        origin_credit: item.origin_credit,
+        origin_ending: item.origin_ending,
+        reconcile: item.reconcile,
+        children: item.children.map(treeNode),
+        self_leaf: item.self_leaf === null ? null : treeNode(item.self_leaf),
+    };
+}
+function totals(item) {
+    return {
+        base_currency: item.base_currency,
+        base_opening: item.base_opening,
+        base_debit: item.base_debit,
+        base_credit: item.base_credit,
+        base_ending: item.base_ending,
+    };
+}
+function warnings(requestedBalanceType, effectiveBalanceType, recalculateRequired) {
+    const values = [];
+    if (requestedBalanceType !== effectiveBalanceType) {
+        values.push(`The requested balance type ${requestedBalanceType} was adjusted to the effective type ${effectiveBalanceType}.`);
+    }
+    if (recalculateRequired) {
+        values.push('Accounting balances require recalculation; the current result may not be up to date.');
+    }
+    return values;
+}
+export const queryAccountingBalancesTool = {
+    name: 'query_accounting_balances',
+    title: 'Query FinTax Accounting Balances',
+    description: 'Query a hierarchical trial balance or dynamic balances expanded by auxiliary dimensions without modifying data. Use trial_balance for the account tree and trial totals, and dynamic_balance to change aggregation granularity using enabled auxiliary dimensions. Use query_journals for journal details. Results are not paginated, amounts remain decimal strings, and the effective balance type is returned.',
+    risk: 'R0',
+    exposurePack: 'core-read',
+    capabilityIds: ['suite.acct.balance.tree', 'suite.acct.dynamic_balance.list'],
+    fileAccess: 'none',
+    publicInputSchema: createPublicInputSchema(queryAccountingBalancesInputSchema),
+    inputSchema: queryAccountingBalancesInputSchema,
+    outputSchema: queryAccountingBalancesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    async execute(rawInput, context) {
+        const input = queryAccountingBalancesInputSchema.parse(rawInput);
+        const request = {
+            period_from: input.period_from,
+            period_to: input.period_to,
+            ledger_id: input.ledger_id,
+            balance_type: input.balance_type,
+            coa_code: input.coa_code,
+            base_currency: input.base_currency,
+            account_name: input.account_name,
+        };
+        if (input.view === 'trial_balance') {
+            const upstream = accountingBalanceTreeUpstreamSchema.parse(await context.callCapability('suite.acct.balance.tree', request));
+            return {
+                ok: true,
+                data: {
+                    view: input.view,
+                    balance_type: upstream.balance_type,
+                    recalculate_required: upstream.recalculate_required,
+                    tree: upstream.tree.map(treeNode),
+                    totals: totals(upstream.totals),
+                },
+                warnings: warnings(input.balance_type, upstream.balance_type, upstream.recalculate_required),
+                trace_id: context.traceId,
+                source_refs: [{ service: 'suite', operation: 'acct.balance.tree' }],
+            };
+        }
+        const upstream = accountingBalanceDynamicUpstreamSchema.parse(await context.callCapability('suite.acct.dynamic_balance.list', {
+            ...request,
+            dimensions: input.dimensions,
+        }));
+        return {
+            ok: true,
+            data: {
+                view: input.view,
+                balance_type: upstream.balance_type,
+                recalculate_required: upstream.recalculate_required,
+                applied_dimensions: upstream.applied_dimensions.map((item) => ({
+                    name: item.name,
+                    label: item.label,
+                })),
+                items: upstream.items.map((item) => ({
+                    coa_code: item.coa_code,
+                    coa_name: item.coa_name,
+                    dimensions: item.dimensions.map((dimension) => ({
+                        name: dimension.name,
+                        value: dimension.value,
+                    })),
+                    base_currency: item.base_currency,
+                    base_opening: item.base_opening,
+                    base_debit: item.base_debit,
+                    base_credit: item.base_credit,
+                    base_ending: item.base_ending,
+                    origin_currency: item.origin_currency,
+                    origin_opening: item.origin_opening,
+                    origin_debit: item.origin_debit,
+                    origin_credit: item.origin_credit,
+                    origin_ending: item.origin_ending,
+                })),
+                totals: totals(upstream.totals),
+            },
+            warnings: warnings(input.balance_type, upstream.balance_type, upstream.recalculate_required),
+            trace_id: context.traceId,
+            source_refs: [
+                { service: 'suite', operation: 'acct.dynamic_balance.list' },
+            ],
+        };
+    },
+    summarize(output) {
+        const parsed = queryAccountingBalancesOutputSchema.parse(output);
+        const count = parsed.data.view === 'trial_balance'
+            ? parsed.data.tree.length
+            : parsed.data.items.length;
+        return `Returned ${count} top-level results for ${parsed.data.view}.`;
+    },
+};
+//# sourceMappingURL=query-accounting-balances.js.map

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

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

package/dist/tools/core-read/query-accounting-context.d.ts

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

package/dist/tools/core-read/query-accounting-context.js

@@ -0,0 +1,76 @@
+import { FinTaxError } from '../../errors/fintax-error.js';
+import { accountingContextLedgerUpstreamSchema, queryAccountingContextInputSchema, queryAccountingContextOutputSchema, } from '../../schemas/domains/accounting-context.js';
+import { z } from 'zod/v4';
+function optionalString(organization, snakeCase, camelCase) {
+    const raw = organization;
+    const value = raw[snakeCase] ?? raw[camelCase];
+    return typeof value === 'string' ? value : null;
+}
+function optionalBoolean(organization, snakeCase, camelCase) {
+    const raw = organization;
+    const value = raw[snakeCase] ?? raw[camelCase];
+    return typeof value === 'boolean' ? value : null;
+}
+export const queryAccountingContextTool = {
+    name: 'query_accounting_context',
+    title: 'Query FinTax Organization and Ledger Context',
+    description: 'Discover the organizations accessible to the current user and the active ledgers available to the selected organization without modifying data. Call this Tool before balance, report, or export Tools that require org_id or ledger_id. It queries the current login organization by default; to inspect another organization, call it again with an organization ID returned here in context.org_id. It never returns roles, permissions, tokens, or cookies.',
+    risk: 'R0',
+    exposurePack: 'core-read',
+    capabilityIds: ['suite.acct.coa.accessible_ledgers'],
+    fileAccess: 'none',
+    inputSchema: queryAccountingContextInputSchema,
+    outputSchema: queryAccountingContextOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    async execute(rawInput, context) {
+        queryAccountingContextInputSchema.parse(rawInput);
+        const identity = await context.getIdentity();
+        if (identity.orgId === undefined) {
+            throw new FinTaxError('VALIDATION_FAILED', 'The current login session has no available organization context');
+        }
+        const selectedOrgId = identity.orgId;
+        const ledgers = z
+            .array(accountingContextLedgerUpstreamSchema)
+            .parse(await context.callCapability('suite.acct.coa.accessible_ledgers', {}));
+        return {
+            ok: true,
+            data: {
+                selected_org_id: selectedOrgId,
+                organizations: identity.orgs.map((organization) => ({
+                    id: organization.id,
+                    name: organization.name ?? null,
+                    timezone_id: optionalString(organization, 'timezone_id', 'timezoneId'),
+                    parent_id: optionalString(organization, 'parent_id', 'parentId'),
+                    is_booking_node: optionalBoolean(organization, 'is_booking_node', 'isBookingNode'),
+                    is_selected: organization.id === selectedOrgId,
+                })),
+                ledgers: ledgers.map((ledger) => ({
+                    id: ledger.id,
+                    org_id: selectedOrgId,
+                    ledger_code: ledger.ledger_code,
+                    ledger_name: ledger.ledger_name,
+                    ledger_type: ledger.ledger_type,
+                    base_currency: ledger.base_currency,
+                })),
+            },
+            warnings: ledgers.length === 0
+                ? ['The current organization has no active ledgers.']
+                : [],
+            trace_id: context.traceId,
+            source_refs: [
+                { service: 'base', operation: 'auth.me' },
+                { service: 'suite', operation: 'acct.coa.accessible_ledgers' },
+            ],
+        };
+    },
+    summarize(output) {
+        const parsed = queryAccountingContextOutputSchema.parse(output);
+        return `The current organization has ${parsed.data.ledgers.length} available ledgers; the current identity can access ${parsed.data.organizations.length} organizations.`;
+    },
+};
+//# sourceMappingURL=query-accounting-context.js.map

package/dist/tools/core-read/query-accounting-context.js.map

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

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

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

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

@@ -0,0 +1,425 @@
+import { assetAllocationLinesUpstreamSchema, assetCardUpstreamSchema, assetDepreciationDetailsUpstreamSchema, assetFinanceListUpstreamSchema, assetFinanceUpstreamSchema, assetMovementListUpstreamSchema, assetSourceLinesUpstreamSchema, assetWorkbenchListUpstreamSchema, queryAssetsInputSchema, queryAssetsOutputSchema, } from '../../schemas/domains/assets.js';
+import { createPublicInputSchema } from '../../schemas/public-input.js';
+const CAPABILITY_IDS = [
+    'suite.fa.workbench.cards.list',
+    'suite.fa.workbench.card.detail',
+    'suite.fa.workbench.finances.by_card',
+    'suite.fa.workbench.finance.detail',
+    'suite.fa.workbench.finance.source_lines',
+    'suite.fa.workbench.finance.allocation_lines',
+    'suite.fa.workbench.finance.depreciation_details',
+    'suite.fa.movement_detail.list',
+];
+function nullable(value) {
+    return value ?? null;
+}
+function auxiliary(item) {
+    return Object.fromEntries(Array.from({ length: 12 }, (_, index) => {
+        const key = `attribute${index + 1}`;
+        const value = item[key];
+        return [key, typeof value === 'string' ? value : null];
+    }));
+}
+function workbenchRow(item) {
+    return {
+        asset_finance_id: item.asset_finance_id,
+        card_id: item.card_id,
+        asset_no: item.asset_no,
+        description: nullable(item.description),
+        tag_no: nullable(item.tag_no),
+        ledger_id: nullable(item.ledger_id),
+        ledger_name: nullable(item.ledger_name),
+        category_id: nullable(item.category_id),
+        category_name: nullable(item.category_name),
+        asset_type: nullable(item.asset_type),
+        location: nullable(item.location),
+        quantity: item.quantity,
+        original_cost: item.original_cost,
+        nbv: item.nbv,
+        accum_depr: item.accum_depr,
+        in_use: item.in_use,
+        version: nullable(item.version),
+        card_attachment_count: item.card_attachment_count,
+        finance_attachment_count: item.finance_attachment_count,
+        approval_status: nullable(item.approval_status),
+        verification_status: nullable(item.verification_status),
+        finance_approval_status: nullable(item.finance_approval_status),
+        finance_verification_status: nullable(item.finance_verification_status),
+    };
+}
+function card(item) {
+    return {
+        id: item.id,
+        asset_no: item.asset_no,
+        tag_no: nullable(item.tag_no),
+        serial_no: nullable(item.serial_no),
+        asset_type: nullable(item.asset_type),
+        category_id: nullable(item.category_id),
+        category_name: nullable(item.category_name),
+        manufacturer: nullable(item.manufacturer),
+        asset_name: nullable(item.asset_name),
+        in_use: item.in_use,
+        description: nullable(item.description),
+        asset_key_field: nullable(item.asset_key_field),
+        quantity: item.quantity,
+        unit: nullable(item.unit),
+        location: nullable(item.location),
+        version: nullable(item.version),
+        approval_status: nullable(item.approval_status),
+        verification_status: nullable(item.verification_status),
+        approved_by: nullable(item.approved_by),
+        approved_at: nullable(item.approved_at),
+    };
+}
+function finance(item) {
+    return {
+        id: item.id,
+        card_id: item.card_id,
+        category_id: nullable(item.category_id),
+        category_name: nullable(item.category_name),
+        ledger_id: nullable(item.ledger_id),
+        ledger_name: nullable(item.ledger_name),
+        remark: nullable(item.remark),
+        current_cost: item.current_cost,
+        original_cost: item.original_cost,
+        salvage_type: nullable(item.salvage_type),
+        salvage_pct: item.salvage_pct,
+        salvage_value: item.salvage_value,
+        recoverable_cost: item.recoverable_cost,
+        nbv: item.nbv,
+        ytd_depr: item.ytd_depr,
+        accum_depr: item.accum_depr,
+        accum_impair: item.accum_impair,
+        accum_retire: item.accum_retire,
+        depr_method_id: nullable(item.depr_method_id),
+        useful_life_years: nullable(item.useful_life_years),
+        months: nullable(item.months),
+        depr_flag: item.depr_flag,
+        disabled_flag: item.disabled_flag,
+        start_date: nullable(item.start_date),
+        depr_start_rule: nullable(item.depr_start_rule),
+        retire_rule: nullable(item.retire_rule),
+        amortize_adjust: nullable(item.amortize_adjust),
+        cap_limit: item.cap_limit,
+        coa_accounts: {
+            asset_cost: nullable(item.asset_cost_coa_code),
+            asset_clearing: nullable(item.asset_clearing_coa_code),
+            depreciation_expense: nullable(item.depr_expense_coa_code),
+            accumulated_depreciation: nullable(item.accum_depr_coa_code),
+            additional_expense: nullable(item.addl_expense_coa_code),
+            additional_reserve: nullable(item.addl_reserve_coa_code),
+            revaluation_reserve: nullable(item.reval_reserve_coa_code),
+            cip_cost: nullable(item.cip_cost_coa_code),
+            cip_clearing: nullable(item.cip_clearing_coa_code),
+            accumulated_impairment: nullable(item.accum_impair_coa_code),
+            unplanned_depreciation: nullable(item.unplanned_depr_coa_code),
+            writeoff: nullable(item.writeoff_coa_code),
+        },
+        version: nullable(item.version),
+        approval_status: nullable(item.approval_status),
+        verification_status: nullable(item.verification_status),
+        approved_by: nullable(item.approved_by),
+        approved_at: nullable(item.approved_at),
+    };
+}
+function sourceLine(item) {
+    return {
+        id: item.id,
+        asset_finance_id: item.asset_finance_id,
+        line_no: nullable(item.line_no),
+        invoice_no: nullable(item.invoice_no),
+        invoice_line_no: nullable(item.invoice_line_no),
+        party_id: nullable(item.party_id),
+        party_name: nullable(item.party_name),
+        party_code: nullable(item.party_code),
+        description: nullable(item.description),
+        line_amount: item.line_amount,
+        version: nullable(item.version),
+    };
+}
+function allocationLine(item) {
+    return {
+        id: item.id,
+        asset_finance_id: item.asset_finance_id,
+        line_no: nullable(item.line_no),
+        quantity: item.quantity,
+        employee_name: nullable(item.employee_name),
+        depr_expense_coa_code: nullable(item.depr_expense_coa_code),
+        attributes: auxiliary(item),
+        description: nullable(item.description),
+        reference: nullable(item.reference),
+        remark: nullable(item.remark),
+        version: nullable(item.version),
+    };
+}
+function movementEvent(item) {
+    return {
+        event_id: item.event_id,
+        event_no: item.event_no,
+        event_time: item.event_time,
+        event_type: item.event_type,
+        entry_source: item.entry_source,
+    };
+}
+function movementJournal(item) {
+    return {
+        journal_id: item.journal_id,
+        journal_number: item.journal_number,
+        period_name: item.period_name,
+        approval_status: item.approval_status,
+        ledger_id: item.ledger_id,
+        event_id: item.event_id,
+    };
+}
+function depreciationDetail(item) {
+    return {
+        id: item.id,
+        movement_type: item.movement_type,
+        amount: item.amount,
+        biz_date: nullable(item.biz_date),
+        period_name: nullable(item.period_name),
+        fiscal_year: nullable(item.fiscal_year),
+        periods_covered: nullable(item.periods_covered),
+        alloc_line_id: nullable(item.alloc_line_id),
+        quantity: item.quantity,
+        coa_code: nullable(item.coa_code),
+        attributes: auxiliary(item),
+        description: nullable(item.description),
+        reference: nullable(item.reference),
+        remark: nullable(item.remark),
+        events: item.events.map(movementEvent),
+        journals: item.journals.map(movementJournal),
+    };
+}
+function movementRow(item) {
+    return {
+        id: item.id,
+        asset_finance_id: item.asset_finance_id,
+        card_id: item.card_id,
+        alloc_line_id: item.alloc_line_id,
+        asset_no: item.asset_no,
+        asset_description: item.asset_description,
+        tag_no: item.tag_no,
+        ledger_id: item.ledger_id,
+        ledger_name: item.ledger_name,
+        currency: item.currency,
+        movement_type: item.movement_type,
+        origin_movement_type: item.origin_movement_type,
+        employee_name: item.employee_name,
+        coa_code: item.coa_code,
+        biz_date: item.biz_date,
+        period_name: item.period_name,
+        derived_period_name: item.derived_period_name,
+        fiscal_year: item.fiscal_year,
+        periods_covered: item.periods_covered,
+        quantity: item.quantity,
+        amount: item.amount,
+        is_reversed: item.is_reversed,
+        reverse_of_id: item.reverse_of_id,
+        remark: item.remark,
+        attributes: auxiliary(item.aux),
+        events: item.events.map(movementEvent),
+        journals: item.journals.map(movementJournal),
+    };
+}
+async function financeIncludes(financeId, includes, context) {
+    const calls = includes.map(async (include) => {
+        if (include === 'source_lines') {
+            const upstream = assetSourceLinesUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.finance.source_lines', { finance_id: financeId }));
+            return {
+                include,
+                value: {
+                    original_cost: upstream.original_cost,
+                    lines: upstream.lines.map(sourceLine),
+                },
+                operation: 'fa.workbench.finance.source_lines',
+            };
+        }
+        if (include === 'allocation_lines') {
+            const upstream = assetAllocationLinesUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.finance.allocation_lines', { finance_id: financeId }));
+            return {
+                include,
+                value: {
+                    total_quantity: upstream.total_quantity,
+                    lines: upstream.lines.map(allocationLine),
+                },
+                operation: 'fa.workbench.finance.allocation_lines',
+            };
+        }
+        const upstream = assetDepreciationDetailsUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.finance.depreciation_details', { finance_id: financeId }));
+        return {
+            include,
+            value: {
+                summary: upstream.summary === null
+                    ? null
+                    : {
+                        asset_finance_id: upstream.summary.asset_finance_id,
+                        ledger_id: upstream.summary.ledger_id,
+                        asset_no: upstream.summary.asset_no,
+                        tag_no: upstream.summary.tag_no,
+                        description: upstream.summary.description,
+                        ledger_name: upstream.summary.ledger_name,
+                        currency: upstream.summary.currency,
+                        original_cost: upstream.summary.original_cost,
+                        recoverable_cost: upstream.summary.recoverable_cost,
+                        nbv: upstream.summary.nbv,
+                        ytd_depr: upstream.summary.ytd_depr,
+                        accum_depr: upstream.summary.accum_depr,
+                    },
+                items: upstream.list.map(depreciationDetail),
+            },
+            operation: 'fa.workbench.finance.depreciation_details',
+        };
+    });
+    const results = await Promise.allSettled(calls);
+    const data = {};
+    const warnings = [];
+    const operations = [];
+    results.forEach((result, index) => {
+        const include = includes[index];
+        if (include === undefined)
+            return;
+        if (result.status === 'fulfilled') {
+            data[include] = result.value.value;
+            operations.push(result.value.operation);
+            return;
+        }
+        data[include] = null;
+        warnings.push(`Supporting asset financial data ${include} could not be read; the primary financial record was still returned.`);
+    });
+    return { data, warnings, operations };
+}
+export const queryAssetsTool = {
+    name: 'query_assets',
+    title: 'Query FinTax Fixed Assets',
+    description: 'Query the fixed-asset workspace, asset cards, ledger financial records, or saved value-movement history without modifying data. The finance view returns supporting details only when explicitly requested in include. This Tool does not calculate depreciation, impairment, or asset balances and must not be used to run depreciation, retirement, posting, or cost adjustments.',
+    risk: 'R0',
+    exposurePack: 'core-read',
+    capabilityIds: CAPABILITY_IDS,
+    fileAccess: 'none',
+    publicInputSchema: createPublicInputSchema(queryAssetsInputSchema),
+    inputSchema: queryAssetsInputSchema,
+    outputSchema: queryAssetsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    async execute(rawInput, context) {
+        const input = queryAssetsInputSchema.parse(rawInput);
+        if (input.view === 'list') {
+            const upstream = assetWorkbenchListUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.cards.list', {
+                filters: input.filters,
+                page: input.page,
+                page_size: input.page_size,
+            }));
+            const pageSize = upstream.page_size ?? upstream.pageSize ?? input.page_size;
+            return {
+                ok: true,
+                data: { view: input.view, items: upstream.list.map(workbenchRow) },
+                page: {
+                    number: upstream.page,
+                    size: pageSize,
+                    total_items: upstream.total,
+                    has_more: upstream.page * pageSize < upstream.total,
+                },
+                warnings: [],
+                trace_id: context.traceId,
+                source_refs: [
+                    { service: 'suite', operation: 'fa.workbench.cards.list' },
+                ],
+            };
+        }
+        if (input.view === 'detail') {
+            const upstreamCard = assetCardUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.card.detail', {
+                card_id: input.card_id,
+            }));
+            let finances = null;
+            const warnings = [];
+            const sourceRefs = [
+                { service: 'suite', operation: 'fa.workbench.card.detail' },
+            ];
+            try {
+                const upstreamFinances = assetFinanceListUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.finances.by_card', {
+                    card_id: input.card_id,
+                }));
+                finances = upstreamFinances.list.map(finance);
+                sourceRefs.push({
+                    service: 'suite',
+                    operation: 'fa.workbench.finances.by_card',
+                });
+            }
+            catch {
+                warnings.push('The asset ledger financial list could not be read; the primary asset card was still returned.');
+            }
+            return {
+                ok: true,
+                data: { view: input.view, card: card(upstreamCard), finances },
+                warnings,
+                trace_id: context.traceId,
+                source_refs: sourceRefs,
+            };
+        }
+        if (input.view === 'finance') {
+            const upstream = assetFinanceUpstreamSchema.parse(await context.callCapability('suite.fa.workbench.finance.detail', {
+                finance_id: input.finance_id,
+            }));
+            const included = await financeIncludes(input.finance_id, input.include, context);
+            return {
+                ok: true,
+                data: {
+                    view: input.view,
+                    finance: finance(upstream),
+                    include: input.include,
+                    ...included.data,
+                },
+                warnings: included.warnings,
+                trace_id: context.traceId,
+                source_refs: [
+                    { service: 'suite', operation: 'fa.workbench.finance.detail' },
+                    ...included.operations.map((operation) => ({
+                        service: 'suite',
+                        operation,
+                    })),
+                ],
+            };
+        }
+        const upstream = assetMovementListUpstreamSchema.parse(await context.callCapability('suite.fa.movement_detail.list', {
+            filters: input.filters,
+            page: input.page,
+            page_size: input.page_size,
+        }));
+        const pageSize = upstream.page_size ?? upstream.pageSize ?? input.page_size;
+        return {
+            ok: true,
+            data: {
+                view: input.view,
+                items: upstream.list.map(movementRow),
+                summary: upstream.summary,
+            },
+            page: {
+                number: upstream.page,
+                size: pageSize,
+                total_items: upstream.total,
+                has_more: upstream.page * pageSize < upstream.total,
+            },
+            warnings: [],
+            trace_id: context.traceId,
+            source_refs: [{ service: 'suite', operation: 'fa.movement_detail.list' }],
+        };
+    },
+    summarize(output) {
+        const parsed = queryAssetsOutputSchema.parse(output);
+        if (parsed.data.view === 'detail') {
+            const count = parsed.data.finances?.length;
+            return count === undefined
+                ? 'Returned the asset card; the ledger financial list is unavailable.'
+                : `Returned the asset card and ${count} ledger financial records.`;
+        }
+        if (parsed.data.view === 'finance')
+            return 'Returned one asset financial record.';
+        return `Returned ${parsed.data.items.length} asset ${parsed.data.view === 'list' ? 'workspace records' : 'movement records'}.`;
+    },
+};
+//# sourceMappingURL=query-assets.js.map