@go-labs-sg/bb 2.13.0 → 2.15.0

package/dist/index.js

@@ -7,7 +7,7 @@ import { BUDGET_BUILDER_API_BASE_URL, configureBudgetBuilderApiBaseUrl, DEFAULT_
 import { consumeCliQuietFlags, logCliAction, sanitizeFlagsForTrace, setCliQuiet, shouldLogCliActions, } from "./cli-trace.js";
 import { addBudgetItems, approveBill, approveBudget, approveCustomerInvoice, approveQuotation, approveSupplier, archiveItemsByIds, checkCustomerInvoiceReadiness, checkProjectReconciliation, cleanupStagedBillAttachments, cleanupStagedQuotationAttachments, completeProject, createApiKeyForUser, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createCustomerInvoice, createEstimate, createInboundSource, createItemCategory, createItemFromPayload, createPlaceholderBillForBudgetItem, createProject, createQuotationFromPayload, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, createUser, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteBudgetCommission, deleteBudgetDiscount, deleteCompanyById, deleteCustomerInvoice, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteQuotationById, deleteSuppliersByIds, discardCreatingCustomerInvoice, downloadCustomerInvoicePdf, downloadQuotationPdf, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getCustomerInvoice, getCustomerInvoiceEmailContext, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getInboundSource, getInboundSubmission, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, getProjectHubStatus, getQuotationDetails, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getSystemOverview, getUserPerformance, importQuickBooksProjectId, listApiKeysForUser, listApprovals, listBills, listBudgets, listCompanies, listContacts, listCustomerInvoices, listEligibleCustomerInvoiceBudgets, listInboundSources, listInboundSubmissions, listIntegrationOperations, listItemCategories, listItems, listProjects, listQuotations, listSuppliers, listUsers, markBudgetWonWithProof, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, reconcileProject, rejectBill, rejectBudget, rejectCustomerInvoice, rejectQuotation, rejectSupplier, removeBudgetItem, renameBudgetVersion, reorderBudgetItemsCli, restoreBudgetVersion, retryIntegrationOperation, revokeApiKeyForUser, saveInboundAutomationConfig, saveInboundMappingVersion, sendCustomerInvoiceToContactPersonFromPayload, sendEstimateToContactPersonFromPayload, setBudgetItemsNotUtilized, setupProjectHub, stageBillAttachmentsFromPaths, submitQuotation, syncCustomerInvoice, syncProjectHubCommercialDocuments, updateBillFromPayload, updateBillPaymentEvidenceFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateInboundProcessing, updateInboundSource, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateQuotationFromPayload, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBillAttachmentsFromPaths, uploadBillDocumentsFromPaths, uploadBudgetAttachmentFromPath, uploadQuotationAttachmentFromPath, validateBillSelectionFromPayload, voidCustomerInvoice, whoAmI, } from "./commands.js";
 import { getFlag, parseArgs } from "./parse-args.js";
-import { billStatusesForUpdateHelp, budgetStatusesForHelp, isBudgetStatusUpdate, parseApprovalTypeFlag, parseBillStatusForUpdate, parseCommaSeparatedBillStatuses, parseCommaSeparatedBudgetStatuses, parseCommaSeparatedCustomerInvoiceStatuses, parseCommaSeparatedIds, parseCommaSeparatedQuotationStatuses, parseCommaSeparatedSupplierStatuses, parseOptionalBillListSortBy, parseOptionalBillListSortDir, parseOptionalDashboardRole, parseOptionalDeals, parseOptionalErrorSeverity, parseOptionalErrorStatus, parseOptionalExtendedProjectStatus, parseOptionalFinancialRole, parseOptionalSupplierAnalyticsTimeFrame, parseOptionalTimeFrame, parseProjectStatusForUpdate, parseUserRole, projectStatusesForHelp, userRolesForHelp, } from "./parse-cli-enums.js";
+import { billStatusesForUpdateHelp, budgetStatusesForHelp, isBudgetStatusUpdate, parseApprovalTypeFlag, parseBillStatusForUpdate, parseCommaSeparatedBillStatuses, parseCommaSeparatedBudgetStatuses, parseCommaSeparatedCustomerInvoiceStatuses, parseCommaSeparatedIds, parseCommaSeparatedIntegrationOperationStatuses, parseCommaSeparatedQuotationStatuses, parseCommaSeparatedSupplierStatuses, parseOptionalBillListSortBy, parseOptionalBillListSortDir, parseOptionalDashboardRole, parseOptionalDeals, parseOptionalErrorSeverity, parseOptionalErrorStatus, parseOptionalExtendedProjectStatus, parseOptionalFinancialRole, parseOptionalSupplierAnalyticsTimeFrame, parseOptionalTimeFrame, parseProjectStatusForUpdate, parseUserRole, projectStatusesForHelp, userRolesForHelp, } from "./parse-cli-enums.js";
 import { parseJsonFlag, parseOptionalNumber as parseOptNum, } from "./parse-json-flag.js";
 import { createCompletionScript, createHumanHelp, resolveCommand, } from "./registry/index.js";
 import { CliRuntimeError, clearActiveCliSession, confirmCurrentCommand, createProcessRuntime, emitCommandError, emitCommandResult, setActiveCliSession, } from "./runtime/index.js";
@@ -45,21 +45,6 @@ function parseCustomerInvoiceSortBy(value) {
     }
     return value;
 }
-const INTEGRATION_OPERATION_STATUSES = [
-    "PENDING",
-    "PROCESSING",
-    "FAILED",
-    "COMPLETED",
-];
-function parseIntegrationOperationStatus(value) {
-    if (value === undefined)
-        return undefined;
-    const normalized = value.toUpperCase();
-    if (!INTEGRATION_OPERATION_STATUSES.includes(normalized)) {
-        throw new Error(`Invalid --status "${value}". Use one of: ${INTEGRATION_OPERATION_STATUSES.join(", ")}.`);
-    }
-    return normalized;
-}
 function parseCommercialRejectionProjectStatus(flags) {
     const raw = flags.projectStatusOnCommercialRejection;
     if (raw === undefined)
@@ -344,7 +329,7 @@ Errors
   get-error-metrics          (admin)
 
 Automation (admin)
-  list-integration-operations [--destination] [--status PENDING|PROCESSING|FAILED|COMPLETED] [--page] [--perPage]
+  list-integration-operations [--search] [--destination <provider,...>] [--status <PENDING|PROCESSING|FAILED|COMPLETED,...>] [--page] [--perPage]
   retry-integration-operation <operationId> [--confirmExternalStateReconciled true|false]
 
 Historical / benchmarks
@@ -2009,10 +1994,11 @@ export async function runCli(argv = process.argv, runtime = createProcessRuntime
             }
             case "list-integration-operations": {
                 await listIntegrationOperations({
-                    destination: getFlag(flags, "destination"),
+                    destination: parseCommaSeparatedIds(getFlag(flags, "destination")),
                     page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
                     perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25,
-                    status: parseIntegrationOperationStatus(getFlag(flags, "status")),
+                    search: getFlag(flags, "search"),
+                    status: parseCommaSeparatedIntegrationOperationStatuses(getFlag(flags, "status")),
                 });
                 break;
             }

package/dist/parse-cli-enums.js

@@ -26,6 +26,12 @@ const SUPPLIER_ANALYTICS_TF = new Set([
 const SUPPLIER_APPROVAL_STATUS_VALUES = new Set(Object.values(ExtendedApprovalStatus));
 const EXT_ERROR_SEVERITY_VALUES = new Set(Object.values(ExtendedErrorSeverity));
 const EXT_ERROR_STATUS_VALUES = new Set(Object.values(ExtendedErrorStatus));
+const INTEGRATION_OPERATION_STATUS_VALUES = new Set([
+    "PENDING",
+    "PROCESSING",
+    "FAILED",
+    "COMPLETED",
+]);
 export function isBudgetStatusListToken(s) {
     if (s === "ALL")
         return true;
@@ -139,6 +145,22 @@ export function parseCommaSeparatedIds(raw) {
         .filter(Boolean);
     return ids.length > 0 ? ids : undefined;
 }
+export function parseCommaSeparatedIntegrationOperationStatuses(raw) {
+    if (raw === undefined)
+        return undefined;
+    const statuses = raw
+        .split(",")
+        .map((value) => value.trim().toUpperCase())
+        .filter(Boolean);
+    if (statuses.length === 0)
+        return undefined;
+    for (const status of statuses) {
+        if (!INTEGRATION_OPERATION_STATUS_VALUES.has(status)) {
+            throw new Error(`Invalid integration operation status "${status}". Use one or more of: ${[...INTEGRATION_OPERATION_STATUS_VALUES].join(", ")}.`);
+        }
+    }
+    return statuses;
+}
 export function parseCommaSeparatedBudgetStatuses(raw) {
     if (raw === undefined)
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "2.13.0",
+  "version": "2.15.0",
   "description": "Budget Builder CLI for AI agents — manage budgets, bills, claims, quotations, and customer invoices with explicit workflow previews for sensitive changes.",
   "type": "module",
   "main": "./dist/index.js",

package/role-aware-agent-guide.md

@@ -163,7 +163,7 @@ Admin inspecting a failed integration before a confirmed retry:
 
 ```bash
 bb auth whoami
-bb integration operation list --status FAILED
+bb integration operation list --status FAILED,PENDING --search "QuickBooks"
 bb integration operation retry <operation-id>
 ```