@5ss/ai-tools 2.11.1

package/dist/vendors/katana/index.js

@@ -0,0 +1,1639 @@
+import { t as ToolError } from "../../errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "../../define-CvpJ_pNP.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { t as HttpService } from "../../http-service-DDNCO1s4.js";
+import { isPlainObject, isString } from "es-toolkit";
+import { z } from "zod";
+//#region src/vendors/katana/contracts.ts
+const katanaAuthSchema = z.object({ api_key: z.string().min(1).describe("Katana MRP Bearer access token") });
+const listCursorFields = {
+	cursor: z.string().min(1).optional().describe("Page number from a prior next_cursor"),
+	limit: z.int().min(1).max(250).optional().describe("Page size (1-250, default 50)")
+};
+const listOutputMeta = {
+	next_cursor: z.string().optional(),
+	truncated: z.boolean()
+};
+const katanaSalesOrderRowInputSchema = z.object({
+	quantity: z.number().positive().describe("Line quantity"),
+	variant_id: z.int().positive().describe("Product variant id"),
+	tax_rate_id: z.int().positive().optional().describe("Tax rate id"),
+	location_id: z.int().positive().optional().describe("Ship-from location id for this row"),
+	price_per_unit: z.number().min(0).optional().describe("Unit price excluding tax"),
+	total_discount: z.number().min(0).optional().describe("Line discount total")
+});
+const katanaSalesOrderSchema = z.object({
+	id: z.number(),
+	order_no: z.string().optional(),
+	status: z.string().optional(),
+	customer_id: z.number().optional(),
+	order_created_date: z.string().optional(),
+	delivery_date: z.string().optional(),
+	location_id: z.number().optional(),
+	currency: z.string().optional(),
+	total: z.number().optional(),
+	additional_info: z.string().optional(),
+	customer_ref: z.string().optional(),
+	created_at: z.string().optional().describe("Resource created_at timestamp when returned by Katana")
+});
+const katanaListSalesOrdersInputSchema = z.object({
+	status: z.string().min(1).optional().describe("Sales order status filter"),
+	customer_id: z.int().positive().optional().describe("Filter by customer id"),
+	order_no: z.string().min(1).optional().describe("Filter by order number"),
+	location_id: z.int().positive().optional().describe("Filter by location id"),
+	...listCursorFields
+});
+const katanaListSalesOrdersOutputSchema = z.object({
+	items: z.array(katanaSalesOrderSchema),
+	...listOutputMeta
+});
+const katanaGetSalesOrderInputSchema = z.object({ sales_order_id: z.int().positive().describe("Sales order id") });
+const katanaGetSalesOrderOutputSchema = z.object({ sales_order: katanaSalesOrderSchema });
+const katanaCreateSalesOrderInputSchema = z.object({
+	customer_id: z.int().positive().describe("Customer id"),
+	sales_order_rows: z.array(katanaSalesOrderRowInputSchema).min(1).describe("Order line items (variant_id + quantity required)"),
+	order_no: z.string().min(1).optional().describe("Order number"),
+	order_created_date: z.string().min(1).optional().describe("Order created date (ISO 8601)"),
+	delivery_date: z.string().min(1).optional().describe("Delivery date (ISO 8601)"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	location_id: z.int().positive().optional().describe("Default ship-from location id"),
+	status: z.string().min(1).optional().describe("NOT_SHIPPED (default) or PENDING for quotes"),
+	additional_info: z.string().optional().describe("Internal notes"),
+	customer_ref: z.string().optional().describe("Customer reference")
+});
+const katanaCreateSalesOrderOutputSchema = katanaGetSalesOrderOutputSchema;
+const katanaUpdateSalesOrderInputSchema = z.object({
+	sales_order_id: z.int().positive().describe("Sales order id"),
+	order_no: z.string().min(1).optional().describe("Order number"),
+	customer_id: z.int().positive().optional().describe("Customer id"),
+	order_created_date: z.string().min(1).optional().describe("Order created date (ISO 8601)"),
+	delivery_date: z.string().min(1).optional().describe("Delivery date (ISO 8601)"),
+	location_id: z.int().positive().optional().describe("Default ship-from location id"),
+	status: z.string().min(1).optional().describe("Order status (e.g. NOT_SHIPPED, PENDING, PACKED, DELIVERED)"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	additional_info: z.string().optional().describe("Internal notes"),
+	customer_ref: z.string().optional().describe("Customer reference")
+});
+const katanaUpdateSalesOrderOutputSchema = katanaGetSalesOrderOutputSchema;
+const katanaDeleteSalesOrderInputSchema = z.object({ sales_order_id: z.int().positive().describe("Sales order id") });
+const katanaDeleteSalesOrderOutputSchema = z.object({
+	deleted: z.boolean(),
+	id: z.number()
+});
+const katanaQuerySalesOrderScopeSchema = z.object({
+	created_from: z.string().min(1).optional().describe("ISO 8601 lower bound on resource created_at (maps to created_at_min)"),
+	order_created_from: z.string().min(1).optional().describe("ISO 8601 lower bound on order_created_date (client-side; list API has no order_created filter)"),
+	order_created_to: z.string().min(1).optional().describe("ISO 8601 upper bound on order_created_date (client-side; list API has no order_created filter)"),
+	statuses: z.array(z.string().min(1)).min(1).max(20).optional().describe("Sales order statuses to include for this scope (one API list pass each; single status per call)"),
+	customer_id: z.int().positive().optional().describe("Filter by customer id"),
+	location_id: z.int().positive().optional().describe("Filter by location id")
+});
+const katanaQuerySalesOrdersInputSchema = z.object({
+	scopes: z.array(katanaQuerySalesOrderScopeSchema).min(1).max(20).describe("Independent filter scopes; results are unioned and deduplicated by order id"),
+	max_pages_per_list: z.int().min(1).max(100).optional().describe("Max sequential pages per scope×status list call (default 20)"),
+	page_size: z.int().min(1).max(250).optional().describe("Page size for list calls (default 50)")
+});
+const katanaNormalizedSalesOrderRowSchema = z.object({
+	sku: z.string().optional().describe("Variant SKU when known"),
+	quantity: z.number().describe("Line quantity"),
+	tax_exclusive_total_cents: z.number().int().describe("Line revenue in safe integer cents: (quantity * price_per_unit - total_discount)"),
+	cogs_value_cents: z.number().int().describe("Line COGS in safe integer cents when variant cost is available; otherwise 0")
+});
+const katanaNormalizedSalesOrderSchema = z.object({
+	id: z.number(),
+	created_at: z.string().optional().describe("Resource created_at when returned by Katana"),
+	order_created_date: z.string().optional(),
+	order_no: z.string().optional(),
+	status: z.string().optional(),
+	customer_id: z.number().optional(),
+	customer_name: z.string().optional().describe("Enriched from customers API when available"),
+	rows: z.array(katanaNormalizedSalesOrderRowSchema)
+});
+const katanaQuerySalesOrdersOutputSchema = z.object({
+	orders: z.array(katanaNormalizedSalesOrderSchema),
+	order_count: z.number().int().describe("Number of unique orders after deduplication")
+});
+const katanaProductVariantInputSchema = z.object({
+	sku: z.string().min(1).optional().describe("Variant SKU"),
+	sales_price: z.number().min(0).optional().describe("Sales price"),
+	purchase_price: z.number().min(0).optional().describe("Purchase price")
+});
+const katanaProductSchema = z.object({
+	id: z.number(),
+	name: z.string().optional(),
+	uom: z.string().optional(),
+	category_name: z.string().optional(),
+	is_sellable: z.boolean().optional(),
+	is_producible: z.boolean().optional(),
+	is_purchasable: z.boolean().optional(),
+	type: z.string().optional(),
+	default_supplier_id: z.number().optional(),
+	additional_info: z.string().optional()
+});
+const katanaListProductsInputSchema = z.object({
+	name: z.string().min(1).optional().describe("Filter by product name"),
+	is_sellable: z.boolean().optional().describe("Filter sellable products"),
+	is_producible: z.boolean().optional().describe("Filter producible products"),
+	is_purchasable: z.boolean().optional().describe("Filter purchasable products"),
+	...listCursorFields
+});
+const katanaListProductsOutputSchema = z.object({
+	items: z.array(katanaProductSchema),
+	...listOutputMeta
+});
+const katanaGetProductInputSchema = z.object({ product_id: z.int().positive().describe("Product id") });
+const katanaGetProductOutputSchema = z.object({ product: katanaProductSchema });
+const katanaCreateProductInputSchema = z.object({
+	name: z.string().min(1).describe("Product name"),
+	variants: z.array(katanaProductVariantInputSchema).min(1).describe("At least one variant (sku/prices optional)"),
+	uom: z.string().min(1).optional().describe("Unit of measure (e.g. pcs)"),
+	category_name: z.string().min(1).optional().describe("Category name"),
+	is_sellable: z.boolean().optional().describe("Can be sold on sales orders"),
+	is_producible: z.boolean().optional().describe("Can be manufactured"),
+	is_purchasable: z.boolean().optional().describe("Can be purchased"),
+	is_auto_assembly: z.boolean().optional().describe("Bundle/kit auto-assembly"),
+	default_supplier_id: z.int().positive().optional().describe("Default supplier id"),
+	additional_info: z.string().optional().describe("Internal notes"),
+	batch_tracked: z.boolean().optional().describe("Enable batch tracking"),
+	serial_tracked: z.boolean().optional().describe("Enable serial tracking")
+});
+const katanaCreateProductOutputSchema = katanaGetProductOutputSchema;
+const katanaUpdateProductInputSchema = z.object({
+	product_id: z.int().positive().describe("Product id"),
+	name: z.string().min(1).optional().describe("Product name"),
+	uom: z.string().min(1).optional().describe("Unit of measure"),
+	category_name: z.string().optional().describe("Category name"),
+	is_sellable: z.boolean().optional().describe("Can be sold on sales orders"),
+	is_producible: z.boolean().optional().describe("Can be manufactured"),
+	is_purchasable: z.boolean().optional().describe("Can be purchased"),
+	is_auto_assembly: z.boolean().optional().describe("Bundle/kit auto-assembly"),
+	default_supplier_id: z.int().positive().optional().describe("Default supplier id"),
+	additional_info: z.string().optional().describe("Internal notes"),
+	batch_tracked: z.boolean().optional().describe("Enable batch tracking"),
+	serial_tracked: z.boolean().optional().describe("Enable serial tracking")
+});
+const katanaUpdateProductOutputSchema = katanaGetProductOutputSchema;
+const katanaMaterialSchema = z.object({
+	id: z.number(),
+	name: z.string().optional(),
+	uom: z.string().optional(),
+	category_name: z.string().optional(),
+	is_sellable: z.boolean().optional(),
+	type: z.string().optional(),
+	default_supplier_id: z.number().optional(),
+	additional_info: z.string().optional()
+});
+const katanaListMaterialsInputSchema = z.object({
+	name: z.string().min(1).optional().describe("Filter by material name"),
+	...listCursorFields
+});
+const katanaListMaterialsOutputSchema = z.object({
+	items: z.array(katanaMaterialSchema),
+	...listOutputMeta
+});
+const katanaGetMaterialInputSchema = z.object({ material_id: z.int().positive().describe("Material id") });
+const katanaGetMaterialOutputSchema = z.object({ material: katanaMaterialSchema });
+const katanaCustomerSchema = z.object({
+	id: z.number(),
+	name: z.string().optional(),
+	first_name: z.string().optional(),
+	last_name: z.string().optional(),
+	company: z.string().optional(),
+	email: z.string().optional(),
+	phone: z.string().optional(),
+	currency: z.string().optional(),
+	comment: z.string().optional(),
+	reference_id: z.string().optional(),
+	category: z.string().optional()
+});
+const katanaListCustomersInputSchema = z.object({
+	name: z.string().min(1).optional().describe("Filter by customer name"),
+	email: z.string().min(1).optional().describe("Filter by email"),
+	...listCursorFields
+});
+const katanaListCustomersOutputSchema = z.object({
+	items: z.array(katanaCustomerSchema),
+	...listOutputMeta
+});
+const katanaGetCustomerInputSchema = z.object({ customer_id: z.int().positive().describe("Customer id") });
+const katanaGetCustomerOutputSchema = z.object({ customer: katanaCustomerSchema });
+const katanaCreateCustomerInputSchema = z.object({
+	name: z.string().min(1).describe("Customer display name"),
+	first_name: z.string().optional().describe("First name"),
+	last_name: z.string().optional().describe("Last name"),
+	company: z.string().optional().describe("Company name"),
+	email: z.string().optional().describe("Email"),
+	phone: z.string().optional().describe("Phone"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	reference_id: z.string().optional().describe("External reference id"),
+	category: z.string().optional().describe("Customer category"),
+	comment: z.string().optional().describe("Internal comment"),
+	discount_rate: z.number().optional().describe("Default discount rate")
+});
+const katanaCreateCustomerOutputSchema = katanaGetCustomerOutputSchema;
+const katanaUpdateCustomerInputSchema = z.object({
+	customer_id: z.int().positive().describe("Customer id"),
+	name: z.string().min(1).optional().describe("Customer display name"),
+	first_name: z.string().optional().describe("First name"),
+	last_name: z.string().optional().describe("Last name"),
+	company: z.string().optional().describe("Company name"),
+	email: z.string().optional().describe("Email"),
+	phone: z.string().optional().describe("Phone"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	reference_id: z.string().optional().describe("External reference id"),
+	category: z.string().optional().describe("Customer category"),
+	comment: z.string().optional().describe("Internal comment"),
+	discount_rate: z.number().optional().describe("Default discount rate")
+});
+const katanaUpdateCustomerOutputSchema = katanaGetCustomerOutputSchema;
+const katanaSupplierSchema = z.object({
+	id: z.number(),
+	name: z.string().optional(),
+	email: z.string().optional(),
+	phone: z.string().optional(),
+	currency: z.string().optional(),
+	comment: z.string().optional()
+});
+const katanaListSuppliersInputSchema = z.object({
+	name: z.string().min(1).optional().describe("Filter by supplier name"),
+	...listCursorFields
+});
+const katanaListSuppliersOutputSchema = z.object({
+	items: z.array(katanaSupplierSchema),
+	...listOutputMeta
+});
+const katanaGetSupplierInputSchema = z.object({ supplier_id: z.int().positive().describe("Supplier id") });
+const katanaGetSupplierOutputSchema = z.object({ supplier: katanaSupplierSchema });
+const katanaCreateSupplierInputSchema = z.object({
+	name: z.string().min(1).describe("Supplier name"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	email: z.string().optional().describe("Email"),
+	phone: z.string().optional().describe("Phone"),
+	comment: z.string().optional().describe("Internal comment")
+});
+const katanaCreateSupplierOutputSchema = katanaGetSupplierOutputSchema;
+const katanaPurchaseOrderRowInputSchema = z.object({
+	quantity: z.number().positive().describe("Line quantity"),
+	variant_id: z.int().positive().describe("Product or material variant id"),
+	price_per_unit: z.number().min(0).describe("Unit price excluding tax"),
+	tax_rate_id: z.int().positive().optional().describe("Tax rate id"),
+	purchase_uom: z.string().min(1).optional().describe("Purchase unit of measure"),
+	purchase_uom_conversion_rate: z.number().min(0).optional().describe("Conversion rate to stock UoM"),
+	arrival_date: z.string().min(1).optional().describe("Expected arrival date (ISO 8601)")
+});
+const katanaPurchaseOrderSchema = z.object({
+	id: z.number(),
+	order_no: z.string().optional(),
+	status: z.string().optional(),
+	supplier_id: z.number().optional(),
+	location_id: z.number().optional(),
+	currency: z.string().optional(),
+	entity_type: z.string().optional(),
+	order_created_date: z.string().optional(),
+	expected_arrival_date: z.string().optional(),
+	total: z.number().optional(),
+	additional_info: z.string().optional()
+});
+const katanaListPurchaseOrdersInputSchema = z.object({
+	status: z.string().min(1).optional().describe("Purchase order status filter"),
+	supplier_id: z.int().positive().optional().describe("Filter by supplier id"),
+	order_no: z.string().min(1).optional().describe("Filter by order number"),
+	location_id: z.int().positive().optional().describe("Filter by location id"),
+	...listCursorFields
+});
+const katanaListPurchaseOrdersOutputSchema = z.object({
+	items: z.array(katanaPurchaseOrderSchema),
+	...listOutputMeta
+});
+const katanaGetPurchaseOrderInputSchema = z.object({ purchase_order_id: z.int().positive().describe("Purchase order id") });
+const katanaGetPurchaseOrderOutputSchema = z.object({ purchase_order: katanaPurchaseOrderSchema });
+const katanaCreatePurchaseOrderInputSchema = z.object({
+	supplier_id: z.int().positive().describe("Supplier id"),
+	location_id: z.int().positive().describe("Receive-to location id"),
+	purchase_order_rows: z.array(katanaPurchaseOrderRowInputSchema).min(1).describe("Order line items (variant_id, quantity, price_per_unit required)"),
+	order_no: z.string().min(1).optional().describe("Order number"),
+	entity_type: z.string().min(1).optional().describe("regular or outsourced"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	status: z.string().min(1).optional().describe("DRAFT or NOT_RECEIVED"),
+	expected_arrival_date: z.string().min(1).optional().describe("Expected arrival date (ISO 8601)"),
+	order_created_date: z.string().min(1).optional().describe("Order created date (ISO 8601)"),
+	additional_info: z.string().optional().describe("Internal notes")
+});
+const katanaCreatePurchaseOrderOutputSchema = katanaGetPurchaseOrderOutputSchema;
+const katanaUpdatePurchaseOrderInputSchema = z.object({
+	purchase_order_id: z.int().positive().describe("Purchase order id"),
+	order_no: z.string().min(1).optional().describe("Order number"),
+	supplier_id: z.int().positive().optional().describe("Supplier id"),
+	location_id: z.int().positive().optional().describe("Receive-to location id"),
+	currency: z.string().min(1).optional().describe("ISO 4217 currency code"),
+	status: z.string().min(1).optional().describe("Purchase order status"),
+	expected_arrival_date: z.string().min(1).optional().describe("Expected arrival date (ISO 8601)"),
+	order_created_date: z.string().min(1).optional().describe("Order created date (ISO 8601)"),
+	additional_info: z.string().optional().describe("Internal notes")
+});
+const katanaUpdatePurchaseOrderOutputSchema = katanaGetPurchaseOrderOutputSchema;
+const katanaManufacturingOrderSchema = z.object({
+	id: z.number(),
+	order_no: z.string().optional(),
+	status: z.string().optional(),
+	variant_id: z.number().optional(),
+	location_id: z.number().optional(),
+	planned_quantity: z.number().optional(),
+	actual_quantity: z.number().optional(),
+	order_created_date: z.string().optional(),
+	production_deadline_date: z.string().optional(),
+	ingredient_availability: z.string().optional(),
+	additional_info: z.string().optional(),
+	sales_order_id: z.number().optional()
+});
+const katanaListManufacturingOrdersInputSchema = z.object({
+	status: z.string().min(1).optional().describe("Manufacturing order status filter"),
+	variant_id: z.int().positive().optional().describe("Filter by product variant id"),
+	location_id: z.int().positive().optional().describe("Filter by location id"),
+	order_no: z.string().min(1).optional().describe("Filter by order number"),
+	...listCursorFields
+});
+const katanaListManufacturingOrdersOutputSchema = z.object({
+	items: z.array(katanaManufacturingOrderSchema),
+	...listOutputMeta
+});
+const katanaGetManufacturingOrderInputSchema = z.object({ manufacturing_order_id: z.int().positive().describe("Manufacturing order id") });
+const katanaGetManufacturingOrderOutputSchema = z.object({ manufacturing_order: katanaManufacturingOrderSchema });
+const katanaCreateManufacturingOrderInputSchema = z.object({
+	variant_id: z.int().positive().describe("Product variant id to manufacture"),
+	location_id: z.int().positive().describe("Production location id"),
+	planned_quantity: z.number().positive().describe("Planned production quantity"),
+	order_no: z.string().min(1).optional().describe("Order number"),
+	order_created_date: z.string().min(1).optional().describe("Order created date (ISO 8601)"),
+	production_deadline_date: z.string().min(1).optional().describe("Production deadline (ISO 8601)"),
+	additional_info: z.string().optional().describe("Internal notes"),
+	status: z.string().min(1).optional().describe("Initial status (NOT_STARTED)")
+});
+const katanaCreateManufacturingOrderOutputSchema = katanaGetManufacturingOrderOutputSchema;
+const katanaUpdateManufacturingOrderInputSchema = z.object({
+	manufacturing_order_id: z.int().positive().describe("Manufacturing order id"),
+	order_no: z.string().min(1).optional().describe("Order number"),
+	planned_quantity: z.number().positive().optional().describe("Planned production quantity"),
+	actual_quantity: z.number().min(0).optional().describe("Actual produced quantity"),
+	order_created_date: z.string().min(1).optional().describe("Order created date (ISO 8601)"),
+	production_deadline_date: z.string().min(1).optional().describe("Production deadline (ISO 8601)"),
+	additional_info: z.string().optional().describe("Internal notes"),
+	status: z.string().min(1).optional().describe("Manufacturing order status")
+});
+const katanaUpdateManufacturingOrderOutputSchema = katanaGetManufacturingOrderOutputSchema;
+const katanaInventorySchema = z.object({
+	variant_id: z.number(),
+	location_id: z.number(),
+	quantity_in_stock: z.number().optional(),
+	quantity_committed: z.number().optional(),
+	quantity_expected: z.number().optional(),
+	quantity_missing_or_excess: z.number().optional(),
+	safety_stock_level: z.number().optional(),
+	average_cost: z.number().optional(),
+	value_in_stock: z.number().optional()
+});
+const katanaListInventoryInputSchema = z.object({
+	variant_id: z.int().positive().optional().describe("Filter by variant id"),
+	location_id: z.int().positive().optional().describe("Filter by location id"),
+	...listCursorFields
+});
+const katanaListInventoryOutputSchema = z.object({
+	items: z.array(katanaInventorySchema),
+	...listOutputMeta
+});
+//#endregion
+//#region src/vendors/katana/domain.ts
+/**
+* Katana MRP payload helpers (no HTTP).
+*/
+const KATANA_API_BASE = "https://api.katanamrp.com/v1";
+function pageFromCursor(cursor) {
+	if (!cursor) return 1;
+	const n = Number.parseInt(cursor, 10);
+	if (!Number.isFinite(n) || n < 1) throw new ToolError("Invalid list cursor", {
+		code: "bad_input",
+		details: { cursor }
+	});
+	return n;
+}
+function listPageMeta(page, limit, itemCount, totalPages) {
+	if (typeof totalPages === "number" && totalPages > page) return {
+		next_cursor: String(page + 1),
+		truncated: true
+	};
+	if (itemCount >= limit && totalPages === void 0) return {
+		next_cursor: String(page + 1),
+		truncated: true
+	};
+	return { truncated: false };
+}
+function optionalString(value) {
+	return isString(value) ? value : void 0;
+}
+function optionalNumber(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (isString(value) && value.trim().length > 0) {
+		const n = Number(value);
+		if (Number.isFinite(n)) return n;
+	}
+}
+function optionalBoolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+function unwrapResource(data) {
+	if (isPlainObject(data) && "data" in data) return data["data"];
+	return data;
+}
+function parseListEnvelope(data, parseItem, label) {
+	if (Array.isArray(data)) return { items: data.map(parseItem) };
+	if (!isPlainObject(data)) throw new ToolError(`Katana returned an unexpected ${label} payload`, { code: "upstream" });
+	const rows = data["data"];
+	if (!Array.isArray(rows)) throw new ToolError(`Katana ${label} missing data array`, { code: "upstream" });
+	const pagination = data["pagination"];
+	let totalPages;
+	if (isPlainObject(pagination) && typeof pagination["total_pages"] === "number") totalPages = pagination["total_pages"];
+	return {
+		items: rows.map(parseItem),
+		...totalPages !== void 0 && { totalPages }
+	};
+}
+function parseSalesOrder(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid sales order", { code: "upstream" });
+	const total = optionalNumber(value["total"] ?? value["total_price"]);
+	const orderNo = optionalString(value["order_no"]);
+	const status = optionalString(value["status"]);
+	const customerId = optionalNumber(value["customer_id"]);
+	const orderCreatedDate = optionalString(value["order_created_date"]);
+	const deliveryDate = optionalString(value["delivery_date"]);
+	const locationId = optionalNumber(value["location_id"]);
+	const currency = optionalString(value["currency"]);
+	const additionalInfo = optionalString(value["additional_info"]);
+	const customerRef = optionalString(value["customer_ref"]);
+	const createdAt = optionalString(value["created_at"]);
+	return {
+		id: value["id"],
+		...orderNo && { order_no: orderNo },
+		...status && { status },
+		...customerId !== void 0 && { customer_id: customerId },
+		...orderCreatedDate && { order_created_date: orderCreatedDate },
+		...deliveryDate && { delivery_date: deliveryDate },
+		...locationId !== void 0 && { location_id: locationId },
+		...currency && { currency },
+		...total !== void 0 && { total },
+		...additionalInfo !== void 0 && { additional_info: additionalInfo },
+		...customerRef !== void 0 && { customer_ref: customerRef },
+		...createdAt && { created_at: createdAt }
+	};
+}
+/**
+* Wire query params for GET /sales_orders date windows.
+* Spike (Katana docs): `created_at_min` / `created_at_max` only — no `order_created_date` list filter.
+* `order_created_*` scopes are applied client-side after list (see matchOrderCreatedDateScope).
+*/
+function salesOrderListDateQuery(scope) {
+	const out = {};
+	if (scope.created_from) out["created_at_min"] = scope.created_from;
+	return out;
+}
+/** Client-side filter for order_created_date when the list endpoint cannot express it. */
+function matchOrderCreatedDateScope(orderCreatedDate, scope) {
+	if (!scope.order_created_from && !scope.order_created_to) return true;
+	if (!orderCreatedDate) return false;
+	if (scope.order_created_from && orderCreatedDate < scope.order_created_from) return false;
+	if (scope.order_created_to && orderCreatedDate > scope.order_created_to) return false;
+	return true;
+}
+/**
+* Convert a major-unit money amount to safe integer cents.
+* Rounds half away from zero via Math.round after * 100.
+*/
+function moneyToSafeCents(amount) {
+	if (!Number.isFinite(amount)) throw new ToolError("Invalid money amount for cents conversion", {
+		code: "upstream",
+		details: { amount }
+	});
+	const cents = Math.round(amount * 100);
+	if (!Number.isSafeInteger(cents)) throw new ToolError("Money amount exceeds safe integer cents range", {
+		code: "upstream",
+		details: { amount }
+	});
+	return cents;
+}
+/** Line revenue cents: quantity * price_per_unit - total_discount (tax exclusive). */
+function lineTaxExclusiveTotalCents(quantity, pricePerUnit, totalDiscount) {
+	return moneyToSafeCents(quantity * pricePerUnit - totalDiscount);
+}
+function parseSalesOrderRow(value) {
+	if (!isPlainObject(value)) throw new ToolError("Katana returned an invalid sales order row", { code: "upstream" });
+	const salesOrderId = optionalNumber(value["sales_order_id"]);
+	const quantity = optionalNumber(value["quantity"]);
+	if (salesOrderId === void 0 || quantity === void 0) throw new ToolError("Katana sales order row missing sales_order_id or quantity", { code: "upstream" });
+	const pricePerUnit = optionalNumber(value["price_per_unit"]) ?? 0;
+	const totalDiscount = optionalNumber(value["total_discount"]) ?? 0;
+	const variantId = optionalNumber(value["variant_id"]);
+	const variant = value["variant"];
+	let sku = optionalString(value["sku"]);
+	let unitCost;
+	if (isPlainObject(variant)) {
+		sku = sku ?? optionalString(variant["sku"]);
+		unitCost = optionalNumber(variant["purchase_price"]) ?? optionalNumber(variant["average_cost"]) ?? optionalNumber(variant["cost_per_unit"]);
+	}
+	return {
+		sales_order_id: salesOrderId,
+		quantity,
+		price_per_unit: pricePerUnit,
+		total_discount: totalDiscount,
+		...variantId !== void 0 && { variant_id: variantId },
+		...sku && { sku },
+		...unitCost !== void 0 && { unit_cost: unitCost }
+	};
+}
+function normalizeSalesOrderRow(rows) {
+	return rows.map((row) => ({
+		quantity: row.quantity,
+		tax_exclusive_total_cents: lineTaxExclusiveTotalCents(row.quantity, row.price_per_unit, row.total_discount),
+		cogs_value_cents: moneyToSafeCents((row.unit_cost ?? 0) * row.quantity),
+		...row.sku && { sku: row.sku }
+	}));
+}
+function normalizeSalesOrderHeader(order, customerName, rows) {
+	return {
+		id: order.id,
+		...order.created_at && { created_at: order.created_at },
+		...order.order_created_date && { order_created_date: order.order_created_date },
+		...order.order_no && { order_no: order.order_no },
+		...order.status && { status: order.status },
+		...order.customer_id !== void 0 && { customer_id: order.customer_id },
+		...customerName && { customer_name: customerName },
+		rows
+	};
+}
+/** Parse optional created_at onto a sales order (used by composite enrichment). */
+function parseSalesOrderCreatedAt(value) {
+	if (!isPlainObject(value)) return void 0;
+	return optionalString(value["created_at"]);
+}
+function parseProduct(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid product", { code: "upstream" });
+	const name = optionalString(value["name"]);
+	const uom = optionalString(value["uom"]);
+	const categoryName = optionalString(value["category_name"]);
+	const isSellable = optionalBoolean(value["is_sellable"]);
+	const isProducible = optionalBoolean(value["is_producible"]);
+	const isPurchasable = optionalBoolean(value["is_purchasable"]);
+	const type = optionalString(value["type"]);
+	const defaultSupplierId = optionalNumber(value["default_supplier_id"]);
+	const additionalInfo = optionalString(value["additional_info"]);
+	return {
+		id: value["id"],
+		...name && { name },
+		...uom && { uom },
+		...categoryName && { category_name: categoryName },
+		...isSellable !== void 0 && { is_sellable: isSellable },
+		...isProducible !== void 0 && { is_producible: isProducible },
+		...isPurchasable !== void 0 && { is_purchasable: isPurchasable },
+		...type && { type },
+		...defaultSupplierId !== void 0 && { default_supplier_id: defaultSupplierId },
+		...additionalInfo !== void 0 && { additional_info: additionalInfo }
+	};
+}
+function parseMaterial(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid material", { code: "upstream" });
+	const name = optionalString(value["name"]);
+	const uom = optionalString(value["uom"]);
+	const categoryName = optionalString(value["category_name"]);
+	const isSellable = optionalBoolean(value["is_sellable"]);
+	const type = optionalString(value["type"]);
+	const defaultSupplierId = optionalNumber(value["default_supplier_id"]);
+	const additionalInfo = optionalString(value["additional_info"]);
+	return {
+		id: value["id"],
+		...name && { name },
+		...uom && { uom },
+		...categoryName && { category_name: categoryName },
+		...isSellable !== void 0 && { is_sellable: isSellable },
+		...type && { type },
+		...defaultSupplierId !== void 0 && { default_supplier_id: defaultSupplierId },
+		...additionalInfo !== void 0 && { additional_info: additionalInfo }
+	};
+}
+function parseCustomer(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid customer", { code: "upstream" });
+	const name = optionalString(value["name"]);
+	const firstName = optionalString(value["first_name"]);
+	const lastName = optionalString(value["last_name"]);
+	const company = optionalString(value["company"]);
+	const email = optionalString(value["email"]);
+	const phone = optionalString(value["phone"]);
+	const currency = optionalString(value["currency"]);
+	const comment = optionalString(value["comment"]);
+	const referenceId = optionalString(value["reference_id"]);
+	const category = optionalString(value["category"]);
+	return {
+		id: value["id"],
+		...name && { name },
+		...firstName !== void 0 && { first_name: firstName },
+		...lastName !== void 0 && { last_name: lastName },
+		...company !== void 0 && { company },
+		...email !== void 0 && { email },
+		...phone !== void 0 && { phone },
+		...currency && { currency },
+		...comment !== void 0 && { comment },
+		...referenceId !== void 0 && { reference_id: referenceId },
+		...category !== void 0 && { category }
+	};
+}
+function parseSupplier(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid supplier", { code: "upstream" });
+	const name = optionalString(value["name"]);
+	const email = optionalString(value["email"]);
+	const phone = optionalString(value["phone"]);
+	const currency = optionalString(value["currency"]);
+	const comment = optionalString(value["comment"]);
+	return {
+		id: value["id"],
+		...name && { name },
+		...email !== void 0 && { email },
+		...phone !== void 0 && { phone },
+		...currency && { currency },
+		...comment !== void 0 && { comment }
+	};
+}
+function parsePurchaseOrder(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid purchase order", { code: "upstream" });
+	const orderNo = optionalString(value["order_no"]);
+	const status = optionalString(value["status"]);
+	const supplierId = optionalNumber(value["supplier_id"]);
+	const locationId = optionalNumber(value["location_id"]);
+	const currency = optionalString(value["currency"]);
+	const entityType = optionalString(value["entity_type"]);
+	const orderCreatedDate = optionalString(value["order_created_date"]);
+	const expectedArrivalDate = optionalString(value["expected_arrival_date"]);
+	const total = optionalNumber(value["total"]);
+	const additionalInfo = optionalString(value["additional_info"]);
+	return {
+		id: value["id"],
+		...orderNo && { order_no: orderNo },
+		...status && { status },
+		...supplierId !== void 0 && { supplier_id: supplierId },
+		...locationId !== void 0 && { location_id: locationId },
+		...currency && { currency },
+		...entityType && { entity_type: entityType },
+		...orderCreatedDate && { order_created_date: orderCreatedDate },
+		...expectedArrivalDate && { expected_arrival_date: expectedArrivalDate },
+		...total !== void 0 && { total },
+		...additionalInfo !== void 0 && { additional_info: additionalInfo }
+	};
+}
+function parseManufacturingOrder(value) {
+	if (!isPlainObject(value) || typeof value["id"] !== "number") throw new ToolError("Katana returned an invalid manufacturing order", { code: "upstream" });
+	const orderNo = optionalString(value["order_no"]);
+	const status = optionalString(value["status"]);
+	const variantId = optionalNumber(value["variant_id"]);
+	const locationId = optionalNumber(value["location_id"]);
+	const plannedQuantity = optionalNumber(value["planned_quantity"]);
+	const actualQuantity = optionalNumber(value["actual_quantity"]);
+	const orderCreatedDate = optionalString(value["order_created_date"]);
+	const productionDeadlineDate = optionalString(value["production_deadline_date"]);
+	const ingredientAvailability = optionalString(value["ingredient_availability"]);
+	const additionalInfo = optionalString(value["additional_info"]);
+	const salesOrderId = optionalNumber(value["sales_order_id"]);
+	return {
+		id: value["id"],
+		...orderNo && { order_no: orderNo },
+		...status && { status },
+		...variantId !== void 0 && { variant_id: variantId },
+		...locationId !== void 0 && { location_id: locationId },
+		...plannedQuantity !== void 0 && { planned_quantity: plannedQuantity },
+		...actualQuantity !== void 0 && { actual_quantity: actualQuantity },
+		...orderCreatedDate && { order_created_date: orderCreatedDate },
+		...productionDeadlineDate && { production_deadline_date: productionDeadlineDate },
+		...ingredientAvailability && { ingredient_availability: ingredientAvailability },
+		...additionalInfo !== void 0 && { additional_info: additionalInfo },
+		...salesOrderId !== void 0 && { sales_order_id: salesOrderId }
+	};
+}
+function parseInventory(value) {
+	if (!isPlainObject(value) || typeof value["variant_id"] !== "number" || typeof value["location_id"] !== "number") throw new ToolError("Katana returned an invalid inventory row", { code: "upstream" });
+	const quantityInStock = optionalNumber(value["quantity_in_stock"]);
+	const quantityCommitted = optionalNumber(value["quantity_committed"]);
+	const quantityExpected = optionalNumber(value["quantity_expected"]);
+	const quantityMissingOrExcess = optionalNumber(value["quantity_missing_or_excess"]);
+	const safetyStockLevel = optionalNumber(value["safety_stock_level"]);
+	const averageCost = optionalNumber(value["average_cost"]);
+	const valueInStock = optionalNumber(value["value_in_stock"]);
+	return {
+		variant_id: value["variant_id"],
+		location_id: value["location_id"],
+		...quantityInStock !== void 0 && { quantity_in_stock: quantityInStock },
+		...quantityCommitted !== void 0 && { quantity_committed: quantityCommitted },
+		...quantityExpected !== void 0 && { quantity_expected: quantityExpected },
+		...quantityMissingOrExcess !== void 0 && { quantity_missing_or_excess: quantityMissingOrExcess },
+		...safetyStockLevel !== void 0 && { safety_stock_level: safetyStockLevel },
+		...averageCost !== void 0 && { average_cost: averageCost },
+		...valueInStock !== void 0 && { value_in_stock: valueInStock }
+	};
+}
+function salesOrderRowBody(row) {
+	return {
+		quantity: row.quantity,
+		variant_id: row.variant_id,
+		...row.tax_rate_id !== void 0 && { tax_rate_id: row.tax_rate_id },
+		...row.location_id !== void 0 && { location_id: row.location_id },
+		...row.price_per_unit !== void 0 && { price_per_unit: row.price_per_unit },
+		...row.total_discount !== void 0 && { total_discount: row.total_discount }
+	};
+}
+function salesOrderCreateBody(input) {
+	return {
+		customer_id: input.customer_id,
+		sales_order_rows: input.sales_order_rows.map(salesOrderRowBody),
+		...input.order_no && { order_no: input.order_no },
+		...input.order_created_date && { order_created_date: input.order_created_date },
+		...input.delivery_date && { delivery_date: input.delivery_date },
+		...input.currency && { currency: input.currency },
+		...input.location_id !== void 0 && { location_id: input.location_id },
+		...input.status && { status: input.status },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info },
+		...input.customer_ref !== void 0 && { customer_ref: input.customer_ref }
+	};
+}
+function salesOrderUpdateBody(input) {
+	return {
+		...input.order_no && { order_no: input.order_no },
+		...input.customer_id !== void 0 && { customer_id: input.customer_id },
+		...input.order_created_date && { order_created_date: input.order_created_date },
+		...input.delivery_date && { delivery_date: input.delivery_date },
+		...input.location_id !== void 0 && { location_id: input.location_id },
+		...input.status && { status: input.status },
+		...input.currency && { currency: input.currency },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info },
+		...input.customer_ref !== void 0 && { customer_ref: input.customer_ref }
+	};
+}
+function productVariantBody(variant) {
+	return {
+		...variant.sku && { sku: variant.sku },
+		...variant.sales_price !== void 0 && { sales_price: variant.sales_price },
+		...variant.purchase_price !== void 0 && { purchase_price: variant.purchase_price }
+	};
+}
+function productCreateBody(input) {
+	return {
+		name: input.name,
+		variants: input.variants.map(productVariantBody),
+		...input.uom && { uom: input.uom },
+		...input.category_name && { category_name: input.category_name },
+		...input.is_sellable !== void 0 && { is_sellable: input.is_sellable },
+		...input.is_producible !== void 0 && { is_producible: input.is_producible },
+		...input.is_purchasable !== void 0 && { is_purchasable: input.is_purchasable },
+		...input.is_auto_assembly !== void 0 && { is_auto_assembly: input.is_auto_assembly },
+		...input.default_supplier_id !== void 0 && { default_supplier_id: input.default_supplier_id },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info },
+		...input.batch_tracked !== void 0 && { batch_tracked: input.batch_tracked },
+		...input.serial_tracked !== void 0 && { serial_tracked: input.serial_tracked }
+	};
+}
+function productUpdateBody(input) {
+	return {
+		...input.name && { name: input.name },
+		...input.uom && { uom: input.uom },
+		...input.category_name !== void 0 && { category_name: input.category_name },
+		...input.is_sellable !== void 0 && { is_sellable: input.is_sellable },
+		...input.is_producible !== void 0 && { is_producible: input.is_producible },
+		...input.is_purchasable !== void 0 && { is_purchasable: input.is_purchasable },
+		...input.is_auto_assembly !== void 0 && { is_auto_assembly: input.is_auto_assembly },
+		...input.default_supplier_id !== void 0 && { default_supplier_id: input.default_supplier_id },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info },
+		...input.batch_tracked !== void 0 && { batch_tracked: input.batch_tracked },
+		...input.serial_tracked !== void 0 && { serial_tracked: input.serial_tracked }
+	};
+}
+function customerWriteBody(input) {
+	const name = "name" in input ? input.name : void 0;
+	return {
+		...name && { name },
+		...input.first_name !== void 0 && { first_name: input.first_name },
+		...input.last_name !== void 0 && { last_name: input.last_name },
+		...input.company !== void 0 && { company: input.company },
+		...input.email !== void 0 && { email: input.email },
+		...input.phone !== void 0 && { phone: input.phone },
+		...input.currency && { currency: input.currency },
+		...input.reference_id !== void 0 && { reference_id: input.reference_id },
+		...input.category !== void 0 && { category: input.category },
+		...input.comment !== void 0 && { comment: input.comment },
+		...input.discount_rate !== void 0 && { discount_rate: input.discount_rate }
+	};
+}
+function supplierCreateBody(input) {
+	return {
+		name: input.name,
+		...input.currency && { currency: input.currency },
+		...input.email !== void 0 && { email: input.email },
+		...input.phone !== void 0 && { phone: input.phone },
+		...input.comment !== void 0 && { comment: input.comment }
+	};
+}
+function purchaseOrderRowBody(row) {
+	return {
+		quantity: row.quantity,
+		variant_id: row.variant_id,
+		price_per_unit: row.price_per_unit,
+		...row.tax_rate_id !== void 0 && { tax_rate_id: row.tax_rate_id },
+		...row.purchase_uom && { purchase_uom: row.purchase_uom },
+		...row.purchase_uom_conversion_rate !== void 0 && { purchase_uom_conversion_rate: row.purchase_uom_conversion_rate },
+		...row.arrival_date && { arrival_date: row.arrival_date }
+	};
+}
+function purchaseOrderCreateBody(input) {
+	return {
+		supplier_id: input.supplier_id,
+		location_id: input.location_id,
+		purchase_order_rows: input.purchase_order_rows.map(purchaseOrderRowBody),
+		...input.order_no && { order_no: input.order_no },
+		...input.entity_type && { entity_type: input.entity_type },
+		...input.currency && { currency: input.currency },
+		...input.status && { status: input.status },
+		...input.expected_arrival_date && { expected_arrival_date: input.expected_arrival_date },
+		...input.order_created_date && { order_created_date: input.order_created_date },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info }
+	};
+}
+function purchaseOrderUpdateBody(input) {
+	return {
+		...input.order_no && { order_no: input.order_no },
+		...input.supplier_id !== void 0 && { supplier_id: input.supplier_id },
+		...input.location_id !== void 0 && { location_id: input.location_id },
+		...input.currency && { currency: input.currency },
+		...input.status && { status: input.status },
+		...input.expected_arrival_date && { expected_arrival_date: input.expected_arrival_date },
+		...input.order_created_date && { order_created_date: input.order_created_date },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info }
+	};
+}
+function manufacturingOrderCreateBody(input) {
+	return {
+		variant_id: input.variant_id,
+		location_id: input.location_id,
+		planned_quantity: input.planned_quantity,
+		...input.order_no && { order_no: input.order_no },
+		...input.order_created_date && { order_created_date: input.order_created_date },
+		...input.production_deadline_date && { production_deadline_date: input.production_deadline_date },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info },
+		...input.status && { status: input.status }
+	};
+}
+function manufacturingOrderUpdateBody(input) {
+	return {
+		...input.order_no && { order_no: input.order_no },
+		...input.planned_quantity !== void 0 && { planned_quantity: input.planned_quantity },
+		...input.actual_quantity !== void 0 && { actual_quantity: input.actual_quantity },
+		...input.order_created_date && { order_created_date: input.order_created_date },
+		...input.production_deadline_date && { production_deadline_date: input.production_deadline_date },
+		...input.additional_info !== void 0 && { additional_info: input.additional_info },
+		...input.status && { status: input.status }
+	};
+}
+//#endregion
+//#region src/vendors/katana/client.ts
+/**
+* Katana MRP vendor client.
+* Host: `new KatanaClient(auth)`. Agent tools: `fromContext(ctx)`.
+*/
+var KatanaClient = class KatanaClient {
+	#http;
+	constructor(auth, options = {}) {
+		const parsed = katanaAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid Katana auth credentials", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		this.#http = new HttpService({
+			...options,
+			baseURL: KATANA_API_BASE,
+			headers: {
+				Authorization: `Bearer ${parsed.data.api_key}`,
+				"Content-Type": "application/json"
+			},
+			label: "Katana"
+		});
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, katanaAuthSchema);
+		return new KatanaClient(auth, {
+			...ctx.fetch && { fetch: ctx.fetch },
+			...ctx.signal && { signal: ctx.signal }
+		});
+	}
+	/** GET /sales_orders */
+	async listSalesOrders(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/sales_orders", {
+			label: "Katana listSalesOrders",
+			query: {
+				page,
+				limit,
+				...input.status && { status: input.status },
+				...input.customer_id !== void 0 && { customer_id: input.customer_id },
+				...input.order_no && { order_no: input.order_no },
+				...input.location_id !== void 0 && { location_id: input.location_id }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseSalesOrder, "sales orders");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /sales_orders/{id} */
+	async getSalesOrder(input) {
+		const { data } = await this.#http.get(`/sales_orders/${input.sales_order_id}`, { label: "Katana getSalesOrder" });
+		return { sales_order: parseSalesOrder(unwrapResource(data)) };
+	}
+	/** POST /sales_orders */
+	async createSalesOrder(input) {
+		const { data } = await this.#http.post("/sales_orders", salesOrderCreateBody(input), { label: "Katana createSalesOrder" });
+		return { sales_order: parseSalesOrder(unwrapResource(data)) };
+	}
+	/** PATCH /sales_orders/{id} */
+	async updateSalesOrder(input) {
+		const { sales_order_id, ...fields } = input;
+		const { data } = await this.#http.patch(`/sales_orders/${sales_order_id}`, salesOrderUpdateBody(fields), { label: "Katana updateSalesOrder" });
+		return { sales_order: parseSalesOrder(unwrapResource(data)) };
+	}
+	/** DELETE /sales_orders/{id} */
+	async deleteSalesOrder(input) {
+		await this.#http.delete(`/sales_orders/${input.sales_order_id}`, { label: "Katana deleteSalesOrder" });
+		return {
+			deleted: true,
+			id: input.sales_order_id
+		};
+	}
+	/**
+	* Composite sales-order query for reporting/reconciliation.
+	* Multi-scope × multi-status sequential pagination, dedupe by id, customer + row enrichment.
+	*
+	* API spike (GET /sales_orders): created_at_min/max, single status, customer_id, location_id.
+	* order_created_date ranges are client-side (no list filter). Rows via GET /sales_order_rows
+	* with sales_order_ids + extend=variant.
+	*/
+	async querySalesOrders(input) {
+		const maxPages = input.max_pages_per_list ?? 20;
+		const pageSize = input.page_size ?? 50;
+		const byId = /* @__PURE__ */ new Map();
+		for (const scope of input.scopes) {
+			const statuses = scope.statuses && scope.statuses.length > 0 ? scope.statuses : [void 0];
+			const dateQuery = salesOrderListDateQuery(scope);
+			for (const status of statuses) {
+				let cursor;
+				for (let page = 0; page < maxPages; page += 1) {
+					const pageNum = pageFromCursor(cursor);
+					const { data } = await this.#http.get("/sales_orders", {
+						label: "Katana querySalesOrders list",
+						query: {
+							page: pageNum,
+							limit: pageSize,
+							...status && { status },
+							...scope.customer_id !== void 0 && { customer_id: scope.customer_id },
+							...scope.location_id !== void 0 && { location_id: scope.location_id },
+							...dateQuery
+						}
+					});
+					const parsed = parseListEnvelope(data, parseSalesOrder, "sales orders");
+					for (const order of parsed.items) {
+						if (byId.has(order.id)) continue;
+						if (!matchOrderCreatedDateScope(order.order_created_date, scope)) continue;
+						const rawCreated = parseSalesOrderCreatedAt((isPlainObject(data) && Array.isArray(data["data"]) ? data["data"] : Array.isArray(data) ? data : []).find((r) => isPlainObject(r) && r["id"] === order.id)) ?? order.created_at;
+						byId.set(order.id, {
+							...order,
+							...rawCreated && { created_at: rawCreated }
+						});
+					}
+					const pageMeta = listPageMeta(pageNum, pageSize, parsed.items.length, parsed.totalPages);
+					if (!pageMeta.next_cursor) break;
+					cursor = pageMeta.next_cursor;
+				}
+			}
+		}
+		const orderIds = [...byId.keys()];
+		const customerCache = /* @__PURE__ */ new Map();
+		const rowsByOrder = /* @__PURE__ */ new Map();
+		const chunkSize = 50;
+		for (let i = 0; i < orderIds.length; i += chunkSize) {
+			const chunk = orderIds.slice(i, i + chunkSize);
+			const rows = await this.#listSalesOrderRowsForOrders(chunk);
+			for (const row of rows) {
+				const list = rowsByOrder.get(row.sales_order_id) ?? [];
+				list.push(row);
+				rowsByOrder.set(row.sales_order_id, list);
+			}
+		}
+		for (const order of byId.values()) {
+			if (order.customer_id === void 0 || customerCache.has(order.customer_id)) continue;
+			try {
+				const { customer } = await this.getCustomer({ customer_id: order.customer_id });
+				const combined = [customer.first_name, customer.last_name].filter(Boolean).join(" ");
+				const name = customer.name ?? (combined.length > 0 ? combined : void 0) ?? customer.company;
+				customerCache.set(order.customer_id, name && name.length > 0 ? name : void 0);
+			} catch {
+				customerCache.set(order.customer_id, void 0);
+			}
+		}
+		const orders = orderIds.map((id) => {
+			const order = byId.get(id);
+			if (!order) throw new ToolError("Internal order map missing id", { code: "internal" });
+			const rows = normalizeSalesOrderRow(rowsByOrder.get(id) ?? []);
+			return normalizeSalesOrderHeader(order, order.customer_id !== void 0 ? customerCache.get(order.customer_id) : void 0, rows);
+		});
+		return {
+			orders,
+			order_count: orders.length
+		};
+	}
+	async #listSalesOrderRowsForOrders(salesOrderIds) {
+		if (salesOrderIds.length === 0) return [];
+		const pageSize = 250;
+		const out = [];
+		let cursor;
+		for (let page = 0; page < 100; page += 1) {
+			const pageNum = pageFromCursor(cursor);
+			const { data } = await this.#http.get("/sales_order_rows", {
+				label: "Katana listSalesOrderRows",
+				query: {
+					page: pageNum,
+					limit: pageSize,
+					sales_order_ids: salesOrderIds.join(","),
+					extend: "variant"
+				}
+			});
+			const parsed = parseListEnvelope(data, parseSalesOrderRow, "sales order rows");
+			out.push(...parsed.items);
+			const pageMeta = listPageMeta(pageNum, pageSize, parsed.items.length, parsed.totalPages);
+			if (!pageMeta.next_cursor) break;
+			cursor = pageMeta.next_cursor;
+		}
+		return out;
+	}
+	/** GET /products */
+	async listProducts(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/products", {
+			label: "Katana listProducts",
+			query: {
+				page,
+				limit,
+				...input.name && { name: input.name },
+				...input.is_sellable !== void 0 && { is_sellable: input.is_sellable },
+				...input.is_producible !== void 0 && { is_producible: input.is_producible },
+				...input.is_purchasable !== void 0 && { is_purchasable: input.is_purchasable }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseProduct, "products");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /products/{id} */
+	async getProduct(input) {
+		const { data } = await this.#http.get(`/products/${input.product_id}`, { label: "Katana getProduct" });
+		return { product: parseProduct(unwrapResource(data)) };
+	}
+	/** POST /products */
+	async createProduct(input) {
+		const { data } = await this.#http.post("/products", productCreateBody(input), { label: "Katana createProduct" });
+		return { product: parseProduct(unwrapResource(data)) };
+	}
+	/** PATCH /products/{id} */
+	async updateProduct(input) {
+		const { product_id, ...fields } = input;
+		const { data } = await this.#http.patch(`/products/${product_id}`, productUpdateBody(fields), { label: "Katana updateProduct" });
+		return { product: parseProduct(unwrapResource(data)) };
+	}
+	/** GET /materials */
+	async listMaterials(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/materials", {
+			label: "Katana listMaterials",
+			query: {
+				page,
+				limit,
+				...input.name && { name: input.name }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseMaterial, "materials");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /materials/{id} */
+	async getMaterial(input) {
+		const { data } = await this.#http.get(`/materials/${input.material_id}`, { label: "Katana getMaterial" });
+		return { material: parseMaterial(unwrapResource(data)) };
+	}
+	/** GET /customers */
+	async listCustomers(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/customers", {
+			label: "Katana listCustomers",
+			query: {
+				page,
+				limit,
+				...input.name && { name: input.name },
+				...input.email && { email: input.email }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseCustomer, "customers");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /customers/{id} */
+	async getCustomer(input) {
+		const { data } = await this.#http.get(`/customers/${input.customer_id}`, { label: "Katana getCustomer" });
+		return { customer: parseCustomer(unwrapResource(data)) };
+	}
+	/** POST /customers */
+	async createCustomer(input) {
+		const { data } = await this.#http.post("/customers", customerWriteBody(input), { label: "Katana createCustomer" });
+		return { customer: parseCustomer(unwrapResource(data)) };
+	}
+	/** PATCH /customers/{id} */
+	async updateCustomer(input) {
+		const { customer_id, ...fields } = input;
+		const { data } = await this.#http.patch(`/customers/${customer_id}`, customerWriteBody(fields), { label: "Katana updateCustomer" });
+		return { customer: parseCustomer(unwrapResource(data)) };
+	}
+	/** GET /suppliers */
+	async listSuppliers(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/suppliers", {
+			label: "Katana listSuppliers",
+			query: {
+				page,
+				limit,
+				...input.name && { name: input.name }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseSupplier, "suppliers");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /suppliers/{id} */
+	async getSupplier(input) {
+		const { data } = await this.#http.get(`/suppliers/${input.supplier_id}`, { label: "Katana getSupplier" });
+		return { supplier: parseSupplier(unwrapResource(data)) };
+	}
+	/** POST /suppliers */
+	async createSupplier(input) {
+		const { data } = await this.#http.post("/suppliers", supplierCreateBody(input), { label: "Katana createSupplier" });
+		return { supplier: parseSupplier(unwrapResource(data)) };
+	}
+	/** GET /purchase_orders */
+	async listPurchaseOrders(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/purchase_orders", {
+			label: "Katana listPurchaseOrders",
+			query: {
+				page,
+				limit,
+				...input.status && { status: input.status },
+				...input.supplier_id !== void 0 && { supplier_id: input.supplier_id },
+				...input.order_no && { order_no: input.order_no },
+				...input.location_id !== void 0 && { location_id: input.location_id }
+			}
+		});
+		const parsed = parseListEnvelope(data, parsePurchaseOrder, "purchase orders");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /purchase_orders/{id} */
+	async getPurchaseOrder(input) {
+		const { data } = await this.#http.get(`/purchase_orders/${input.purchase_order_id}`, { label: "Katana getPurchaseOrder" });
+		return { purchase_order: parsePurchaseOrder(unwrapResource(data)) };
+	}
+	/** POST /purchase_orders */
+	async createPurchaseOrder(input) {
+		const { data } = await this.#http.post("/purchase_orders", purchaseOrderCreateBody(input), { label: "Katana createPurchaseOrder" });
+		return { purchase_order: parsePurchaseOrder(unwrapResource(data)) };
+	}
+	/** PATCH /purchase_orders/{id} */
+	async updatePurchaseOrder(input) {
+		const { purchase_order_id, ...fields } = input;
+		const { data } = await this.#http.patch(`/purchase_orders/${purchase_order_id}`, purchaseOrderUpdateBody(fields), { label: "Katana updatePurchaseOrder" });
+		return { purchase_order: parsePurchaseOrder(unwrapResource(data)) };
+	}
+	/** GET /manufacturing_orders */
+	async listManufacturingOrders(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/manufacturing_orders", {
+			label: "Katana listManufacturingOrders",
+			query: {
+				page,
+				limit,
+				...input.status && { status: input.status },
+				...input.variant_id !== void 0 && { variant_id: input.variant_id },
+				...input.location_id !== void 0 && { location_id: input.location_id },
+				...input.order_no && { order_no: input.order_no }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseManufacturingOrder, "manufacturing orders");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+	/** GET /manufacturing_orders/{id} */
+	async getManufacturingOrder(input) {
+		const { data } = await this.#http.get(`/manufacturing_orders/${input.manufacturing_order_id}`, { label: "Katana getManufacturingOrder" });
+		return { manufacturing_order: parseManufacturingOrder(unwrapResource(data)) };
+	}
+	/** POST /manufacturing_orders */
+	async createManufacturingOrder(input) {
+		const { data } = await this.#http.post("/manufacturing_orders", manufacturingOrderCreateBody(input), { label: "Katana createManufacturingOrder" });
+		return { manufacturing_order: parseManufacturingOrder(unwrapResource(data)) };
+	}
+	/** PATCH /manufacturing_orders/{id} */
+	async updateManufacturingOrder(input) {
+		const { manufacturing_order_id, ...fields } = input;
+		const { data } = await this.#http.patch(`/manufacturing_orders/${manufacturing_order_id}`, manufacturingOrderUpdateBody(fields), { label: "Katana updateManufacturingOrder" });
+		return { manufacturing_order: parseManufacturingOrder(unwrapResource(data)) };
+	}
+	/** GET /inventory */
+	async listInventory(input = {}) {
+		const page = pageFromCursor(input.cursor);
+		const limit = input.limit ?? 50;
+		const { data } = await this.#http.get("/inventory", {
+			label: "Katana listInventory",
+			query: {
+				page,
+				limit,
+				...input.variant_id !== void 0 && { variant_id: input.variant_id },
+				...input.location_id !== void 0 && { location_id: input.location_id }
+			}
+		});
+		const parsed = parseListEnvelope(data, parseInventory, "inventory");
+		const pageMeta = listPageMeta(page, limit, parsed.items.length, parsed.totalPages);
+		return {
+			items: parsed.items,
+			truncated: pageMeta.truncated,
+			...pageMeta.next_cursor && { next_cursor: pageMeta.next_cursor }
+		};
+	}
+};
+//#endregion
+//#region src/vendors/katana/module.ts
+const katanaListSalesOrdersTool = defineTool({
+	id: "katana-list-sales-orders",
+	name: "katanaListSalesOrders",
+	description: "List Katana MRP sales orders with optional status, customer, order number, and location filters. Paginate with cursor (page number).",
+	inputSchema: katanaListSalesOrdersInputSchema,
+	outputSchema: katanaListSalesOrdersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listSalesOrders(input)
+});
+const katanaGetSalesOrderTool = defineTool({
+	id: "katana-get-sales-order",
+	name: "katanaGetSalesOrder",
+	description: "Get one Katana MRP sales order by numeric id.",
+	inputSchema: katanaGetSalesOrderInputSchema,
+	outputSchema: katanaGetSalesOrderOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getSalesOrder(input)
+});
+const katanaCreateSalesOrderTool = defineTool({
+	id: "katana-create-sales-order",
+	name: "katanaCreateSalesOrder",
+	description: "Create a Katana MRP sales order (customer_id and sales_order_rows required). Optional order number, dates, currency, location, and status.",
+	inputSchema: katanaCreateSalesOrderInputSchema,
+	outputSchema: katanaCreateSalesOrderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).createSalesOrder(input)
+});
+const katanaUpdateSalesOrderTool = defineTool({
+	id: "katana-update-sales-order",
+	name: "katanaUpdateSalesOrder",
+	description: "Update a Katana MRP sales order by id (status, customer, dates, location, currency, notes, reference).",
+	inputSchema: katanaUpdateSalesOrderInputSchema,
+	outputSchema: katanaUpdateSalesOrderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).updateSalesOrder(input)
+});
+const katanaDeleteSalesOrderTool = defineTool({
+	id: "katana-delete-sales-order",
+	name: "katanaDeleteSalesOrder",
+	description: "Delete a Katana MRP sales order by numeric id.",
+	inputSchema: katanaDeleteSalesOrderInputSchema,
+	outputSchema: katanaDeleteSalesOrderOutputSchema,
+	sideEffect: "delete",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).deleteSalesOrder(input)
+});
+const katanaQuerySalesOrdersTool = defineTool({
+	id: "katana-query-sales-orders",
+	name: "katanaQuerySalesOrders",
+	description: "Composite Katana MRP sales-order query for reporting: multi-scope union (status × date windows), sequential page drain, dedupe by order id, customer name enrichment, and line rows with tax-exclusive revenue and COGS in integer cents. Use when list/get alone are not enough for reconciliation.",
+	inputSchema: katanaQuerySalesOrdersInputSchema,
+	outputSchema: katanaQuerySalesOrdersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).querySalesOrders(input)
+});
+const katanaListProductsTool = defineTool({
+	id: "katana-list-products",
+	name: "katanaListProducts",
+	description: "List Katana MRP products with optional name and sellable/producible/purchasable filters. Paginate with cursor.",
+	inputSchema: katanaListProductsInputSchema,
+	outputSchema: katanaListProductsOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listProducts(input)
+});
+const katanaGetProductTool = defineTool({
+	id: "katana-get-product",
+	name: "katanaGetProduct",
+	description: "Get one Katana MRP product by numeric id.",
+	inputSchema: katanaGetProductInputSchema,
+	outputSchema: katanaGetProductOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getProduct(input)
+});
+const katanaCreateProductTool = defineTool({
+	id: "katana-create-product",
+	name: "katanaCreateProduct",
+	description: "Create a Katana MRP product (name and variants required). Optional UoM, category, sellable/producible/purchasable flags.",
+	inputSchema: katanaCreateProductInputSchema,
+	outputSchema: katanaCreateProductOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).createProduct(input)
+});
+const katanaUpdateProductTool = defineTool({
+	id: "katana-update-product",
+	name: "katanaUpdateProduct",
+	description: "Update a Katana MRP product by id (name, UoM, category, flags, supplier, notes).",
+	inputSchema: katanaUpdateProductInputSchema,
+	outputSchema: katanaUpdateProductOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).updateProduct(input)
+});
+const katanaListMaterialsTool = defineTool({
+	id: "katana-list-materials",
+	name: "katanaListMaterials",
+	description: "List Katana MRP materials with optional name filter. Paginate with cursor.",
+	inputSchema: katanaListMaterialsInputSchema,
+	outputSchema: katanaListMaterialsOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listMaterials(input)
+});
+const katanaGetMaterialTool = defineTool({
+	id: "katana-get-material",
+	name: "katanaGetMaterial",
+	description: "Get one Katana MRP material by numeric id.",
+	inputSchema: katanaGetMaterialInputSchema,
+	outputSchema: katanaGetMaterialOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getMaterial(input)
+});
+const katanaListCustomersTool = defineTool({
+	id: "katana-list-customers",
+	name: "katanaListCustomers",
+	description: "List Katana MRP customers with optional name and email filters. Paginate with cursor.",
+	inputSchema: katanaListCustomersInputSchema,
+	outputSchema: katanaListCustomersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listCustomers(input)
+});
+const katanaGetCustomerTool = defineTool({
+	id: "katana-get-customer",
+	name: "katanaGetCustomer",
+	description: "Get one Katana MRP customer by numeric id.",
+	inputSchema: katanaGetCustomerInputSchema,
+	outputSchema: katanaGetCustomerOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getCustomer(input)
+});
+const katanaCreateCustomerTool = defineTool({
+	id: "katana-create-customer",
+	name: "katanaCreateCustomer",
+	description: "Create a Katana MRP customer (name required). Optional contact fields, currency, category, and discount.",
+	inputSchema: katanaCreateCustomerInputSchema,
+	outputSchema: katanaCreateCustomerOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).createCustomer(input)
+});
+const katanaUpdateCustomerTool = defineTool({
+	id: "katana-update-customer",
+	name: "katanaUpdateCustomer",
+	description: "Update a Katana MRP customer by id (name, contact fields, currency, category, discount).",
+	inputSchema: katanaUpdateCustomerInputSchema,
+	outputSchema: katanaUpdateCustomerOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).updateCustomer(input)
+});
+const katanaListSuppliersTool = defineTool({
+	id: "katana-list-suppliers",
+	name: "katanaListSuppliers",
+	description: "List Katana MRP suppliers with optional name filter. Paginate with cursor.",
+	inputSchema: katanaListSuppliersInputSchema,
+	outputSchema: katanaListSuppliersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listSuppliers(input)
+});
+const katanaGetSupplierTool = defineTool({
+	id: "katana-get-supplier",
+	name: "katanaGetSupplier",
+	description: "Get one Katana MRP supplier by numeric id.",
+	inputSchema: katanaGetSupplierInputSchema,
+	outputSchema: katanaGetSupplierOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getSupplier(input)
+});
+const katanaCreateSupplierTool = defineTool({
+	id: "katana-create-supplier",
+	name: "katanaCreateSupplier",
+	description: "Create a Katana MRP supplier (name required). Optional currency, email, phone, and comment.",
+	inputSchema: katanaCreateSupplierInputSchema,
+	outputSchema: katanaCreateSupplierOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).createSupplier(input)
+});
+const katanaListPurchaseOrdersTool = defineTool({
+	id: "katana-list-purchase-orders",
+	name: "katanaListPurchaseOrders",
+	description: "List Katana MRP purchase orders with optional status, supplier, order number, and location filters. Paginate with cursor.",
+	inputSchema: katanaListPurchaseOrdersInputSchema,
+	outputSchema: katanaListPurchaseOrdersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listPurchaseOrders(input)
+});
+const katanaGetPurchaseOrderTool = defineTool({
+	id: "katana-get-purchase-order",
+	name: "katanaGetPurchaseOrder",
+	description: "Get one Katana MRP purchase order by numeric id.",
+	inputSchema: katanaGetPurchaseOrderInputSchema,
+	outputSchema: katanaGetPurchaseOrderOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getPurchaseOrder(input)
+});
+const katanaCreatePurchaseOrderTool = defineTool({
+	id: "katana-create-purchase-order",
+	name: "katanaCreatePurchaseOrder",
+	description: "Create a Katana MRP purchase order (supplier_id, location_id, and purchase_order_rows required).",
+	inputSchema: katanaCreatePurchaseOrderInputSchema,
+	outputSchema: katanaCreatePurchaseOrderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).createPurchaseOrder(input)
+});
+const katanaUpdatePurchaseOrderTool = defineTool({
+	id: "katana-update-purchase-order",
+	name: "katanaUpdatePurchaseOrder",
+	description: "Update a Katana MRP purchase order by id (status, supplier, location, dates, currency, notes).",
+	inputSchema: katanaUpdatePurchaseOrderInputSchema,
+	outputSchema: katanaUpdatePurchaseOrderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).updatePurchaseOrder(input)
+});
+const katanaListManufacturingOrdersTool = defineTool({
+	id: "katana-list-manufacturing-orders",
+	name: "katanaListManufacturingOrders",
+	description: "List Katana MRP manufacturing orders with optional status, variant, location, and order number filters. Paginate with cursor.",
+	inputSchema: katanaListManufacturingOrdersInputSchema,
+	outputSchema: katanaListManufacturingOrdersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listManufacturingOrders(input)
+});
+const katanaGetManufacturingOrderTool = defineTool({
+	id: "katana-get-manufacturing-order",
+	name: "katanaGetManufacturingOrder",
+	description: "Get one Katana MRP manufacturing order by numeric id.",
+	inputSchema: katanaGetManufacturingOrderInputSchema,
+	outputSchema: katanaGetManufacturingOrderOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).getManufacturingOrder(input)
+});
+const katanaCreateManufacturingOrderTool = defineTool({
+	id: "katana-create-manufacturing-order",
+	name: "katanaCreateManufacturingOrder",
+	description: "Create a Katana MRP manufacturing order (variant_id, location_id, and planned_quantity required). Recipe and operations are generated from the product.",
+	inputSchema: katanaCreateManufacturingOrderInputSchema,
+	outputSchema: katanaCreateManufacturingOrderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).createManufacturingOrder(input)
+});
+const katanaUpdateManufacturingOrderTool = defineTool({
+	id: "katana-update-manufacturing-order",
+	name: "katanaUpdateManufacturingOrder",
+	description: "Update a Katana MRP manufacturing order by id (status, quantities, dates, notes, order number).",
+	inputSchema: katanaUpdateManufacturingOrderInputSchema,
+	outputSchema: katanaUpdateManufacturingOrderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).updateManufacturingOrder(input)
+});
+const katanaListInventoryTool = defineTool({
+	id: "katana-list-inventory",
+	name: "katanaListInventory",
+	description: "List current Katana MRP inventory levels by variant and location. Optional variant_id and location_id filters. Paginate with cursor.",
+	inputSchema: katanaListInventoryInputSchema,
+	outputSchema: katanaListInventoryOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => KatanaClient.fromContext(ctx).listInventory(input)
+});
+const katanaModule = defineModule({
+	id: "katana",
+	title: "Katana",
+	description: "Katana MRP vendor pack: sales orders (including composite query for reporting), products, materials, customers, suppliers, purchase orders, manufacturing orders, and inventory.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: katanaAuthSchema
+	},
+	categories: ["commerce", "inventory"],
+	classification: "pii",
+	tags: ["sales-orders"],
+	tools: [
+		katanaListSalesOrdersTool,
+		katanaGetSalesOrderTool,
+		katanaCreateSalesOrderTool,
+		katanaUpdateSalesOrderTool,
+		katanaDeleteSalesOrderTool,
+		katanaQuerySalesOrdersTool,
+		katanaListProductsTool,
+		katanaGetProductTool,
+		katanaCreateProductTool,
+		katanaUpdateProductTool,
+		katanaListMaterialsTool,
+		katanaGetMaterialTool,
+		katanaListCustomersTool,
+		katanaGetCustomerTool,
+		katanaCreateCustomerTool,
+		katanaUpdateCustomerTool,
+		katanaListSuppliersTool,
+		katanaGetSupplierTool,
+		katanaCreateSupplierTool,
+		katanaListPurchaseOrdersTool,
+		katanaGetPurchaseOrderTool,
+		katanaCreatePurchaseOrderTool,
+		katanaUpdatePurchaseOrderTool,
+		katanaListManufacturingOrdersTool,
+		katanaGetManufacturingOrderTool,
+		katanaCreateManufacturingOrderTool,
+		katanaUpdateManufacturingOrderTool,
+		katanaListInventoryTool
+	]
+});
+//#endregion
+export { KatanaClient, katanaAuthSchema, katanaCreateCustomerInputSchema, katanaCreateCustomerOutputSchema, katanaCreateCustomerTool, katanaCreateManufacturingOrderInputSchema, katanaCreateManufacturingOrderOutputSchema, katanaCreateManufacturingOrderTool, katanaCreateProductInputSchema, katanaCreateProductOutputSchema, katanaCreateProductTool, katanaCreatePurchaseOrderInputSchema, katanaCreatePurchaseOrderOutputSchema, katanaCreatePurchaseOrderTool, katanaCreateSalesOrderInputSchema, katanaCreateSalesOrderOutputSchema, katanaCreateSalesOrderTool, katanaCreateSupplierInputSchema, katanaCreateSupplierOutputSchema, katanaCreateSupplierTool, katanaCustomerSchema, katanaDeleteSalesOrderInputSchema, katanaDeleteSalesOrderOutputSchema, katanaDeleteSalesOrderTool, katanaGetCustomerInputSchema, katanaGetCustomerOutputSchema, katanaGetCustomerTool, katanaGetManufacturingOrderInputSchema, katanaGetManufacturingOrderOutputSchema, katanaGetManufacturingOrderTool, katanaGetMaterialInputSchema, katanaGetMaterialOutputSchema, katanaGetMaterialTool, katanaGetProductInputSchema, katanaGetProductOutputSchema, katanaGetProductTool, katanaGetPurchaseOrderInputSchema, katanaGetPurchaseOrderOutputSchema, katanaGetPurchaseOrderTool, katanaGetSalesOrderInputSchema, katanaGetSalesOrderOutputSchema, katanaGetSalesOrderTool, katanaGetSupplierInputSchema, katanaGetSupplierOutputSchema, katanaGetSupplierTool, katanaInventorySchema, katanaListCustomersInputSchema, katanaListCustomersOutputSchema, katanaListCustomersTool, katanaListInventoryInputSchema, katanaListInventoryOutputSchema, katanaListInventoryTool, katanaListManufacturingOrdersInputSchema, katanaListManufacturingOrdersOutputSchema, katanaListManufacturingOrdersTool, katanaListMaterialsInputSchema, katanaListMaterialsOutputSchema, katanaListMaterialsTool, katanaListProductsInputSchema, katanaListProductsOutputSchema, katanaListProductsTool, katanaListPurchaseOrdersInputSchema, katanaListPurchaseOrdersOutputSchema, katanaListPurchaseOrdersTool, katanaListSalesOrdersInputSchema, katanaListSalesOrdersOutputSchema, katanaListSalesOrdersTool, katanaListSuppliersInputSchema, katanaListSuppliersOutputSchema, katanaListSuppliersTool, katanaManufacturingOrderSchema, katanaMaterialSchema, katanaModule, katanaNormalizedSalesOrderRowSchema, katanaNormalizedSalesOrderSchema, katanaProductSchema, katanaProductVariantInputSchema, katanaPurchaseOrderRowInputSchema, katanaPurchaseOrderSchema, katanaQuerySalesOrderScopeSchema, katanaQuerySalesOrdersInputSchema, katanaQuerySalesOrdersOutputSchema, katanaQuerySalesOrdersTool, katanaSalesOrderRowInputSchema, katanaSalesOrderSchema, katanaSupplierSchema, katanaUpdateCustomerInputSchema, katanaUpdateCustomerOutputSchema, katanaUpdateCustomerTool, katanaUpdateManufacturingOrderInputSchema, katanaUpdateManufacturingOrderOutputSchema, katanaUpdateManufacturingOrderTool, katanaUpdateProductInputSchema, katanaUpdateProductOutputSchema, katanaUpdateProductTool, katanaUpdatePurchaseOrderInputSchema, katanaUpdatePurchaseOrderOutputSchema, katanaUpdatePurchaseOrderTool, katanaUpdateSalesOrderInputSchema, katanaUpdateSalesOrderOutputSchema, katanaUpdateSalesOrderTool };
+
+//# sourceMappingURL=index.js.map