@go-labs-sg/bb 2.5.0 → 2.7.0

package/README.md

@@ -148,6 +148,33 @@ Run `bb version` before agent-driven work to record the installed package versio
 
 **Budget status automation:** Setting a budget to `ESTIMATE_ACCEPTED` requires a confirmed win-proof attachment. The first accepted estimate also requires `--invoiceSettings '<json>'` while customer invoicing is enabled. Provide `depositPercentage`, `balancePercentage`, `deliveryMethod`, and the matching `billingEmail` or HTTPS `uploadUrl`; revenue at or below S$5,000 requires `100/0`. If the parent project is `PITCH` or `LOST`, the API marks it `WON` automatically and runs enabled Asana automation. When rejecting the only accepted/closed budget on a commercial project, pass `--projectStatusOnCommercialRejection PITCH|LOST`.
 
+### Typeform inbound administration
+
+Inbound collection administration requires an API key owned by an `ADMIN`.
+Source and submission lists omit raw Typeform answers; fetching one submission
+returns its complete retained payload, which may contain personal information.
+
+```bash
+bb inbound source list
+bb inbound source get <source-id>
+bb inbound source update <source-id> --name "Website inbound" --allow-state-change
+bb inbound submission list --sourceId <source-id>
+bb inbound submission get <submission-id>
+bb inbound mapping save <source-id> \
+  --payload '[{"canonicalField":"COMPANY_NAME","typeformFieldId":"field-id","typeformFieldRef":"company_name","required":true}]' \
+  --allow-state-change
+bb inbound automation save <source-id> --payload '<automation-config-json>' --allow-state-change
+bb inbound processing update <source-id> --mode SHADOW --enabled true --allow-state-change
+```
+
+Mapping saves create and activate an immutable version. Automation configuration
+stores Slack, Asana, and Google Calendar destinations without secrets. Processing
+can remain in `SHADOW` to create durable plans without provider writes; use
+`ACTIVE` only after disabling the matching n8n Typeform trigger. These commands
+do not enable company, project, or QuickBooks creation.
+Use `bb inbound source get` to inspect discovered Typeform field IDs and the
+currently active mapping before saving a replacement version.
+
 ### Mutation safety
 
 Every canonical command is classified by effect: `state-change`, `email`, `external-write`, `delete`, and/or `financial-write`. Interactive runs require one exact `CONFIRM`. Non-interactive runs require the corresponding flags (`--allow-state-change`, `--allow-email`, `--allow-external-write`, `--allow-delete`, and `--allow-financial-write`); commands with multiple effects require every matching flag. Agents must still get user confirmation in chat first—the runtime gate is not user authorization.

package/command-manifest.json

@@ -6459,6 +6459,377 @@
 		"effects": ["state-change", "external-write"],
 		"legacyTarget": "retry-integration-operation"
 	},
+	{
+		"path": ["inbound", "source", "list"],
+		"legacyAliases": ["list-inbound-sources", "list_inbound_sources"],
+		"summary": "List inbound sources.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": [],
+		"legacyTarget": "list-inbound-sources"
+	},
+	{
+		"path": ["inbound", "source", "get"],
+		"legacyAliases": ["get-inbound-source", "get_inbound_source"],
+		"summary": "Get inbound source.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": [],
+		"legacyTarget": "get-inbound-source"
+	},
+	{
+		"path": ["inbound", "source", "update"],
+		"legacyAliases": ["update-inbound-source", "update_inbound_source"],
+		"summary": "Update Inbound Source.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": ["state-change"],
+		"legacyTarget": "update-inbound-source"
+	},
+	{
+		"path": ["inbound", "submission", "list"],
+		"legacyAliases": ["list-inbound-submissions", "list_inbound_submissions"],
+		"summary": "List inbound submissions.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": [],
+		"legacyTarget": "list-inbound-submissions"
+	},
+	{
+		"path": ["inbound", "submission", "get"],
+		"legacyAliases": ["get-inbound-submission", "get_inbound_submission"],
+		"summary": "Get inbound submission.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": [],
+		"legacyTarget": "get-inbound-submission"
+	},
+	{
+		"path": ["inbound", "mapping", "save"],
+		"legacyAliases": ["save-inbound-mapping", "save_inbound_mapping"],
+		"summary": "Save Inbound Mapping.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": ["state-change"],
+		"legacyTarget": "save-inbound-mapping"
+	},
+	{
+		"path": ["inbound", "automation", "save"],
+		"legacyAliases": [
+			"save-inbound-automation-config",
+			"save_inbound_automation_config"
+		],
+		"summary": "Save Inbound Automation Config.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": ["state-change"],
+		"legacyTarget": "save-inbound-automation-config"
+	},
+	{
+		"path": ["inbound", "processing", "update"],
+		"legacyAliases": ["update-inbound-processing", "update_inbound_processing"],
+		"summary": "Update Inbound Processing.",
+		"globalOptions": [
+			{
+				"name": "--help",
+				"description": "Show help for this command."
+			},
+			{
+				"name": "--quiet",
+				"description": "Suppress non-error diagnostics."
+			},
+			{
+				"name": "--debug",
+				"description": "Emit sanitized diagnostic traces."
+			},
+			{
+				"name": "--api-url",
+				"description": "Override the Budget Builder API base URL."
+			},
+			{
+				"name": "--allow-state-change",
+				"description": "Allow a Budget Builder state change in non-interactive use."
+			},
+			{
+				"name": "--allow-email",
+				"description": "Allow sending email in non-interactive use."
+			},
+			{
+				"name": "--allow-external-write",
+				"description": "Allow writes to external systems in non-interactive use."
+			},
+			{
+				"name": "--allow-delete",
+				"description": "Allow deleting data in non-interactive use."
+			},
+			{
+				"name": "--allow-financial-write",
+				"description": "Allow financial-record changes in non-interactive use."
+			}
+		],
+		"argumentMode": "legacy-passthrough",
+		"effects": ["state-change"],
+		"legacyTarget": "update-inbound-processing"
+	},
 	{
 		"path": ["budget", "approved", "list"],
 		"legacyAliases": ["get-approved-budgets", "get_approved_budgets"],

package/command-reference.md

@@ -1128,6 +1128,70 @@ Legacy aliases: `retry-integration-operation`, `retry_integration_operation`.
 
 Effects: state-change, external-write.
 
+## `bb inbound source list`
+
+List inbound sources.
+
+Legacy aliases: `list-inbound-sources`, `list_inbound_sources`.
+
+Effects: none.
+
+## `bb inbound source get`
+
+Get inbound source.
+
+Legacy aliases: `get-inbound-source`, `get_inbound_source`.
+
+Effects: none.
+
+## `bb inbound source update`
+
+Update Inbound Source.
+
+Legacy aliases: `update-inbound-source`, `update_inbound_source`.
+
+Effects: state-change.
+
+## `bb inbound submission list`
+
+List inbound submissions.
+
+Legacy aliases: `list-inbound-submissions`, `list_inbound_submissions`.
+
+Effects: none.
+
+## `bb inbound submission get`
+
+Get inbound submission.
+
+Legacy aliases: `get-inbound-submission`, `get_inbound_submission`.
+
+Effects: none.
+
+## `bb inbound mapping save`
+
+Save Inbound Mapping.
+
+Legacy aliases: `save-inbound-mapping`, `save_inbound_mapping`.
+
+Effects: state-change.
+
+## `bb inbound automation save`
+
+Save Inbound Automation Config.
+
+Legacy aliases: `save-inbound-automation-config`, `save_inbound_automation_config`.
+
+Effects: state-change.
+
+## `bb inbound processing update`
+
+Update Inbound Processing.
+
+Legacy aliases: `update-inbound-processing`, `update_inbound_processing`.
+
+Effects: state-change.
+
 ## `bb budget approved list`
 
 Get approved budgets.

package/dist/commands.js

@@ -2096,6 +2096,44 @@ export const retryIntegrationOperation = async (operationId, confirmExternalStat
     });
     out(result);
 };
+// --- Typeform inbound administration ---
+export const listInboundSources = async (input) => {
+    const result = await api.inbound.listSources.query(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({

package/dist/index.js

@@ -5,7 +5,7 @@ import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { BUDGET_BUILDER_API_BASE_URL, configureBudgetBuilderApiBaseUrl, DEFAULT_BUDGET_BUILDER_API_BASE_URL, requireApiKey, } from "./api-client.js";
 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, createItemCategory, createItemFromPayload, createPlaceholderBillForBudgetItem, createProject, createQuotationFromPayload, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, createUser, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteBudgetCommission, deleteBudgetDiscount, deleteCompanyById, deleteCustomerInvoice, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteQuotationById, deleteSuppliersByIds, discardCreatingCustomerInvoice, downloadCustomerInvoicePaymentProof, downloadCustomerInvoicePdf, downloadQuotationPdf, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getCustomerInvoice, getCustomerInvoiceEmailContext, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, getQuotationDetails, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getSystemOverview, getUserPerformance, importQuickBooksProjectId, listApiKeysForUser, listApprovals, listBills, listBudgets, listCompanies, listContacts, listCustomerInvoices, listEligibleCustomerInvoiceBudgets, listIntegrationOperations, listItemCategories, listItems, listProjects, listQuotations, listSuppliers, listUsers, markBudgetWonWithProof, markCustomerInvoicePaidFromPath, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, reconcileProject, rejectBill, rejectBudget, rejectCustomerInvoice, rejectQuotation, rejectSupplier, removeBudgetItem, renameBudgetVersion, reorderBudgetItemsCli, restoreBudgetVersion, retryIntegrationOperation, revokeApiKeyForUser, sendCustomerInvoiceToContactPersonFromPayload, sendEstimateToContactPersonFromPayload, setBudgetItemsNotUtilized, stageBillAttachmentsFromPaths, submitQuotation, syncCustomerInvoice, updateBillFromPayload, updateBillPaymentEvidenceFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateQuotationFromPayload, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBillAttachmentsFromPaths, uploadBillDocumentsFromPaths, uploadBudgetAttachmentFromPath, uploadQuotationAttachmentFromPath, validateBillSelectionFromPayload, voidCustomerInvoice, whoAmI, } from "./commands.js";
+import { addBudgetItems, approveBill, approveBudget, approveCustomerInvoice, approveQuotation, approveSupplier, archiveItemsByIds, checkCustomerInvoiceReadiness, checkProjectReconciliation, cleanupStagedBillAttachments, cleanupStagedQuotationAttachments, completeProject, createApiKeyForUser, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createCustomerInvoice, createEstimate, createItemCategory, createItemFromPayload, createPlaceholderBillForBudgetItem, createProject, createQuotationFromPayload, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, createUser, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteBudgetCommission, deleteBudgetDiscount, deleteCompanyById, deleteCustomerInvoice, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteQuotationById, deleteSuppliersByIds, discardCreatingCustomerInvoice, downloadCustomerInvoicePaymentProof, downloadCustomerInvoicePdf, downloadQuotationPdf, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getCustomerInvoice, getCustomerInvoiceEmailContext, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getInboundSource, getInboundSubmission, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, 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, markCustomerInvoicePaidFromPath, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, reconcileProject, rejectBill, rejectBudget, rejectCustomerInvoice, rejectQuotation, rejectSupplier, removeBudgetItem, renameBudgetVersion, reorderBudgetItemsCli, restoreBudgetVersion, retryIntegrationOperation, revokeApiKeyForUser, saveInboundAutomationConfig, saveInboundMappingVersion, sendCustomerInvoiceToContactPersonFromPayload, sendEstimateToContactPersonFromPayload, setBudgetItemsNotUtilized, stageBillAttachmentsFromPaths, submitQuotation, syncCustomerInvoice, 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 { parseJsonFlag, parseOptionalNumber as parseOptNum, } from "./parse-json-flag.js";
@@ -2027,6 +2027,82 @@ export async function runCli(argv = process.argv, runtime = createProcessRuntime
                     false);
                 break;
             }
+            case "list-inbound-sources": {
+                await listInboundSources({
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25,
+                });
+                break;
+            }
+            case "get-inbound-source": {
+                const sourceId = positional[0];
+                if (!sourceId)
+                    throw new Error("get-inbound-source requires <sourceId>");
+                await getInboundSource(sourceId);
+                break;
+            }
+            case "update-inbound-source": {
+                const sourceId = positional[0];
+                const name = getFlag(flags, "name");
+                if (!sourceId || !name) {
+                    throw new Error("update-inbound-source requires <sourceId> --name <name>");
+                }
+                await updateInboundSource(sourceId, name);
+                break;
+            }
+            case "list-inbound-submissions": {
+                await listInboundSubmissions({
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25,
+                    sourceId: getFlag(flags, "sourceId"),
+                });
+                break;
+            }
+            case "get-inbound-submission": {
+                const submissionId = positional[0];
+                if (!submissionId) {
+                    throw new Error("get-inbound-submission requires <submissionId>");
+                }
+                await getInboundSubmission(submissionId);
+                break;
+            }
+            case "save-inbound-mapping": {
+                const sourceId = positional[0];
+                const payloadRaw = getFlag(flags, "payload");
+                if (!sourceId || payloadRaw === undefined) {
+                    throw new Error("save-inbound-mapping requires <sourceId> --payload <JSON array>");
+                }
+                const mappings = parseJsonFlag(String(payloadRaw), "--payload");
+                await saveInboundMappingVersion(sourceId, mappings);
+                break;
+            }
+            case "save-inbound-automation-config": {
+                const sourceId = positional[0];
+                const payloadRaw = getFlag(flags, "payload");
+                if (!sourceId || payloadRaw === undefined) {
+                    throw new Error("save-inbound-automation-config requires <sourceId> --payload <JSON object>");
+                }
+                const config = parseJsonFlag(String(payloadRaw), "--payload");
+                await saveInboundAutomationConfig({ ...config, sourceId });
+                break;
+            }
+            case "update-inbound-processing": {
+                const sourceId = positional[0];
+                const mode = getFlag(flags, "mode");
+                const enabled = parseOptionalBoolFlag(flags, "enabled");
+                if (!sourceId ||
+                    !mode ||
+                    enabled === undefined ||
+                    !["COLLECT_ONLY", "SHADOW", "ACTIVE"].includes(String(mode))) {
+                    throw new Error("update-inbound-processing requires <sourceId> --mode COLLECT_ONLY|SHADOW|ACTIVE --enabled true|false");
+                }
+                await updateInboundProcessing({
+                    processingEnabled: enabled,
+                    processingMode: String(mode),
+                    sourceId,
+                });
+                break;
+            }
             case "get-approved-budgets": {
                 await getApprovedBudgets({
                     projectId: getFlag(flags, "projectId"),

package/dist/registry/index.js

@@ -56,6 +56,7 @@ const mutationPrefixes = [
     "restore-",
     "retry-",
     "revoke-",
+    "save-",
     "send-",
     "stage-",
     "submit-",
@@ -447,6 +448,22 @@ const registry = [
         "operation",
         "retry",
     ]),
+    legacyCommand("list-inbound-sources", ["inbound", "source", "list"]),
+    legacyCommand("get-inbound-source", ["inbound", "source", "get"]),
+    legacyCommand("update-inbound-source", ["inbound", "source", "update"]),
+    legacyCommand("list-inbound-submissions", ["inbound", "submission", "list"]),
+    legacyCommand("get-inbound-submission", ["inbound", "submission", "get"]),
+    legacyCommand("save-inbound-mapping", ["inbound", "mapping", "save"]),
+    legacyCommand("save-inbound-automation-config", [
+        "inbound",
+        "automation",
+        "save",
+    ]),
+    legacyCommand("update-inbound-processing", [
+        "inbound",
+        "processing",
+        "update",
+    ]),
     legacyCommand("get-approved-budgets", ["budget", "approved", "list"]),
     legacyCommand("get-budget-category-benchmarks", [
         "budget",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "2.5.0",
+  "version": "2.7.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",