@go-labs-sg/bb 2.20.0 → 2.24.1

package/dist/commands.js

@@ -1,2299 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { readFile, writeFile } from "node:fs/promises";
-import { basename } from "node:path";
-import { createInterface } from "node:readline/promises";
-import { contentType } from "mime-types";
-import { api } from "./api-client.js";
-import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedApprovalType, ExtendedBudgetStatus, TimeFrame, } from "./filter-enums.js";
-import { billStatusesForApi, } from "./parse-cli-enums.js";
-import { parseBudgetDiscountPayload, parseCompanyUpdatePayload, parseContactCreatePayload, parseContactUpdatePayload, parseCreateBillPayload, parseCreateBudgetPayload, parseCreateCustomerInvoicePayload, parseCreateQuotationPayload, parseItemCreatePayload, parseItemUpdatePayload, parseSendCustomerInvoiceToContactPersonPayload, parseSendEstimateToContactPersonPayload, parseSupplierCreatePayload, parseSupplierUpdatePayload, parseUpdateBillPayload, parseUpdateBillPaymentEvidencePayload, parseUpdateBudgetCommissionPayload, parseUpdateBudgetPayload, parseUpdateProjectPayload, parseUpdateQuotationPayload, parseValidateBillSelectionPayload, } from "./parse-mutation-payload.js";
-import { BillStatus, BudgetStatus, ProjectStatus } from "./prisma-enums.js";
-import { createRichTextFromPlainText } from "./rich-text.js";
-import { confirmCurrentCommand, emitCommandResult, getActiveCliSession, } from "./runtime/index.js";
-const BUDGET = "BUDGET";
-const BILL = "BILL";
-const SUPPLIER = "SUPPLIER";
-const QUOTATION = "QUOTATION";
-const CUSTOMER_INVOICE = "CUSTOMER_INVOICE";
-const ASANA_WON_LOST_SECTION_GIDS = new Set([
-    "1211678338364908",
-    "1211678338364907",
-]);
-const MAX_ASANA_LEAD_CANDIDATES = 5;
-const ASANA_SEARCH_DETAIL_LIMIT = 15;
-const NOTIFICATION_PAGE_LIMIT = 50;
-const getAllNotifications = async () => {
-    const notifications = [];
-    let cursor;
-    do {
-        const page = await api.budget.getNotifications.query({
-            cursor,
-            limit: NOTIFICATION_PAGE_LIMIT,
-        });
-        notifications.push(...page.notifications);
-        cursor = page.nextCursor;
-    } while (cursor);
-    return notifications;
-};
-const createApprovalEmailDeliveryReport = (delivery) => {
-    if (!delivery) {
-        return {
-            queued: false,
-            sent: false,
-            count: 0,
-            queuedCount: 0,
-            sentCount: 0,
-            skippedCount: 0,
-            error: "No approval email delivery was queued",
-        };
-    }
-    const { queuedCount, sentCount, skippedCount, message, operationIds } = delivery;
-    return {
-        queued: queuedCount > 0,
-        sent: false,
-        count: queuedCount,
-        queuedCount,
-        sentCount,
-        skippedCount,
-        operationIds,
-        message,
-    };
-};
-const createApprovalEmailDeliveryFailure = (error) => ({
-    queued: false,
-    sent: false,
-    count: 0,
-    queuedCount: 0,
-    sentCount: 0,
-    skippedCount: 0,
-    error,
-});
-function isPendingRequest(n) {
-    return n.notificationType === "request" && n.status === "PENDING_APPROVAL";
-}
-const out = (data) => {
-    emitCommandResult(data);
-};
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const stringField = (record, key) => {
-    const value = record[key];
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
-};
-const asanaSectionsForTask = (task) => {
-    if (!isRecord(task) || !Array.isArray(task.memberships))
-        return [];
-    return task.memberships.flatMap((membership) => {
-        if (!isRecord(membership) || !isRecord(membership.section))
-            return [];
-        return [
-            {
-                gid: stringField(membership.section, "gid"),
-                name: stringField(membership.section, "name"),
-            },
-        ];
-    });
-};
-const isWonOrLostAsanaTask = (task) => asanaSectionsForTask(task).some((section) => {
-    if (section.gid && ASANA_WON_LOST_SECTION_GIDS.has(section.gid)) {
-        return true;
-    }
-    const name = section.name?.trim().toLowerCase();
-    return Boolean(name && /\b(won|lost)\b/.test(name));
-});
-const asanaCandidateFromTask = (task, details) => {
-    const source = details ?? task;
-    const sourceRecord = isRecord(source) ? source : undefined;
-    const gid = (sourceRecord ? stringField(sourceRecord, "gid") : undefined) ?? task.gid;
-    const name = (sourceRecord ? stringField(sourceRecord, "name") : undefined) ??
-        task.name ??
-        gid;
-    if (!gid || isWonOrLostAsanaTask(source))
-        return null;
-    return {
-        gid,
-        name,
-        modifiedAt: (sourceRecord ? stringField(sourceRecord, "modified_at") : undefined) ??
-            task.modified_at,
-        createdAt: (sourceRecord ? stringField(sourceRecord, "created_at") : undefined) ??
-            task.created_at,
-        sections: asanaSectionsForTask(source),
-    };
-};
-const uniqueSearchQueries = (...queries) => {
-    const seen = new Set();
-    const unique = [];
-    for (const query of queries) {
-        const normalized = query?.trim() ?? "";
-        if (!normalized)
-            continue;
-        const key = normalized.toLowerCase();
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        unique.push(normalized);
-    }
-    return unique;
-};
-const searchOpenAsanaLeadCandidates = async ({ projectName, searchQuery, }) => {
-    const queries = uniqueSearchQueries(projectName, searchQuery);
-    const candidates = [];
-    const seenTaskIds = new Set();
-    for (const query of queries) {
-        const results = await api.asana.searchTasks.query({ query });
-        const tasks = results.data.slice(0, ASANA_SEARCH_DETAIL_LIMIT);
-        const detailsByTaskId = new Map();
-        await Promise.all(tasks.map(async (task) => {
-            if (!task.gid)
-                return;
-            try {
-                const details = await api.asana.getTaskById.query({ id: task.gid });
-                detailsByTaskId.set(task.gid, details.data);
-            }
-            catch {
-                // Keep the compact search result if detail lookup fails for one task.
-            }
-        }));
-        for (const task of tasks) {
-            if (!task.gid || seenTaskIds.has(task.gid))
-                continue;
-            const candidate = asanaCandidateFromTask(task, detailsByTaskId.get(task.gid));
-            if (!candidate)
-                continue;
-            seenTaskIds.add(candidate.gid);
-            candidates.push(candidate);
-            if (candidates.length >= MAX_ASANA_LEAD_CANDIDATES)
-                return candidates;
-        }
-    }
-    return candidates;
-};
-const formatAsanaCandidateMetadata = (candidate) => {
-    const sectionText = candidate.sections
-        .map((section) => section.name ?? section.gid)
-        .filter(Boolean)
-        .join(", ") || "stage unavailable";
-    const dateText = candidate.modifiedAt
-        ? `modified ${new Date(candidate.modifiedAt).toISOString()}`
-        : candidate.createdAt
-            ? `created ${new Date(candidate.createdAt).toISOString()}`
-            : "date unavailable";
-    return `${sectionText}; ${dateText}; ${candidate.gid}`;
-};
-const promptForAsanaLeadCandidate = async (candidates) => {
-    if (candidates.length === 0) {
-        throw new Error("No open Asana lead tasks were found in the Deals project. Pass --asanaTaskId explicitly or update the Deals project first.");
-    }
-    if (!process.stdin.isTTY || !process.stderr.isTTY) {
-        throw new Error("create-project requires --asanaTaskId in non-interactive runs. Interactive runs can omit it to choose from the top Asana lead task matches.");
-    }
-    console.error("Select the Asana lead task to link to this project:");
-    candidates.forEach((candidate, index) => {
-        console.error(`${index + 1}. ${candidate.name} (${formatAsanaCandidateMetadata(candidate)})`);
-    });
-    const rl = createInterface({
-        input: process.stdin,
-        output: process.stderr,
-    });
-    try {
-        while (true) {
-            const answer = await rl.question(`Choose 1-${candidates.length}, or q to abort: `);
-            const trimmed = answer.trim().toLowerCase();
-            if (trimmed === "q" || trimmed === "quit") {
-                throw new Error("Aborted.");
-            }
-            const selected = Number.parseInt(trimmed, 10);
-            if (Number.isInteger(selected) &&
-                selected >= 1 &&
-                selected <= candidates.length) {
-                const candidate = candidates[selected - 1];
-                if (candidate)
-                    return candidate;
-            }
-            console.error(`Enter a number from 1 to ${candidates.length}.`);
-        }
-    }
-    finally {
-        rl.close();
-    }
-};
-const resolveAsanaDealSlackChannel = async (asanaTaskId) => {
-    const result = await api.asana.getDealSlackChannel.query({ id: asanaTaskId });
-    if (result.status !== "resolved") {
-        throw new Error(result.message);
-    }
-    console.error(`Resolved Slack channel from Asana deal: #${result.channel.slackChannelName} (${result.channel.slackChannelId})`);
-    return result.channel;
-};
-const resolveCreateProjectLinks = async (opts) => {
-    const asanaTaskId = opts.asanaTaskId?.trim() ||
-        (await promptForAsanaLeadCandidate(await searchOpenAsanaLeadCandidates({
-            projectName: opts.name,
-            searchQuery: opts.asanaSearch,
-        }))).gid;
-    const hasCompleteManualSlackChannel = Boolean(opts.slackChannelId && opts.slackChannelUrl && opts.slackChannelName);
-    if (hasCompleteManualSlackChannel) {
-        return {
-            asanaTaskId,
-            slackChannelId: opts.slackChannelId,
-            slackChannelUrl: opts.slackChannelUrl,
-            slackChannelName: opts.slackChannelName,
-        };
-    }
-    const slackChannel = await resolveAsanaDealSlackChannel(asanaTaskId);
-    return {
-        asanaTaskId,
-        ...slackChannel,
-    };
-};
-const combineDateAndTime = (day, time) => {
-    const d = new Date(day);
-    d.setHours(time.getHours(), time.getMinutes(), time.getSeconds(), 0);
-    return d;
-};
-const formatOptionalProjectPaxInput = (pax) => {
-    if (typeof pax !== "number" || !Number.isFinite(pax) || pax <= 0) {
-        return "";
-    }
-    return String(pax);
-};
-/** Extension-based MIME, like browser `File.type` when the OS provides it */
-const contentTypeHeaderForFileName = (fileName) => {
-    const ct = contentType(fileName);
-    return typeof ct === "string" ? ct : "application/octet-stream";
-};
-const supportedAttachmentContentTypes = [
-    "application/pdf",
-    "image/gif",
-    "image/jpeg",
-    "image/png",
-    "image/webp",
-];
-const attachmentContentTypeForFileName = (fileName) => {
-    const resolvedContentType = contentTypeHeaderForFileName(fileName);
-    const supportedContentType = supportedAttachmentContentTypes.find((contentTypeValue) => contentTypeValue === resolvedContentType);
-    if (supportedContentType)
-        return supportedContentType;
-    throw new Error(`Unsupported attachment type: ${fileName}`);
-};
-const billAttachmentContentTypeForFileName = (fileName) => {
-    const resolvedContentType = attachmentContentTypeForFileName(fileName);
-    if (resolvedContentType === "image/webp") {
-        throw new Error(`Unsupported QuickBooks bill attachment type: ${fileName}. Use PDF, GIF, JPEG, or PNG.`);
-    }
-    return resolvedContentType;
-};
-const PAYMENT_PROOF_MAX_SIZE = 20 * 1024 * 1024;
-const QUOTATION_ATTACHMENT_MAX_SIZE = 20 * 1024 * 1024;
-const quotationAttachmentContentTypeForFileName = (fileName) => {
-    const resolvedContentType = contentTypeHeaderForFileName(fileName);
-    if (resolvedContentType === "application/pdf" ||
-        resolvedContentType === "image/jpeg" ||
-        resolvedContentType === "image/png") {
-        return resolvedContentType;
-    }
-    throw new Error(`Unsupported quotation attachment type: ${fileName}. Use PDF, JPEG, or PNG.`);
-};
-const LOCKED_BUDGET_STATUSES_REQUIRING_CONFIRMATION = new Set([
-    BudgetStatus.ESTIMATE_CREATED,
-    BudgetStatus.ESTIMATE_SENT,
-    BudgetStatus.ESTIMATE_ACCEPTED,
-    BudgetStatus.ESTIMATE_REJECTED,
-    BudgetStatus.ESTIMATE_CLOSED,
-]);
-const lockedBudgetStatusLabels = {
-    ESTIMATE_CREATED: "Estimate Created",
-    ESTIMATE_SENT: "Estimate Sent",
-    ESTIMATE_ACCEPTED: "Estimate Accepted",
-    ESTIMATE_REJECTED: "Estimate Rejected",
-    ESTIMATE_CLOSED: "Estimate Closed",
-};
-const lockedBudgetStatusLabel = (status) => status in lockedBudgetStatusLabels
-    ? lockedBudgetStatusLabels[status]
-    : status;
-export const buildSensitiveWorkflowPreview = ({ action, entity, details, }) => {
-    const effects = details ?? "may change workflow state or send notifications";
-    return [
-        "Budget Builder workflow preview",
-        `Action: ${action}`,
-        `Target: ${entity}`,
-        `Effects: ${effects}`,
-    ].join("\n");
-};
-const assertSensitiveWorkflowConfirmed = async (input) => {
-    if (getActiveCliSession()?.invocation.legacy !== true) {
-        await confirmCurrentCommand({
-            action: input.action,
-            target: input.entity,
-            details: input.details,
-        });
-        return;
-    }
-    const expected = "CONFIRM";
-    const preview = buildSensitiveWorkflowPreview(input);
-    if (!process.stdin.isTTY || !process.stderr.isTTY) {
-        throw new Error(`${preview}\nThis is a sensitive workflow change. Run it in an interactive terminal only after the user explicitly confirms this exact action, then type "${expected}" to continue.`);
-    }
-    const rl = createInterface({
-        input: process.stdin,
-        output: process.stderr,
-    });
-    try {
-        const answer = await rl.question(`${preview}\nConfirm the user explicitly approved this exact action, then type "${expected}" to continue: `);
-        if (answer.trim() !== expected) {
-            throw new Error("Aborted.");
-        }
-    }
-    finally {
-        rl.close();
-    }
-};
-const assertLockedBudgetChangeConfirmed = async ({ budget, action, }) => {
-    if (!LOCKED_BUDGET_STATUSES_REQUIRING_CONFIRMATION.has(budget.status)) {
-        return;
-    }
-    const statusLabel = lockedBudgetStatusLabel(budget.status);
-    if (getActiveCliSession()?.invocation.legacy !== true) {
-        await confirmCurrentCommand({
-            action,
-            target: `budget ${budget.id}`,
-            details: `Changes locked budget "${budget.name}" in status ${statusLabel}.`,
-            effects: ["state-change"],
-        });
-        return;
-    }
-    if (!process.stdin.isTTY || !process.stderr.isTTY) {
-        throw new Error(`${action} would change locked budget "${budget.name}" (${budget.id}) with status ${statusLabel}. Run this command in an interactive terminal and type "yes" to confirm.`);
-    }
-    const rl = createInterface({
-        input: process.stdin,
-        output: process.stderr,
-    });
-    try {
-        const answer = await rl.question(`${action} will change locked budget "${budget.name}" (${budget.id}) with status ${statusLabel}. Type "yes" to continue: `);
-        if (answer.trim().toLowerCase() !== "yes") {
-            throw new Error("Aborted.");
-        }
-    }
-    finally {
-        rl.close();
-    }
-};
-const confirmLockedBudgetChangeByBudgetId = async (budgetId, action) => {
-    const budget = await api.budget.getBudget.query({ id: budgetId });
-    await assertLockedBudgetChangeConfirmed({
-        budget: {
-            id: budget.id,
-            name: budget.name,
-            status: budget.status,
-        },
-        action,
-    });
-};
-const confirmLockedBudgetChangeByBudgetItemId = async (budgetItemId, action) => {
-    const { budget } = await api.budgetItem.getBudgetItemContext.query({
-        budgetItemId,
-    });
-    await assertLockedBudgetChangeConfirmed({ budget, action });
-};
-export async function listBudgets(opts) {
-    const input = {
-        projectId: opts.projectId,
-        name: opts.name,
-        statuses: opts.statuses,
-        createdBy: opts.createdBy,
-        dateFrom: opts.dateFrom,
-        dateTo: opts.dateTo,
-        sortBy: opts.sortBy,
-        sortDir: opts.sortDir,
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
-        includeDetails: opts.includeDetails ?? true,
-    };
-    const result = await api.budget.getAllBudgets.query(input);
-    out(result);
-}
-export async function getBudget(id) {
-    const [budget, items] = await Promise.all([
-        api.budget.getBudget.query({ id }),
-        api.budget.getBudgetItems.query({ budgetId: id }),
-    ]);
-    out({ budget, items });
-}
-export async function updateBudgetStatus(budgetId, status, opts) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Update budget status",
-        entity: `budget ${budgetId}`,
-        details: `to ${status}`,
-    });
-    await confirmLockedBudgetChangeByBudgetId(budgetId, "Update budget status");
-    const result = await api.budget.updateBudgetStatus.mutate({
-        id: budgetId,
-        status,
-        ...(opts?.projectManagerId !== undefined && {
-            projectManagerId: opts.projectManagerId,
-        }),
-        ...(opts?.markProjectWon !== undefined && {
-            markProjectWon: opts.markProjectWon,
-        }),
-        ...(opts?.projectStatusOnCommercialRejection !== undefined && {
-            projectStatusOnCommercialRejection: opts.projectStatusOnCommercialRejection,
-        }),
-        ...(opts?.projectInvoiceSettings !== undefined && {
-            projectInvoiceSettings: opts.projectInvoiceSettings,
-        }),
-    });
-    out(result);
-}
-const assertBudgetActionReadiness = async ({ budgetId, requireQuickbooksProject, actionLabel, }) => {
-    const budget = await api.budget.getBudget.query({ id: budgetId });
-    const hasNoItems = budget.budgetItems.length === 0;
-    if (hasNoItems) {
-        throw new Error(`Cannot ${actionLabel}: there are no line items in this budget.`);
-    }
-    const hasZeroCostItems = budget.budgetItems.some((item) => Number(item.cost ?? 0) === 0);
-    if (hasZeroCostItems) {
-        throw new Error(`Cannot ${actionLabel}: all line items must have a cost greater than zero.`);
-    }
-    const inactiveSuppliers = budget.budgetItems
-        .filter((item) => !item.supplier.active)
-        .map((item) => item.supplier.name);
-    const uniqueInactiveSuppliers = [...new Set(inactiveSuppliers)];
-    if (uniqueInactiveSuppliers.length > 0) {
-        throw new Error(`Cannot ${actionLabel}: inactive suppliers found (${uniqueInactiveSuppliers.join(", ")}).`);
-    }
-    if (requireQuickbooksProject && !budget.project.quickbooksProjectId) {
-        throw new Error("Cannot create estimate: project is not linked to QuickBooks yet.");
-    }
-};
-const runBudgetPreflight = async (budgetId, preflight) => {
-    if (!preflight)
-        return;
-    if (preflight.company) {
-        await api.company.updateCompany.mutate(preflight.company);
-    }
-    if (preflight.contactPerson) {
-        await api.contactPerson.updateContactPerson.mutate(preflight.contactPerson);
-    }
-    if (preflight.eventDetails) {
-        const budget = await api.budget.getBudget.query({ id: budgetId });
-        const project = await api.project.getProjectById.query({
-            id: budget.projectId,
-        });
-        const day = new Date(preflight.eventDetails.date);
-        const start = new Date(preflight.eventDetails.startTime);
-        const end = new Date(preflight.eventDetails.endTime);
-        const payload = {
-            id: project.id,
-            name: project.name,
-            description: project.description ?? undefined,
-            dateRange: {
-                from: combineDateAndTime(day, start),
-                to: combineDateAndTime(day, end),
-            },
-            companyId: project.companyId,
-            contactPersonId: project.contactPersonId,
-            asanaTaskId: project.asanaTaskId ?? "",
-            insideSalesId: project.insideSalesId ?? "",
-            businessDevelopmentId: project.businessDevelopmentId ?? "",
-            venue: project.venue ?? "",
-            pax: formatOptionalProjectPaxInput(project.pax),
-            ...(project.slackChannelId &&
-                project.slackChannelUrl &&
-                project.slackChannelName
-                ? {
-                    slackChannelId: project.slackChannelId,
-                    slackChannelUrl: project.slackChannelUrl,
-                    slackChannelName: project.slackChannelName,
-                }
-                : {}),
-        };
-        await api.project.updateProject.mutate(payload);
-    }
-};
-export async function listBills(opts) {
-    const input = {
-        projectId: opts.projectId,
-        budgetId: opts.budgetId,
-        statuses: billStatusesForApi(opts.statuses),
-        search: opts.search?.trim() || undefined,
-        isClaimable: opts.isClaimable,
-        createdByIds: opts.createdByIds && opts.createdByIds.length > 0
-            ? opts.createdByIds
-            : undefined,
-        sortBy: opts.sortBy,
-        sortDir: opts.sortDir,
-        page: opts.page ?? 1,
-        pageSize: opts.pageSize ?? 20,
-    };
-    const result = await api.bill.getAll.query(input);
-    out(result);
-}
-export async function approveBill(billId) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Approve bill",
-        entity: `bill ${billId}`,
-        details: "and send requester reply email",
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => isPendingRequest(n) &&
-        n.type === BILL &&
-        (n.billId === billId || n.bill?.id === billId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending bill approval found for this bill.");
-    }
-    const result = await api.bill.updateApproval.mutate({
-        billApprovalId: approval.id,
-        status: "APPROVED",
-    });
-    if (result.processing) {
-        out(result);
-        return;
-    }
-    let email;
-    try {
-        const delivery = result.emailDelivery;
-        email = createApprovalEmailDeliveryReport(delivery);
-    }
-    catch (error) {
-        email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function listApprovals(opts) {
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter(isPendingRequest);
-    const typeFilter = opts.type === undefined || opts.type === "ALL"
-        ? (_n) => true
-        : (n) => n.type === opts.type;
-    const filtered = pending
-        .filter(typeFilter)
-        .filter((n) => n.type !== BUDGET || !n.budget?.quickbooksEstimateId);
-    const items = filtered.map((n) => {
-        let id;
-        let name;
-        if (n.type === BUDGET && n.budget) {
-            id = n.budgetId ?? n.id;
-            name = n.budget.name;
-        }
-        else if (n.type === BILL && n.bill) {
-            id = n.bill.id;
-            name = `Bill ${n.bill.invoiceNumber ?? n.bill.id.slice(0, 8)}`;
-        }
-        else if (n.type === SUPPLIER && n.supplier) {
-            id = n.supplier.id;
-            name = n.supplier.name;
-        }
-        else if (n.type === QUOTATION && n.supplierQuotation) {
-            id = n.supplierQuotation.id;
-            name = `Quotation ${n.supplierQuotation.supplier.name}`;
-        }
-        else if (n.type === CUSTOMER_INVOICE && n.customerInvoiceBatch) {
-            id = n.customerInvoiceBatch.id;
-            name = `Customer invoice ${n.customerInvoiceBatch.project.name}`;
-        }
-        else {
-            id = n.id;
-            name = "Unknown";
-        }
-        return {
-            approvalId: n.id,
-            type: n.type,
-            id,
-            name,
-            requestedBy: n.requester?.name ?? n.requester?.email ?? "Unknown",
-            requestedAt: typeof n.createdAt === "string"
-                ? n.createdAt
-                : n.createdAt instanceof Date
-                    ? n.createdAt.toISOString()
-                    : String(n.createdAt),
-        };
-    });
-    out({ items });
-}
-export async function listSuppliers(opts) {
-    const result = await api.supplier.getSuppliers.query({
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 10,
-        sort: opts.sort ?? [{ id: "createdAt", desc: true }],
-        name: opts.name,
-        createdBy: opts.createdBy,
-        gstRegistered: opts.gstRegistered ?? null,
-        status: opts.status,
-        supplierTags: opts.supplierTags,
-        active: opts.active ?? true,
-    });
-    out(result);
-}
-// --- Bills (MCP parity) ---
-export async function createBillApproval(billId) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Create bill approval request",
-        entity: `bill ${billId}`,
-        details: "and send approval request emails",
-    });
-    const result = await api.bill.createApproval.mutate({ billId });
-    const approvalIds = (result.results ?? []).map((item) => ({ id: item.id }));
-    let email;
-    if (approvalIds.length === 0) {
-        email = createApprovalEmailDeliveryFailure("No approval ids returned");
-    }
-    else {
-        try {
-            const delivery = result.emailDelivery;
-            email = createApprovalEmailDeliveryReport(delivery);
-        }
-        catch (error) {
-            email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-        }
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export const validateBillStatusUpdateOptions = (opts) => {
-    if (opts.status === BillStatus.PAID && !opts.paymentReference?.trim()) {
-        throw new Error("update-bill-status requires --paymentReference when status is PAID.");
-    }
-    if (opts.status !== BillStatus.PAID && opts.paymentProofPath !== undefined) {
-        throw new Error("--paymentProof can only be used when status is PAID.");
-    }
-    if (opts.paymentProofPath !== undefined && !opts.paymentProofPath.trim()) {
-        throw new Error("--paymentProof requires a PDF file path.");
-    }
-};
-const deleteStagedPaymentProof = async (projectId, key) => {
-    const cleanup = await api.attachment.deleteStagedBillAttachments.mutate({
-        projectId,
-        keys: [key],
-    });
-    if (cleanup.failedKeys.includes(key)) {
-        throw new Error(`Failed to delete staged payment proof ${key}.`);
-    }
-};
-export const rethrowAfterStagedPaymentProofCleanup = async (error, cleanup) => {
-    if (cleanup) {
-        try {
-            await cleanup();
-        }
-        catch (cleanupError) {
-            throw new AggregateError([error, cleanupError], "Bill status update failed and its staged payment proof could not be cleaned up.");
-        }
-    }
-    throw error;
-};
-const stageBillPaymentProof = async (projectId, filePath) => {
-    const buffer = await readFile(filePath);
-    const fileName = basename(filePath);
-    const size = buffer.byteLength;
-    const contentType = billAttachmentContentTypeForFileName(fileName);
-    if (!fileName.toLowerCase().endsWith(".pdf") ||
-        contentType !== "application/pdf") {
-        throw new Error("Payment proof must be a PDF.");
-    }
-    if (size === 0) {
-        throw new Error("Payment proof must not be empty.");
-    }
-    if (size > PAYMENT_PROOF_MAX_SIZE) {
-        throw new Error("Payment proof must be 20MB or smaller.");
-    }
-    const { uploadUrl, key } = await api.attachment.requestStagedBillAttachmentUpload.mutate({
-        projectId,
-        fileName,
-        size,
-        contentType,
-    });
-    try {
-        const response = await fetch(uploadUrl, {
-            method: "PUT",
-            body: buffer,
-            headers: { "Content-Type": contentType },
-        });
-        if (!response.ok) {
-            throw new Error(`S3 upload failed: HTTP ${response.status} ${(await response.text()).slice(0, 500)}`);
-        }
-    }
-    catch (uploadError) {
-        try {
-            await deleteStagedPaymentProof(projectId, key);
-        }
-        catch (cleanupError) {
-            throw new AggregateError([uploadError, cleanupError], "Payment-proof upload failed and its staged object could not be cleaned up.");
-        }
-        throw uploadError;
-    }
-    return { id: randomUUID(), key, name: fileName, size };
-};
-export async function updateBillStatus(opts) {
-    validateBillStatusUpdateOptions(opts);
-    await assertSensitiveWorkflowConfirmed({
-        action: "Update bill status",
-        entity: `bill ${opts.id}`,
-        details: `to ${opts.status}`,
-    });
-    const bill = opts.paymentProofPath
-        ? await api.bill.getById.query({ id: opts.id })
-        : null;
-    const paymentProof = bill && opts.paymentProofPath
-        ? await stageBillPaymentProof(bill.projectId, opts.paymentProofPath)
-        : undefined;
-    try {
-        const result = await api.bill.updateStatus.mutate({
-            id: opts.id,
-            status: opts.status,
-            rejectionReason: opts.rejectionReason,
-            paymentTrackingUrl: opts.paymentTrackingUrl,
-            paymentReference: opts.paymentReference,
-            paymentProofAttachments: paymentProof ? [paymentProof] : undefined,
-        });
-        out(result);
-    }
-    catch (error) {
-        await rethrowAfterStagedPaymentProofCleanup(error, bill && paymentProof
-            ? async () => {
-                // The cleanup endpoint checks the staged-upload record and refuses to
-                // delete a key that an ambiguously successful update already consumed.
-                await deleteStagedPaymentProof(bill.projectId, paymentProof.key);
-            }
-            : undefined);
-    }
-}
-export async function patchBillPayment(opts) {
-    const input = { id: opts.id };
-    if (opts.paymentTrackingUrl !== undefined)
-        input.paymentTrackingUrl = opts.paymentTrackingUrl;
-    if (opts.paymentReference !== undefined)
-        input.paymentReference = opts.paymentReference;
-    if (opts.quickbooksBillId !== undefined)
-        input.quickbooksBillId = opts.quickbooksBillId;
-    if (opts.paymentDate !== undefined) {
-        input.paymentDate =
-            opts.paymentDate === null
-                ? null
-                : typeof opts.paymentDate === "string"
-                    ? new Date(opts.paymentDate)
-                    : opts.paymentDate;
-    }
-    const result = await api.bill.patchPayment.mutate(input);
-    out(result);
-}
-export async function patchBillInvoiceNumber(id, invoiceNumber) {
-    const result = await api.bill.patchInvoiceNumber.mutate({
-        id,
-        invoiceNumber,
-    });
-    out(result);
-}
-export async function getBillAttachments(id) {
-    const result = await api.bill.getAttachments.query({ id });
-    out(result);
-}
-export async function stageBillAttachmentsFromPaths(projectId, filePaths) {
-    const attachments = [];
-    for (const filePath of filePaths) {
-        const buffer = await readFile(filePath);
-        const fileName = basename(filePath);
-        const size = buffer.byteLength;
-        const contentType = billAttachmentContentTypeForFileName(fileName);
-        const { uploadUrl, key } = await api.attachment.requestStagedBillAttachmentUpload.mutate({
-            projectId,
-            fileName,
-            size,
-            contentType,
-        });
-        const response = await fetch(uploadUrl, {
-            method: "PUT",
-            body: buffer,
-            headers: { "Content-Type": contentType },
-        });
-        if (!response.ok) {
-            throw new Error(`S3 upload failed: HTTP ${response.status} ${(await response.text()).slice(0, 500)}`);
-        }
-        attachments.push({ id: randomUUID(), key, name: fileName, size });
-    }
-    out({
-        success: true,
-        projectId,
-        count: attachments.length,
-        attachments,
-    });
-}
-export const cleanupStagedBillAttachments = async (projectId, keys) => {
-    const result = await api.attachment.deleteStagedBillAttachments.mutate({
-        projectId,
-        keys,
-    });
-    out(result);
-};
-export async function uploadBillAttachmentFromPath(billId, filePath, type = "BILL") {
-    const confirmed = await uploadSingleBillAttachmentFromPath(billId, filePath, type);
-    out(confirmed);
-}
-const uploadSingleBillAttachmentFromPath = async (billId, filePath, type = "BILL") => {
-    const buf = await readFile(filePath);
-    const fileName = basename(filePath);
-    const size = buf.byteLength;
-    const attachmentContentType = billAttachmentContentTypeForFileName(fileName);
-    const { uploadUrl, key } = await api.attachment.requestBillAttachmentUpload.mutate({
-        billId,
-        contentType: attachmentContentType,
-        fileName,
-        size,
-    });
-    const res = await fetch(uploadUrl, {
-        method: "PUT",
-        body: buf,
-        headers: { "Content-Type": attachmentContentType },
-    });
-    if (!res.ok) {
-        throw new Error(`S3 upload failed: HTTP ${res.status} ${(await res.text()).slice(0, 500)}`);
-    }
-    return await api.attachment.confirmBillAttachment.mutate({
-        billId,
-        key,
-        name: fileName,
-        size,
-        type,
-    });
-};
-export async function uploadBillAttachmentsFromPaths(billId, filePaths, type = "BILL") {
-    if (filePaths.length === 0) {
-        throw new Error("At least one bill attachment file path is required");
-    }
-    const results = [];
-    for (const filePath of filePaths) {
-        results.push(await uploadSingleBillAttachmentFromPath(billId, filePath, type));
-    }
-    out({
-        success: true,
-        billId,
-        type,
-        count: results.length,
-        attachments: results.map((result) => result.attachment),
-        results,
-    });
-}
-export async function uploadBillDocumentsFromPaths({ billId, invoicePaths = [], paymentProofPaths = [], }) {
-    if (invoicePaths.length === 0 && paymentProofPaths.length === 0) {
-        throw new Error("At least one invoice or payment proof file path is required");
-    }
-    const invoiceResults = [];
-    for (const filePath of invoicePaths) {
-        invoiceResults.push(await uploadSingleBillAttachmentFromPath(billId, filePath, "BILL"));
-    }
-    const paymentProofResults = [];
-    for (const filePath of paymentProofPaths) {
-        paymentProofResults.push(await uploadSingleBillAttachmentFromPath(billId, filePath, "BILL_PAYMENT_PROOF"));
-    }
-    out({
-        success: true,
-        billId,
-        count: invoiceResults.length + paymentProofResults.length,
-        invoiceAttachments: invoiceResults.map((result) => result.attachment),
-        paymentProofAttachments: paymentProofResults.map((result) => result.attachment),
-        results: [...invoiceResults, ...paymentProofResults],
-    });
-}
-export async function uploadQuotationAttachmentFromPath(projectId, filePath) {
-    const buf = await readFile(filePath);
-    const fileName = basename(filePath);
-    if (buf.byteLength > QUOTATION_ATTACHMENT_MAX_SIZE) {
-        throw new Error("Quotation attachment must be 20MB or smaller.");
-    }
-    const attachmentContentType = quotationAttachmentContentTypeForFileName(fileName);
-    const ext = fileName
-        .split(".")
-        .pop()
-        ?.toLowerCase()
-        .replace(/[^a-z0-9]/g, "");
-    const key = `quotations/${projectId}/${randomUUID()}.${ext || "pdf"}`;
-    const uploadUrl = await api.attachment.getPresignedUrlToUpload.mutate({
-        key,
-        size: buf.byteLength,
-        contentType: attachmentContentType,
-    });
-    const res = await fetch(uploadUrl, {
-        method: "PUT",
-        body: buf,
-        headers: { "Content-Type": attachmentContentType },
-    });
-    if (!res.ok) {
-        throw new Error(`S3 upload failed: HTTP ${res.status} ${(await res.text()).slice(0, 500)}`);
-    }
-    out({
-        id: randomUUID(),
-        name: fileName,
-        key,
-        size: buf.byteLength,
-    });
-}
-export const cleanupStagedQuotationAttachments = async (projectId, keys) => {
-    const result = await api.quotation.deleteStagedAttachments.mutate({
-        projectId,
-        keys,
-    });
-    out(result);
-};
-export async function uploadBudgetAttachmentFromPath(budgetId, filePath) {
-    await confirmLockedBudgetChangeByBudgetId(budgetId, "Upload budget attachment");
-    const buf = await readFile(filePath);
-    const fileName = basename(filePath);
-    const size = buf.byteLength;
-    const attachmentContentType = attachmentContentTypeForFileName(fileName);
-    const { uploadUrl, key } = await api.attachment.requestBudgetAttachmentUpload.mutate({
-        budgetId,
-        contentType: attachmentContentType,
-        fileName,
-        size,
-    });
-    const res = await fetch(uploadUrl, {
-        method: "PUT",
-        body: buf,
-        headers: { "Content-Type": attachmentContentType },
-    });
-    if (!res.ok) {
-        throw new Error(`S3 upload failed: HTTP ${res.status} ${(await res.text()).slice(0, 500)}`);
-    }
-    const confirmed = await api.attachment.confirmBudgetAttachment.mutate({
-        budgetId,
-        key,
-        name: fileName,
-        size,
-    });
-    out(confirmed);
-}
-export async function uploadBudgetWinProofFromPath(budgetId, filePath, opts) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Mark budget won",
-        entity: `budget ${budgetId}`,
-        details: "by uploading proof and setting status to ESTIMATE_ACCEPTED",
-    });
-    await confirmLockedBudgetChangeByBudgetId(budgetId, "Mark budget won");
-    const buf = await readFile(filePath);
-    const fileName = basename(filePath);
-    const size = buf.byteLength;
-    const attachmentContentType = attachmentContentTypeForFileName(fileName);
-    const { uploadUrl, key } = await api.attachment.requestBudgetWinProofUpload.mutate({
-        budgetId,
-        contentType: attachmentContentType,
-        fileName,
-        size,
-    });
-    const res = await fetch(uploadUrl, {
-        method: "PUT",
-        body: buf,
-        headers: { "Content-Type": attachmentContentType },
-    });
-    if (!res.ok) {
-        throw new Error(`S3 upload failed: HTTP ${res.status} ${(await res.text()).slice(0, 500)}`);
-    }
-    await api.attachment.confirmBudgetWinProofAttachment.mutate({
-        budgetId,
-        key,
-        name: fileName,
-        size,
-    });
-    const result = await api.budget.updateBudgetStatus.mutate({
-        id: budgetId,
-        status: "ESTIMATE_ACCEPTED",
-        ...(opts?.projectManagerId !== undefined && {
-            projectManagerId: opts.projectManagerId,
-        }),
-        ...(opts?.markProjectWon !== undefined && {
-            markProjectWon: opts.markProjectWon,
-        }),
-        ...(opts?.projectInvoiceSettings !== undefined && {
-            projectInvoiceSettings: opts.projectInvoiceSettings,
-        }),
-    });
-    out(result);
-}
-export async function markBudgetWonWithProof(budgetId, filePath, opts) {
-    await uploadBudgetWinProofFromPath(budgetId, filePath, opts);
-}
-export async function getBillDetails(id) {
-    const result = await api.bill.getById.query({ id });
-    out(result);
-}
-// --- Budgets (MCP parity) ---
-export async function getBudgetItemsOnly(budgetId) {
-    const items = await api.budget.getBudgetItems.query({ budgetId });
-    out(items);
-}
-export async function addBudgetItems(opts) {
-    await confirmLockedBudgetChangeByBudgetId(opts.budgetId, "Add budget items");
-    const result = await api.budgetItem.addBudgetItems.mutate(opts);
-    out(result);
-}
-export async function updateBudgetItem(input) {
-    await confirmLockedBudgetChangeByBudgetItemId(input.id, "Update budget item");
-    const result = await api.budgetItem.updateBudgetItem.mutate({
-        ...input,
-        ...(input.description !== undefined &&
-            input.descriptionRichText === undefined && {
-            descriptionRichText: createRichTextFromPlainText(input.description),
-        }),
-        ...(input.note !== undefined &&
-            input.noteRichText === undefined && {
-            noteRichText: createRichTextFromPlainText(input.note),
-        }),
-    });
-    out(result);
-}
-export async function removeBudgetItem(budgetItemId) {
-    await confirmLockedBudgetChangeByBudgetItemId(budgetItemId, "Remove budget item");
-    const result = await api.budgetItem.removeBudgetItem.mutate({
-        budgetItemId,
-    });
-    out(result);
-}
-export const replaceBudgetItem = async (input) => {
-    await confirmLockedBudgetChangeByBudgetItemId(input.budgetItemId, "Replace unavailable budget item");
-    const result = await api.budgetItem.replaceBudgetItem.mutate(input);
-    out(result);
-};
-export const approveUnavailableItemException = async (input) => {
-    await confirmLockedBudgetChangeByBudgetItemId(input.budgetItemId, "Approve unavailable item exception");
-    const result = await api.budgetItem.approveUnavailableItemException.mutate(input);
-    out(result);
-};
-export async function getBudgetCategories() {
-    const categories = await api.budget.getBudgetCategories.query();
-    out(categories);
-}
-export async function getBudgetVersions(budgetId) {
-    const versions = await api.budgetVersion.getBudgetVersions.query({
-        budgetId,
-    });
-    out(versions);
-}
-export async function createBudgetApproval(budgetId, preflight) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Create budget approval request",
-        entity: `budget ${budgetId}`,
-        details: "and send approval request emails",
-    });
-    await confirmLockedBudgetChangeByBudgetId(budgetId, "Create budget approval");
-    await runBudgetPreflight(budgetId, preflight);
-    await assertBudgetActionReadiness({
-        budgetId,
-        requireQuickbooksProject: false,
-        actionLabel: "request approval",
-    });
-    const result = await api.budget.createBudgetApproval.mutate({ budgetId });
-    const approvalIds = (result.results ?? []).map((item) => ({ id: item.id }));
-    let email;
-    if (approvalIds.length === 0) {
-        email = createApprovalEmailDeliveryFailure("No approval ids returned");
-    }
-    else {
-        try {
-            const delivery = result.emailDelivery;
-            email = createApprovalEmailDeliveryReport(delivery);
-        }
-        catch (error) {
-            email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-        }
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function createEstimate(budgetId, preflight) {
-    await confirmLockedBudgetChangeByBudgetId(budgetId, "Create estimate");
-    await runBudgetPreflight(budgetId, preflight);
-    await assertBudgetActionReadiness({
-        budgetId,
-        requireQuickbooksProject: true,
-        actionLabel: "create estimate",
-    });
-    const result = await api.quickbooks.createEstimate.mutate({ budgetId });
-    out(result);
-}
-export const describeEstimateEmailConfirmation = (input) => `to ${input.to}; CC ${input.cc.length > 0 ? input.cc.join(", ") : "none"}; reply-to ${input.replyTo}; subject "${input.subject}"; queue durable worker delivery with the QBO estimate PDF, terms and conditions, and Budget Builder attachments; mark the estimate sent after provider acceptance`;
-export const sendEstimateToContactPersonFromPayload = async (raw) => {
-    const input = parseSendEstimateToContactPersonPayload(raw);
-    await assertSensitiveWorkflowConfirmed({
-        action: "Send estimate email",
-        entity: `budget ${input.budgetId}`,
-        details: describeEstimateEmailConfirmation(input),
-    });
-    const result = await api.email.sendEstimateToContactPerson.mutate(input);
-    out(result);
-};
-export async function getBudgetDetails(budgetId) {
-    const detail = await api.budget.getBudgetDetail.query({ id: budgetId });
-    out(detail);
-}
-export async function createBudgetFromPayload(raw) {
-    const input = parseCreateBudgetPayload(raw);
-    const result = await api.budget.createBudget.mutate(input);
-    out(result);
-}
-export async function updateBudgetFromPayload(raw) {
-    const input = parseUpdateBudgetPayload(raw);
-    await confirmLockedBudgetChangeByBudgetId(input.id, "Update budget");
-    const result = await api.budget.updateBudget.mutate(input);
-    out(result);
-}
-export async function deleteBudgetById(budgetId) {
-    await confirmLockedBudgetChangeByBudgetId(budgetId, "Delete budget");
-    const result = await api.budget.deleteBudget.mutate({ id: budgetId });
-    out(result);
-}
-export async function deleteProjectById(projectId) {
-    const result = await api.project.deleteProject.mutate({ id: projectId });
-    out(result);
-}
-export async function deleteCompanyById(companyId) {
-    const result = await api.company.deleteCompany.mutate({ id: companyId });
-    out(result);
-}
-export async function reorderBudgetItemsCli(opts) {
-    await confirmLockedBudgetChangeByBudgetId(opts.budgetId, "Reorder budget items");
-    const result = await api.budgetItem.reorderBudgetItems.mutate(opts);
-    out(result);
-}
-export async function updateBudgetItemSupplierCli(opts) {
-    await confirmLockedBudgetChangeByBudgetItemId(opts.budgetItemId, "Update budget item supplier");
-    const result = await api.budgetItem.updateBudgetItemSupplier.mutate(opts);
-    out(result);
-}
-export async function createBudgetCategory(name) {
-    const result = await api.budget.createBudgetCategory.mutate({ name });
-    out(result);
-}
-export async function updateBudgetCategory(opts) {
-    const result = await api.budget.updateBudgetCategory.mutate(opts);
-    out(result);
-}
-export async function deleteBudgetCategory(id) {
-    const result = await api.budget.deleteBudgetCategory.mutate({ id });
-    out(result);
-}
-export async function updateBudgetCommissionFromPayload(raw) {
-    const input = parseUpdateBudgetCommissionPayload(raw);
-    await confirmLockedBudgetChangeByBudgetId(input.budgetId, "Update budget commission");
-    const result = await api.budget.updateBudgetCommission.mutate(input);
-    out(result);
-}
-export async function updateBudgetDiscountFromPayload(raw) {
-    const input = parseBudgetDiscountPayload(raw);
-    await confirmLockedBudgetChangeByBudgetId(input.budgetId, "Update budget discount");
-    const result = await api.budget.updateBudgetDiscount.mutate(input);
-    out(result);
-}
-export const deleteBudgetDiscount = async (budgetId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Remove budget discount",
-        entity: `budget ${budgetId}`,
-        details: "and return the budget to DRAFT",
-    });
-    const result = await api.budget.deleteBudgetDiscount.mutate({ budgetId });
-    out(result);
-};
-export const deleteBudgetCommission = async (budgetId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Remove budget commission",
-        entity: `budget ${budgetId}`,
-        details: "and return the budget to DRAFT",
-    });
-    const result = await api.budget.deleteBudgetCommission.mutate({ budgetId });
-    out(result);
-};
-export const setBudgetItemsNotUtilized = async (budgetItemIds, notUtilized) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: notUtilized
-            ? "Mark budget lines Not Utilized"
-            : "Restore budget line",
-        entity: `budget item${budgetItemIds.length === 1 ? "" : "s"} ${budgetItemIds.join(", ")}`,
-        details: notUtilized
-            ? "and remove linked QuickBooks placeholder expenses"
-            : "and restore its QuickBooks placeholder expense when required",
-    });
-    const result = await api.budget.setBudgetItemsNotUtilized.mutate({
-        budgetItemIds,
-        notUtilized,
-    });
-    out(result);
-};
-export const createPlaceholderBillForBudgetItem = async (budgetItemId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Create QuickBooks placeholder bill",
-        entity: `budget item ${budgetItemId}`,
-    });
-    const result = await api.budget.createPlaceholderBillForBudgetItem.mutate({
-        budgetItemId,
-    });
-    out(result);
-};
-export const renameBudgetVersion = async (versionId, newName) => {
-    const result = await api.budgetVersion.renameBudgetVersion.mutate({
-        versionId,
-        newName,
-    });
-    out(result);
-};
-export const restoreBudgetVersion = async (versionId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Restore budget version",
-        entity: `budget version ${versionId}`,
-        details: "replace the current budget, project fields, items, and attachments, clear its QuickBooks estimate link, and return it to DRAFT",
-    });
-    const result = await api.budgetVersion.restoreBudgetVersion.mutate({
-        versionId,
-    });
-    out(result);
-};
-export async function deleteItemById(itemId) {
-    const result = await api.item.deleteItem.mutate({ id: itemId });
-    out(result);
-}
-export async function archiveItemsByIds(ids) {
-    const result = await api.item.archiveItems.mutate({ ids });
-    out(result);
-}
-export async function deleteSuppliersByIds(ids) {
-    const result = await api.supplier.deleteSuppliers.mutate({ ids });
-    out(result);
-}
-export async function reactivateSuppliersByIds(ids) {
-    const result = await api.supplier.reactivateSuppliers.mutate({ ids });
-    out(result);
-}
-export async function createSupplierCertification(name) {
-    const result = await api.supplier.createCertification.mutate({ name });
-    out(result);
-}
-export async function createSupplierPaymentMethod(name) {
-    const result = await api.supplier.createPaymentMethod.mutate({ name });
-    out(result);
-}
-export async function createSupplierRoleOption(name) {
-    const result = await api.supplier.createSupplierRole.mutate({ name });
-    out(result);
-}
-export async function createSupplierTagOption(name) {
-    const result = await api.supplier.createSupplierTag.mutate({ name });
-    out(result);
-}
-export async function createItemCategory(name) {
-    const result = await api.itemCategory.createItemCategory.mutate({ name });
-    out(result);
-}
-export async function updateItemCategory(opts) {
-    const result = await api.itemCategory.updateItemCategory.mutate(opts);
-    out(result);
-}
-export async function deleteItemCategoriesByIds(ids) {
-    const result = await api.itemCategory.deleteItemCategories.mutate({ ids });
-    out(result);
-}
-export async function createBillFromPayload(raw) {
-    const input = parseCreateBillPayload(raw);
-    const result = await api.bill.create.mutate(input);
-    out(result);
-}
-export async function listQuotations(opts) {
-    const result = await api.quotation.list.query(opts);
-    out(result);
-}
-export async function getQuotationDetails(id) {
-    const result = await api.quotation.getById.query({ id });
-    out(result);
-}
-export async function createQuotationFromPayload(raw) {
-    const input = parseCreateQuotationPayload(raw);
-    const result = await api.quotation.createDraft.mutate(input);
-    out(result);
-}
-export const updateQuotationFromPayload = async (raw) => {
-    const input = parseUpdateQuotationPayload(raw);
-    const result = await api.quotation.updateDraftOrRejected.mutate(input);
-    out(result);
-};
-export const deleteQuotationById = async (id) => {
-    const result = await api.quotation.delete.mutate({ id });
-    out(result);
-};
-export async function submitQuotation(id) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Submit quotation for approval",
-        entity: `quotation ${id}`,
-    });
-    const result = await api.quotation.submitForApproval.mutate({ id });
-    out(result);
-}
-export async function downloadQuotationPdf(id, fileRole) {
-    const result = await api.quotation.getSignedDownloadUrl.query({
-        id,
-        fileRole,
-    });
-    out(result);
-}
-export const checkCustomerInvoiceReadiness = async (budgetId) => {
-    const result = await api.customerInvoice.getInvoiceReadiness.query({
-        budgetId,
-    });
-    out(result);
-};
-export const listCustomerInvoices = async (input) => {
-    const result = await api.customerInvoice.list.query(input);
-    out(result);
-};
-export const listEligibleCustomerInvoiceBudgets = async (projectId) => {
-    const result = await api.customerInvoice.getEligibleBudgets.query({
-        projectId,
-    });
-    out(result);
-};
-export const getCustomerInvoice = async (batchId) => {
-    const result = await api.customerInvoice.getInvoiceDetail.query({ batchId });
-    out(result);
-};
-export const getCustomerInvoiceEmailContext = async (batchId) => {
-    const result = await api.customerInvoice.getInvoiceEmailContext.query({
-        batchId,
-    });
-    out(result);
-};
-export const createCustomerInvoice = async (raw) => {
-    const input = parseCreateCustomerInvoicePayload(raw);
-    await assertSensitiveWorkflowConfirmed({
-        action: "Create customer invoice",
-        entity: `budget ${input.budgetId}`,
-        details: "creates one invoice in QuickBooks; admin-created invoices are approved immediately, while other invoices request approval; approved cumulative coverage of 100% closes the QuickBooks estimate",
-    });
-    const result = await api.customerInvoice.createInvoiceBatch.mutate(input);
-    out(result);
-};
-export const discardCreatingCustomerInvoice = async (batchId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Discard unfinished customer invoice",
-        entity: `invoice batch ${batchId}`,
-        details: "removes only a reserved CREATING batch that has no invoice created in QuickBooks",
-    });
-    const result = await api.customerInvoice.discardCreatingInvoiceBatch.mutate({
-        batchId,
-    });
-    out(result);
-};
-export const deleteCustomerInvoice = async (batchId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Delete customer invoice",
-        entity: `invoice batch ${batchId}`,
-        details: "deletes its invoices from QuickBooks and removes the local batch; paid invoices are blocked until their QBO payments are reversed; removing approved coverage may reopen the estimate",
-    });
-    const result = await api.customerInvoice.deleteInvoiceBatch.mutate({
-        batchId,
-    });
-    out(result);
-};
-export const voidCustomerInvoice = async (batchId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Void customer invoice",
-        entity: `invoice batch ${batchId}`,
-        details: "voids its invoices in QuickBooks and updates Budget Builder; paid invoices are blocked until their QBO payments are reversed; removing approved coverage may reopen the estimate",
-    });
-    const result = await api.customerInvoice.voidInvoiceBatch.mutate({ batchId });
-    out(result);
-};
-export const approveCustomerInvoice = async (batchId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Approve customer invoice",
-        entity: `invoice batch ${batchId}`,
-        details: "approves the batch and notifies its creator; voided invoices cannot be approved; cumulative approved coverage of 100% closes the QuickBooks estimate",
-    });
-    const result = await api.customerInvoice.approveInvoiceBatch.mutate({
-        batchId,
-    });
-    out(result);
-};
-export const rejectCustomerInvoice = async (batchId, rejectionReason) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Reject customer invoice",
-        entity: `invoice batch ${batchId}`,
-        details: `records the rejection reason, voids it in QuickBooks, notifies its creator, and reopens a prematurely closed estimate when applicable`,
-    });
-    const result = await api.customerInvoice.rejectInvoiceBatch.mutate({
-        batchId,
-        rejectionReason,
-    });
-    out(result);
-};
-export const downloadCustomerInvoicePdf = async (invoiceId, outputPath) => {
-    const result = await api.customerInvoice.downloadPdf.mutate({ invoiceId });
-    const resolvedOutputPath = outputPath?.trim() || result.fileName;
-    const contents = Buffer.from(result.base64, "base64");
-    await writeFile(resolvedOutputPath, contents);
-    out({
-        contentType: result.contentType,
-        fileName: result.fileName,
-        outputPath: resolvedOutputPath,
-        size: contents.byteLength,
-    });
-};
-export const syncCustomerInvoice = async (invoiceId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Sync customer invoice from QuickBooks",
-        entity: `invoice ${invoiceId}`,
-        details: "refreshes local status, QuickBooks metadata, balance, and history; QBO Paid or a zero balance becomes PAID, a reversed payment restores the delivery or approval status, and a QBO void becomes VOIDED",
-    });
-    const result = await api.customerInvoice.syncInvoiceStatus.mutate({
-        invoiceId,
-    });
-    out(result);
-};
-export const describeCustomerInvoiceEmailConfirmation = (input) => `emails the QBO invoice PDF to ${input.to} and saves that address as the project's billing email; requested CC ${input.cc.length > 0 ? input.cc.join(", ") : "none"}; reply-to ${input.replyTo}; subject "${input.subject}"; server-required admin, creator, business-development, and inside-sales CC recipients are added; success marks the invoice SENT; do not retry blindly after an ambiguous delivery failure`;
-export const sendCustomerInvoiceToContactPersonFromPayload = async (raw) => {
-    const input = parseSendCustomerInvoiceToContactPersonPayload(raw);
-    await assertSensitiveWorkflowConfirmed({
-        action: "Send customer invoice email",
-        entity: `invoice ${input.invoiceId}`,
-        details: describeCustomerInvoiceEmailConfirmation(input),
-    });
-    const result = await api.customerInvoice.sendInvoiceToContactPerson.mutate(input);
-    out(result);
-};
-export async function updateBillFromPayload(raw) {
-    const input = parseUpdateBillPayload(raw);
-    const result = await api.bill.update.mutate(input);
-    out(result);
-}
-export const validateBillSelectionFromPayload = async (raw) => {
-    const input = parseValidateBillSelectionPayload(raw);
-    const result = await api.bill.validateSelection.mutate(input);
-    out(result);
-};
-export const updateBillPaymentEvidenceFromPayload = async (raw) => {
-    const input = parseUpdateBillPaymentEvidencePayload(raw);
-    const result = await api.bill.updatePaymentEvidence.mutate(input);
-    out(result);
-};
-export async function deleteBillById(id) {
-    const result = await api.bill.delete.mutate({ id });
-    out(result);
-}
-export async function createSupplierFromPayload(raw) {
-    const input = parseSupplierCreatePayload(raw);
-    const created = await api.supplier.createSupplier.mutate(input);
-    const supplier = created.result;
-    if (supplier.status !== "PENDING_APPROVAL") {
-        out(created);
-        return;
-    }
-    await assertSensitiveWorkflowConfirmed({
-        action: "Create supplier approval request",
-        entity: `supplier ${supplier.id}`,
-        details: "and send approval request emails",
-    });
-    const approval = await api.supplier.createSupplierApproval.mutate({
-        supplierId: supplier.id,
-    });
-    let emailResult;
-    const approvalIds = (approval.results ?? []).map((item) => ({ id: item.id }));
-    if (approvalIds.length === 0) {
-        emailResult = createApprovalEmailDeliveryFailure("No approval ids returned");
-    }
-    else {
-        try {
-            const delivery = approval.emailDelivery;
-            emailResult = createApprovalEmailDeliveryReport(delivery);
-        }
-        catch (error) {
-            emailResult = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-        }
-    }
-    out({
-        ...created,
-        supplierApproval: {
-            requested: true,
-            approvalCount: approvalIds.length,
-            email: emailResult,
-        },
-    });
-}
-export async function updateSupplierFromPayload(raw) {
-    const input = parseSupplierUpdatePayload(raw);
-    const updated = await api.supplier.updateSupplier.mutate(input);
-    const supplier = updated.result;
-    if (supplier.status !== "PENDING_APPROVAL") {
-        out(updated);
-        return;
-    }
-    await assertSensitiveWorkflowConfirmed({
-        action: "Create supplier approval request",
-        entity: `supplier ${supplier.id}`,
-        details: "and send approval request emails",
-    });
-    let approvalResult;
-    try {
-        const approval = await api.supplier.createSupplierApproval.mutate({
-            supplierId: supplier.id,
-        });
-        const approvalIds = (approval.results ?? []).map((item) => ({
-            id: item.id,
-        }));
-        if (approvalIds.length === 0) {
-            approvalResult = {
-                requested: true,
-                approvalCount: 0,
-                email: createApprovalEmailDeliveryFailure("No approval ids returned"),
-            };
-        }
-        else {
-            try {
-                const delivery = approval.emailDelivery;
-                approvalResult = {
-                    requested: true,
-                    approvalCount: approvalIds.length,
-                    email: createApprovalEmailDeliveryReport(delivery),
-                };
-            }
-            catch (error) {
-                approvalResult = {
-                    requested: true,
-                    approvalCount: approvalIds.length,
-                    email: createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error)),
-                };
-            }
-        }
-    }
-    catch (error) {
-        approvalResult = {
-            requested: false,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-    out({
-        ...updated,
-        supplierApproval: approvalResult,
-    });
-}
-export async function createItemFromPayload(raw) {
-    const input = parseItemCreatePayload(raw);
-    const result = await api.item.createItem.mutate(input);
-    out(result);
-}
-export async function updateItemFromPayload(raw) {
-    const input = parseItemUpdatePayload(raw);
-    const result = await api.item.updateItem.mutate(input);
-    out(result);
-}
-export async function createContactPersonFromPayload(raw) {
-    const input = parseContactCreatePayload(raw);
-    const result = await api.contactPerson.createContactPerson.mutate(input);
-    out(result);
-}
-export async function updateContactPersonFromPayload(raw) {
-    const input = parseContactUpdatePayload(raw);
-    const result = await api.contactPerson.updateContactPerson.mutate(input);
-    out(result);
-}
-export async function updateProjectFromPayload(raw) {
-    const input = parseUpdateProjectPayload(raw);
-    const result = await api.project.updateProject.mutate(input);
-    out(result);
-}
-export async function updateCompanyFromPayload(raw) {
-    const input = parseCompanyUpdatePayload(raw);
-    const result = await api.company.updateCompany.mutate(input);
-    out(result);
-}
-// --- Approvals: budgets / suppliers / bills (MCP parity) ---
-export async function approveBudget(budgetId) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Approve budget",
-        entity: `budget ${budgetId}`,
-        details: "and send requester reply email",
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => n.notificationType === "request" &&
-        n.status === ExtendedApprovalStatus.PENDING_APPROVAL &&
-        n.type === ExtendedApprovalType.BUDGET &&
-        (n.budgetId === budgetId ||
-            n.budget?.id === budgetId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending budget approval found for this budget and approver.");
-    }
-    const result = await api.budget.updateBudgetApproval.mutate({
-        budgetApprovalId: approval.id,
-        status: ExtendedApprovalStatus.APPROVED,
-    });
-    let email;
-    try {
-        const delivery = result.emailDelivery;
-        email = createApprovalEmailDeliveryReport(delivery);
-    }
-    catch (error) {
-        email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function rejectBudget(budgetId, reason) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Reject budget",
-        entity: `budget ${budgetId}`,
-        details: `with reason "${reason}" and send requester reply email`,
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => n.notificationType === "request" &&
-        n.status === ExtendedApprovalStatus.PENDING_APPROVAL &&
-        n.type === ExtendedApprovalType.BUDGET &&
-        (n.budgetId === budgetId ||
-            n.budget?.id === budgetId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending budget approval found for this budget and approver.");
-    }
-    const result = await api.budget.updateBudgetApproval.mutate({
-        budgetApprovalId: approval.id,
-        status: ExtendedApprovalStatus.REJECTED,
-        rejectionReason: reason,
-    });
-    let email;
-    try {
-        const delivery = result.emailDelivery;
-        email = createApprovalEmailDeliveryReport(delivery);
-    }
-    catch (error) {
-        email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function getSupplierDetails(supplierId) {
-    const supplier = await api.supplier.getSupplierById.query({
-        id: supplierId,
-    });
-    const respondedStatuses = new Set([
-        ExtendedApprovalStatus.APPROVED,
-        ExtendedApprovalStatus.REJECTED,
-    ]);
-    const latestRespondedApproval = [
-        ...supplier.approvals.filter((approval) => respondedStatuses.has(approval.status)),
-    ].sort((a, b) => new Date(b.respondedAt ?? b.updatedAt).getTime() -
-        new Date(a.respondedAt ?? a.updatedAt).getTime() ||
-        new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())[0];
-    const pendingApprovals = supplier.approvals.filter((approval) => approval.status === ExtendedApprovalStatus.PENDING_APPROVAL);
-    const supersededApprovals = supplier.approvals.filter((approval) => approval.status === ExtendedApprovalStatus.SUPERSEDED);
-    const respondedByApproval = latestRespondedApproval ?? null;
-    const responseUser = respondedByApproval
-        ? (respondedByApproval.responder ?? respondedByApproval.approver)
-        : null;
-    out({
-        ...supplier,
-        supplierApprovalSummary: {
-            pendingApprovalCount: pendingApprovals.length,
-            pendingApprovers: pendingApprovals.map((approval) => ({
-                approvalId: approval.id,
-                approverId: approval.approverId,
-                name: approval.approver.name,
-                email: approval.approver.email,
-                createdAt: approval.createdAt,
-                updatedAt: approval.updatedAt,
-            })),
-            supersededApprovalCount: supersededApprovals.length,
-            supersededApprovers: supersededApprovals.map((approval) => ({
-                approvalId: approval.id,
-                approverId: approval.approverId,
-                name: approval.approver.name,
-                email: approval.approver.email,
-                respondedAt: approval.respondedAt,
-                responder: approval.responder
-                    ? {
-                        id: approval.responder.id,
-                        name: approval.responder.name,
-                        email: approval.responder.email,
-                    }
-                    : null,
-            })),
-            respondedBy: respondedByApproval && responseUser
-                ? {
-                    approvalId: respondedByApproval.id,
-                    status: respondedByApproval.status,
-                    approverId: respondedByApproval.approverId,
-                    responderId: respondedByApproval.responderId,
-                    name: responseUser.name,
-                    email: responseUser.email,
-                    respondedAt: respondedByApproval.respondedAt,
-                    updatedAt: respondedByApproval.updatedAt,
-                }
-                : null,
-        },
-    });
-}
-export async function approveSupplier(supplierId) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Approve supplier",
-        entity: `supplier ${supplierId}`,
-        details: "and send requester reply email",
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => n.notificationType === "request" &&
-        n.status === ExtendedApprovalStatus.PENDING_APPROVAL &&
-        n.type === ExtendedApprovalType.SUPPLIER &&
-        (n.supplierId === supplierId || n.supplier?.id === supplierId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending supplier approval found.");
-    }
-    const result = await api.supplier.updateSupplierApproval.mutate({
-        supplierApprovalId: approval.id,
-        status: ExtendedApprovalStatus.APPROVED,
-    });
-    let email;
-    try {
-        const delivery = result.emailDelivery;
-        email = createApprovalEmailDeliveryReport(delivery);
-    }
-    catch (error) {
-        email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function rejectSupplier(supplierId, reason) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Reject supplier",
-        entity: `supplier ${supplierId}`,
-        details: `with reason "${reason}" and send requester reply email`,
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => n.notificationType === "request" &&
-        n.status === ExtendedApprovalStatus.PENDING_APPROVAL &&
-        n.type === ExtendedApprovalType.SUPPLIER &&
-        (n.supplierId === supplierId || n.supplier?.id === supplierId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending supplier approval found.");
-    }
-    const result = await api.supplier.updateSupplierApproval.mutate({
-        supplierApprovalId: approval.id,
-        status: ExtendedApprovalStatus.REJECTED,
-        rejectionReason: reason,
-    });
-    let email;
-    try {
-        const delivery = result.emailDelivery;
-        email = createApprovalEmailDeliveryReport(delivery);
-    }
-    catch (error) {
-        email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function rejectBill(billId, reason) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Reject bill",
-        entity: `bill ${billId}`,
-        details: `with reason "${reason}" and send requester reply email`,
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => n.notificationType === "request" &&
-        n.status === ExtendedApprovalStatus.PENDING_APPROVAL &&
-        n.type === ExtendedApprovalType.BILL &&
-        (n.billId === billId || n.bill?.id === billId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending bill approval found.");
-    }
-    const result = await api.bill.updateApproval.mutate({
-        billApprovalId: approval.id,
-        status: ExtendedApprovalStatus.REJECTED,
-        rejectionReason: reason,
-    });
-    if (result.processing) {
-        out(result);
-        return;
-    }
-    let email;
-    try {
-        const delivery = result.emailDelivery;
-        email = createApprovalEmailDeliveryReport(delivery);
-    }
-    catch (error) {
-        email = createApprovalEmailDeliveryFailure(error instanceof Error ? error.message : String(error));
-    }
-    out({
-        ...result,
-        email,
-    });
-}
-export async function approveQuotation(quotationId) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Approve quotation",
-        entity: `quotation ${quotationId}`,
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => isPendingRequest(n) &&
-        n.type === QUOTATION &&
-        (n.supplierQuotationId === quotationId ||
-            n.supplierQuotation?.id === quotationId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending quotation approval found.");
-    }
-    const result = await api.quotation.approve.mutate({
-        quotationApprovalId: approval.id,
-    });
-    out(result);
-}
-export async function rejectQuotation(quotationId, reason) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Reject quotation",
-        entity: `quotation ${quotationId}`,
-        details: `with reason "${reason}"`,
-    });
-    const notifications = await getAllNotifications();
-    const pending = notifications.filter((n) => isPendingRequest(n) &&
-        n.type === QUOTATION &&
-        (n.supplierQuotationId === quotationId ||
-            n.supplierQuotation?.id === quotationId));
-    const approval = pending[0];
-    if (!approval) {
-        throw new Error("No pending quotation approval found.");
-    }
-    const result = await api.quotation.reject.mutate({
-        quotationApprovalId: approval.id,
-        rejectionReason: reason,
-    });
-    out(result);
-}
-// --- Companies & projects ---
-export async function listCompanies(opts) {
-    const result = await api.company.getCompanies.query({
-        name: opts.name,
-        createdBy: opts.createdBy,
-        active: opts.active,
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
-    });
-    out(result);
-}
-export async function getCompany(id) {
-    const company = await api.company.getCompanyById.query({ id });
-    out(company);
-}
-export async function createCompany(opts) {
-    const result = await api.company.createCompany.mutate(opts);
-    out(result);
-}
-export async function listProjects(opts) {
-    const result = await api.project.getAllProjects.query({
-        companyId: opts.companyId,
-        name: opts.name,
-        status: opts.status,
-        active: opts.active,
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
-    });
-    out(result);
-}
-export const listProjectHubs = async (opts) => {
-    const result = await api.project.getAllProjectHubs.query({
-        ...opts,
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
-    });
-    out(result);
-};
-export async function getProject(id) {
-    const [project, budgetsOverview, billsOverview] = await Promise.all([
-        api.project.getProjectDetailsById.query({ id }),
-        api.project.getProjectBudgetsOverview.query({ projectId: id }),
-        api.project.getProjectBillsOverview.query({ projectId: id }),
-    ]);
-    out({ project, budgetsOverview, billsOverview });
-}
-export const getProjectHubStatus = async (projectId) => {
-    const result = await api.project.getProjectHubShareLink.query({ projectId });
-    out(result);
-};
-export const setupProjectHub = async (projectId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Set up Project Hub",
-        entity: `project ${projectId}`,
-        details: "queue Asana, Drive, and client Hub provisioning",
-    });
-    const result = await api.project.setupProjectHub.mutate({ projectId });
-    out(result);
-};
-export const syncProjectHubCommercialDocuments = async (projectId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Sync Project Hub commercial documents",
-        entity: `project ${projectId}`,
-        details: "queue a full Budget Builder to Google Drive and Asana reconciliation",
-    });
-    const result = await api.project.syncProjectHubCommercialDocuments.mutate({
-        projectId,
-    });
-    out(result);
-};
-export async function createProject(opts) {
-    const links = await resolveCreateProjectLinks({
-        name: opts.name,
-        asanaTaskId: opts.asanaTaskId,
-        asanaSearch: opts.asanaSearch,
-        slackChannelId: opts.slackChannelId,
-        slackChannelUrl: opts.slackChannelUrl,
-        slackChannelName: opts.slackChannelName,
-    });
-    const result = await api.project.createProject.mutate({
-        name: opts.name,
-        description: opts.description,
-        companyId: opts.companyId,
-        contactPersonId: opts.contactPersonId,
-        insideSalesId: opts.insideSalesId,
-        businessDevelopmentId: opts.businessDevelopmentId,
-        projectManagerId: opts.projectManagerId,
-        venue: opts.venue,
-        pax: opts.pax,
-        asanaTaskId: links.asanaTaskId,
-        slackChannelId: links.slackChannelId,
-        slackChannelUrl: links.slackChannelUrl,
-        slackChannelName: links.slackChannelName,
-        dateRange: {
-            from: new Date(opts.startDate),
-            to: opts.endDate ? new Date(opts.endDate) : undefined,
-        },
-    });
-    out(result);
-}
-export async function updateProjectStatus(id, status, opts) {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Update project status",
-        entity: `project ${id}`,
-        details: `to ${status}`,
-    });
-    const result = await api.project.updateProjectStatus.mutate({
-        id,
-        status,
-        ...(opts?.projectManagerId && { projectManagerId: opts.projectManagerId }),
-        ...(opts?.projectManagerEmail && {
-            projectManagerEmail: opts.projectManagerEmail,
-        }),
-        ...(opts?.wonOverrideReason && {
-            wonOverrideReason: opts.wonOverrideReason,
-        }),
-    });
-    out(result);
-}
-export const checkProjectReconciliation = async (projectId) => {
-    const result = await api.project.getReconciliationReview.query({ projectId });
-    out(result);
-};
-export const reconcileProject = async (projectId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: "Reconcile project",
-        entity: `project ${projectId}`,
-        details: "rerun all reconciliation checks and mark it RECONCILED",
-    });
-    const result = await api.project.reconcile.mutate({ projectId });
-    out(result);
-};
-export const completeProject = async (projectId) => {
-    await updateProjectStatus(projectId, ProjectStatus.COMPLETED);
-};
-export const importQuickBooksProjectId = async (projectId, projectUrl) => {
-    const result = await api.project.importQboProjectId.mutate({
-        projectId,
-        projectUrl,
-    });
-    out(result);
-};
-export const listIntegrationOperations = async (input) => {
-    const result = await api.integration.listOperations.query(input);
-    out(result);
-};
-export const retryIntegrationOperation = async (operationId, confirmExternalStateReconciled, outboundEmailResolution, providerMessageId) => {
-    await assertSensitiveWorkflowConfirmed({
-        action: outboundEmailResolution === "ACCEPTED"
-            ? "Reconcile integration operation as completed"
-            : "Retry integration operation",
-        entity: `operation ${operationId}`,
-        details: outboundEmailResolution === "ACCEPTED"
-            ? `mark provider-accepted email sent with message ID ${providerMessageId ?? "<missing>"}`
-            : outboundEmailResolution === "NOT_ACCEPTED_RETRY"
-                ? "rotate the Resend idempotency key and retry provider delivery"
-                : confirmExternalStateReconciled
-                    ? "after confirming the external state has been reconciled"
-                    : undefined,
-    });
-    const result = await api.integration.retryOperation.mutate({
-        operationId,
-        confirmExternalStateReconciled,
-        outboundEmailResolution,
-        providerMessageId,
-    });
-    out(result);
-};
-// --- Typeform inbound administration ---
-export const listInboundSources = async (input) => {
-    const result = await api.inbound.listSources.query(input);
-    out(result);
-};
-export const createInboundSource = async (input) => {
-    const result = await api.inbound.createSource.mutate(input);
-    out(result);
-};
-export const getInboundSource = async (sourceId) => {
-    const result = await api.inbound.getSource.query({ sourceId });
-    out(result);
-};
-export const updateInboundSource = async (sourceId, name) => {
-    const result = await api.inbound.updateSource.mutate({ name, sourceId });
-    out(result);
-};
-export const listInboundSubmissions = async (input) => {
-    const result = await api.inbound.listSubmissions.query(input);
-    out(result);
-};
-export const getInboundSubmission = async (submissionId) => {
-    const result = await api.inbound.getSubmission.query({ submissionId });
-    out(result);
-};
-export const saveInboundMappingVersion = async (sourceId, mappings) => {
-    const source = await api.inbound.getSource.query({ sourceId });
-    const result = await api.inbound.saveMappingVersion.mutate({
-        expectedActiveMappingVersion: source.activeMappingVersion,
-        mappings,
-        sourceId,
-    });
-    out(result);
-};
-export const saveInboundAutomationConfig = async (input) => {
-    const result = await api.inbound.saveAutomationConfig.mutate(input);
-    out(result);
-};
-export const updateInboundProcessing = async (input) => {
-    const result = await api.inbound.updateProcessing.mutate(input);
-    out(result);
-};
-// --- Contacts ---
-export async function listContacts(companyId) {
-    const contacts = await api.contactPerson.getContactPersonByCompanyId.query({
-        companyId,
-    });
-    out(contacts);
-}
-// --- Items ---
-export async function listItems(opts) {
-    const result = await api.item.getItems.query({
-        includeQuickBooksDeactivationPending: opts.includeQuickBooksDeactivationPending,
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
-        name: opts.name,
-    });
-    out(result);
-}
-export async function getItem(id) {
-    const item = await api.item.getItem.query({ id });
-    out(item);
-}
-export async function listItemCategories(opts) {
-    const result = await api.itemCategory.getItemCategories.query({
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 50,
-    });
-    out(result);
-}
-// --- Supplier analytics ---
-export async function getSupplierAnalytics(opts) {
-    const result = await api.dashboard.getSupplierTableData.query({
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
-        sort: [],
-        name: opts.name,
-        timeFrame: (opts.timeFrame ?? "ALL"),
-    });
-    out(result);
-}
-// --- Dashboard / analytics ---
-export async function createUser(input) {
-    const user = await api.user.create.mutate(input);
-    out(user);
-}
-export async function createApiKeyForUser(input) {
-    const apiKey = await api.mcpApiKey.create.mutate(input);
-    out(apiKey);
-}
-export async function listApiKeysForUser(input) {
-    const apiKeys = await api.mcpApiKey.list.query(input);
-    out(apiKeys);
-}
-export async function revokeApiKeyForUser(input) {
-    const result = await api.mcpApiKey.revoke.mutate(input);
-    out(result);
-}
-export async function listUsers() {
-    const users = await api.user.getAllUsers.query();
-    out(users);
-}
-export async function whoAmI() {
-    const user = await api.user.getCurrentUser.query();
-    out(user);
-}
-export async function getUserPerformance(userId) {
-    const result = await api.dashboard.getUserPerformance.query({ userId });
-    out(result);
-}
-export async function getDashboard(input) {
-    const result = await api.dashboard.getDashboard.query({
-        userId: input.userId,
-        role: input.role ?? "ALL",
-        deals: input.deals ?? "ALL",
-        timeFrame: input.timeFrame ?? "ALL",
-        startDate: input.startDate,
-        endDate: input.endDate,
-    });
-    out(result);
-}
-export async function getMonthlyMetrics(input) {
-    const result = await api.dashboard.getMonthlyMetrics.query({
-        userId: input.userId,
-        role: input.role ?? "ALL",
-        deals: input.deals ?? "ALL",
-        timeFrame: input.timeFrame ?? "ALL",
-        startDate: input.startDate,
-        endDate: input.endDate,
-    });
-    out(result);
-}
-export async function getSystemOverview(input) {
-    const result = await api.dashboard.getSystemOverview.query({
-        userId: input.userId,
-        role: input.role ?? "ALL",
-        deals: input.deals ?? "ALL",
-        timeFrame: input.timeFrame ?? "ALL",
-        startDate: input.startDate,
-        endDate: input.endDate,
-    });
-    out(result);
-}
-export async function getEstimatePerformance(input) {
-    const result = await api.dashboard.getEstimatePerformance.query({
-        userId: input.userId,
-        role: input.role ?? "ALL",
-        deals: input.deals ?? "ALL",
-        timeFrame: input.timeFrame ?? "ALL",
-        startDate: input.startDate,
-        endDate: input.endDate,
-    });
-    out(result);
-}
-export async function getFinancialOverview(input) {
-    const result = await api.dashboard.getFinancialOverview.query({
-        userId: input.userId,
-        role: input.role ?? BudgetRole.ALL,
-        deals: input.deals ?? Deals.ALL,
-        timeFrame: input.timeFrame ?? TimeFrame.ALL,
-        startDate: input.startDate,
-        endDate: input.endDate,
-    });
-    out(result);
-}
-// --- Error logs ---
-export async function getRecentErrors(opts) {
-    const result = await api.errorLog.getRecentErrors.query({
-        page: opts.page ?? 1,
-        perPage: opts.perPage ?? 10,
-        severity: opts.severity,
-        status: opts.status,
-    });
-    out(result);
-}
-export async function getErrorMetrics() {
-    const result = await api.errorLog.getErrorMetrics.query({});
-    out(result);
-}
-// --- Historical / benchmarks ---
-export async function getApprovedBudgets(opts) {
-    const perPage = Math.min(opts.limit ?? 50, 100);
-    const { budgets, totalCount } = await api.budget.getAllBudgets.query({
-        projectId: opts.projectId,
-        statuses: [
-            ExtendedBudgetStatus.APPROVED,
-            ExtendedBudgetStatus.ESTIMATE_ACCEPTED,
-            ExtendedBudgetStatus.ESTIMATE_CLOSED,
-        ],
-        page: 1,
-        perPage,
-        includeDetails: false,
-    });
-    const items = (budgets ?? []).map((b) => {
-        const calc = b;
-        const revenue = calc.totalSellingAfterDiscount ?? 0;
-        const cost = calc.totalCostWithoutGst ?? 0;
-        const gp = calc.gpPercentage ?? 0;
-        const startDate = b.project.startDate;
-        const date = startDate instanceof Date
-            ? startDate.toISOString()
-            : String(startDate ?? "");
-        const createdAt = b.createdAt instanceof Date
-            ? b.createdAt.toISOString()
-            : String(b.createdAt);
-        return {
-            id: b.id,
-            name: b.name,
-            categoryId: b.categoryId,
-            company: b.project?.company?.name,
-            date,
-            pax: b.project.pax,
-            revenue: Number(revenue.toFixed(2)),
-            cost: Number(cost.toFixed(2)),
-            gpPercentage: Number(gp.toFixed(2)),
-            createdAt,
-        };
-    });
-    let filtered = items;
-    if (opts.minRevenue != null) {
-        const minR = opts.minRevenue;
-        filtered = filtered.filter((i) => i.revenue >= minR);
-    }
-    if (opts.maxRevenue != null) {
-        const maxR = opts.maxRevenue;
-        filtered = filtered.filter((i) => i.revenue <= maxR);
-    }
-    out({ budgets: filtered, count: filtered.length, totalCount });
-}
-export async function getBudgetCategoryBenchmarks(opts) {
-    const result = await api.budget.getBudgetCategoryBenchmarks.query({
-        categoryId: opts.categoryId,
-        limit: opts.limit ?? 100,
-    });
-    out(result);
-}
-export async function getItemPricingHistory(opts) {
-    const result = await api.budget.getItemPricingHistory.query({
-        itemName: opts.itemName,
-        categoryId: opts.categoryId,
-        supplierId: opts.supplierId,
-        limit: opts.limit ?? 100,
-    });
-    out(result);
-}
-export async function getSupplierPricingHistory(opts) {
-    const result = await api.budget.getSupplierPricingHistory.query({
-        supplierId: opts.supplierId,
-        itemCategoryId: opts.itemCategoryId,
-        limit: opts.limit ?? 100,
-    });
-    out(result);
-}