@solidcommerce/mcp-server 2.0.0-alpha.0

package/dist/tools/tasks/check_listing_health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check_listing_health.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/check_listing_health.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuCxB,QAAA,MAAM,kBAAkB,EAAE,UA8GzB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/tools/tasks/check_listing_health.js

@@ -0,0 +1,123 @@
+// =============================================================================
+// src/tools/tasks/check_listing_health.ts
+// Wave: W6 — Stream B (task-shaped MCP tools)
+//
+// Endpoint mapping note:
+//   No /v1/listings/{id} or /v1/listings/{id}/sync-errors exist verbatim.
+//   We compose:
+//     1) GET /v1/listings/list-items?search=<id>          — find the listing
+//     2) GET /v1/listings/ebay-queue                       — pending sync
+//                                                            errors (best
+//                                                            available proxy)
+//     3) GET /v1/reports/inventory/low-stock               — stockout signal
+//   We then derive a {ok, issues:[]} report. Issues are categorised as
+//   "missing_field", "sync_error", "stockout".
+// =============================================================================
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    listing_id: z.string().min(1).describe("List-item id to audit."),
+});
+const checkListingHealth = {
+    name: "check_listing_health",
+    kind: "task",
+    // Aggregates listing-state read across channels; no writes.
+    readOnlyHint: true,
+    description: "Audits a listing for problems: missing required fields, sync/queue errors, and stockouts. Composes 3 reads — list-item lookup, eBay queue (sync errors), and the inventory low-stock report — then returns `{ ok, issues: [...] }`. Use this when the user says 'why isn't listing X showing on the channel' or 'check listing X' — the result tells the LLM exactly which dimension(s) need attention.",
+    required_scope: "listings:read",
+    inputSchema,
+    async handle(args, ctx) {
+        const parsed = inputSchema.parse(args);
+        try {
+            // 1) Resolve the listing.
+            const listRes = await ctx.client.raw.GET("/v1/listings/list-items", {
+                params: { query: { search: parsed.listing_id, page_size: 50 } },
+            });
+            if (listRes.error)
+                throw listRes.error;
+            const page = (listRes.data ?? {});
+            const listing = page.data?.find((li) => {
+                const id = li.id ?? li.list_item_id;
+                return id !== undefined && String(id) === parsed.listing_id;
+            });
+            if (!listing) {
+                const structured = {
+                    type: "not_found",
+                    code: "listing_not_found",
+                    message: `No listing with id ${parsed.listing_id}`,
+                };
+                return {
+                    content: [{ type: "json", json: { error: structured } }],
+                    isError: true,
+                    structuredError: structured,
+                };
+            }
+            const issues = [];
+            // Missing-field checks.
+            if (!listing.title)
+                issues.push({ kind: "missing_field", field: "title" });
+            if (!listing.description)
+                issues.push({ kind: "missing_field", field: "description" });
+            if (!listing.sku)
+                issues.push({ kind: "missing_field", field: "sku" });
+            if (listing.suppressed === true) {
+                issues.push({
+                    kind: "suppressed",
+                    ...(listing.status ? { status: listing.status } : {}),
+                });
+            }
+            // 2) Sync queue errors.
+            const queueRes = await ctx.client.raw.GET("/v1/listings/ebay-queue", {
+                params: { query: { page_size: 100 } },
+            });
+            if (queueRes.error)
+                throw queueRes.error;
+            const queue = (queueRes.data ?? {});
+            for (const entry of queue.data ?? []) {
+                if (entry.list_item_id !== undefined &&
+                    String(entry.list_item_id) === parsed.listing_id) {
+                    issues.push({
+                        kind: "sync_error",
+                        ...(entry.error_code ? { code: entry.error_code } : {}),
+                        ...(entry.error_message ? { message: entry.error_message } : {}),
+                    });
+                }
+            }
+            // 3) Stockout signal.
+            if (listing.sku) {
+                const lowRes = await ctx.client.raw.GET("/v1/reports/inventory/low-stock", { params: { query: { search_term: listing.sku } } });
+                if (lowRes.error)
+                    throw lowRes.error;
+                const low = (lowRes.data ?? {});
+                for (const row of low.data ?? []) {
+                    if (row.sku === listing.sku &&
+                        typeof row.available === "number" &&
+                        row.available <= 0) {
+                        issues.push({
+                            kind: "stockout",
+                            sku: row.sku,
+                            available: row.available,
+                        });
+                    }
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "json",
+                        json: {
+                            listing_id: parsed.listing_id,
+                            ok: issues.length === 0,
+                            issues,
+                        },
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return mapSdkErrorToToolResult(err);
+        }
+    },
+};
+export default checkListingHealth;
+//# sourceMappingURL=check_listing_health.js.map

package/dist/tools/tasks/check_listing_health.js.map

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

package/dist/tools/tasks/create_and_submit_purchase_order.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const createAndSubmitPurchaseOrder: ToolModule;
+export default createAndSubmitPurchaseOrder;
+//# sourceMappingURL=create_and_submit_purchase_order.d.ts.map

package/dist/tools/tasks/create_and_submit_purchase_order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_and_submit_purchase_order.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/create_and_submit_purchase_order.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAoCxB,QAAA,MAAM,4BAA4B,EAAE,UA4GnC,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/dist/tools/tasks/create_and_submit_purchase_order.js

@@ -0,0 +1,142 @@
+// =============================================================================
+// src/tools/tasks/create_and_submit_purchase_order.ts
+// Wave: W6 — Stream B (task-shaped MCP tools)
+//
+// Endpoint mapping note:
+//   The snapshot does not expose POST /v1/vendors/purchase-orders/draft or
+//   POST /v1/vendors/purchase-orders/{id}/submit verbatim. The closest path
+//   that creates a PO source row is POST /v1/vendors/po-sources, and the
+//   only PO mutation operation is PUT /v1/vendors/purchase-orders/{id}. We
+//   compose those: 1) POST /v1/vendors/po-sources to register the PO draft
+//   for each item, 2) PUT /v1/vendors/purchase-orders/{id} to mark
+//   `status: "submitted"`. If the draft endpoint is later added, a one-line
+//   change to the path will switch over.
+// =============================================================================
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    vendor_id: z
+        .string()
+        .min(1)
+        .describe("Vendor id (the supplier the PO is issued to)."),
+    items: z
+        .array(z.object({
+        sku: z.string().min(1).describe("SKU to order."),
+        quantity: z
+            .number()
+            .int()
+            .positive()
+            .describe("Units to order. Must be a positive integer."),
+        unit_cost: z
+            .number()
+            .nonnegative()
+            .optional()
+            .describe("Optional unit cost override; vendor catalog default used otherwise."),
+    }))
+        .min(1, "At least one item is required"),
+    expected_arrival: z
+        .string()
+        .optional()
+        .describe("Optional ISO-8601 date the buyer expects delivery."),
+});
+const createAndSubmitPurchaseOrder = {
+    name: "create_and_submit_purchase_order",
+    kind: "task",
+    // Creates a PO and dispatches it to the vendor; financial side-effect.
+    destructiveHint: true,
+    description: "Drafts and submits a purchase order to a vendor in one workflow. POSTs each requested item to /v1/vendors/po-sources to build the PO draft, then PUTs /v1/vendors/purchase-orders/{id} with `status: \"submitted\"` to release it to the vendor. Returns the final PO. Use this when the user asks to 'order from vendor X' or 'send a PO for these SKUs' — the tool removes the two-step draft/submit dance the user would otherwise have to do manually.",
+    required_scope: "vendors:write",
+    inputSchema,
+    async handle(args, ctx) {
+        const parsed = inputSchema.parse(args);
+        try {
+            // 1) Create a PO source row per item. The first response carries the PO id.
+            let purchaseOrderId;
+            const itemResults = [];
+            for (const item of parsed.items) {
+                try {
+                    const body = {
+                        vendor_id: parsed.vendor_id,
+                        sku: item.sku,
+                        quantity: item.quantity,
+                    };
+                    if (item.unit_cost !== undefined)
+                        body["unit_cost"] = item.unit_cost;
+                    if (purchaseOrderId !== undefined) {
+                        body["purchase_order_id"] = purchaseOrderId;
+                    }
+                    const sourceRes = await ctx.client.raw.POST("/v1/vendors/po-sources", { body });
+                    if (sourceRes.error)
+                        throw sourceRes.error;
+                    const src = (sourceRes.data ?? {});
+                    if (purchaseOrderId === undefined) {
+                        purchaseOrderId = src.purchase_order_id ?? src.id;
+                    }
+                    itemResults.push({ sku: item.sku, status: "ok" });
+                }
+                catch (err) {
+                    const e = err;
+                    if (e?.type === "permission_denied" || e?.type === "authentication_error") {
+                        return mapSdkErrorToToolResult(err);
+                    }
+                    itemResults.push({
+                        sku: item.sku,
+                        status: "failed",
+                        error: e?.message ?? String(err),
+                    });
+                }
+            }
+            if (purchaseOrderId === undefined) {
+                return {
+                    content: [
+                        {
+                            type: "json",
+                            json: {
+                                error: {
+                                    type: "invalid_request",
+                                    code: "po_draft_failed",
+                                    message: "Could not create any PO line items.",
+                                },
+                                items: itemResults,
+                            },
+                        },
+                    ],
+                    isError: true,
+                    structuredError: {
+                        type: "invalid_request",
+                        code: "po_draft_failed",
+                        message: "Could not create any PO line items.",
+                    },
+                };
+            }
+            // 2) Submit the PO.
+            const submitBody = { status: "submitted" };
+            if (parsed.expected_arrival)
+                submitBody["expected_arrival"] = parsed.expected_arrival;
+            const submitRes = await ctx.client.raw.PUT("/v1/vendors/purchase-orders/{id}", {
+                params: { path: { id: String(purchaseOrderId) } },
+                body: submitBody,
+            });
+            if (submitRes.error)
+                throw submitRes.error;
+            return {
+                content: [
+                    {
+                        type: "json",
+                        json: {
+                            vendor_id: parsed.vendor_id,
+                            purchase_order_id: purchaseOrderId,
+                            items: itemResults,
+                            purchase_order: submitRes.data,
+                        },
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return mapSdkErrorToToolResult(err);
+        }
+    },
+};
+export default createAndSubmitPurchaseOrder;
+//# sourceMappingURL=create_and_submit_purchase_order.js.map

package/dist/tools/tasks/create_and_submit_purchase_order.js.map

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

package/dist/tools/tasks/find_product_by_sku.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const findProductBySku: ToolModule;
+export default findProductBySku;
+//# sourceMappingURL=find_product_by_sku.d.ts.map

package/dist/tools/tasks/find_product_by_sku.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_product_by_sku.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/find_product_by_sku.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuBxB,QAAA,MAAM,gBAAgB,EAAE,UAqDvB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/tools/tasks/find_product_by_sku.js

@@ -0,0 +1,68 @@
+// =============================================================================
+// src/tools/tasks/find_product_by_sku.ts
+// Wave: W6 — Stream B (task-shaped MCP tools)
+//
+// Endpoint mapping note:
+//   The OpenAPI snapshot has no first-class "products?sku=" filter. The closest
+//   match is GET /v1/catalog/products with `search_term`, then we filter the
+//   page client-side to find an exact SKU match. This mirrors the W5 CLI's
+//   resource driver, which also issues `client.raw.GET(...)`.
+// =============================================================================
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    sku: z
+        .string()
+        .min(1, "sku must not be empty")
+        .max(256, "sku is unreasonably long")
+        .describe("Exact merchant SKU to look up."),
+});
+const findProductBySku = {
+    name: "find_product_by_sku",
+    kind: "task",
+    // Lookup-only across the catalog index; no writes.
+    readOnlyHint: true,
+    description: "Looks up a single catalog product by its exact merchant SKU. Issues GET /v1/catalog/products?search_term=<sku>, then returns the first product whose `sku` matches exactly (case-insensitive). Returns a `not_found` structuredError when no exact match exists. Use this when the user gives a SKU and you need the canonical product (id, name, price, attributes) to drive a follow-up workflow such as listing, fulfillment, or PO creation.",
+    required_scope: "catalog:read",
+    inputSchema,
+    async handle(args, ctx) {
+        const parsed = inputSchema.parse(args);
+        const sku = parsed.sku;
+        try {
+            const result = await ctx.client.raw.GET("/v1/catalog/products", {
+                params: { query: { search_term: sku, limit: 50 } },
+            });
+            if (result.error)
+                throw result.error;
+            const page = (result.data ?? {});
+            const products = page.data ?? [];
+            const exact = products.find((p) => typeof p.sku === "string" &&
+                p.sku.toLowerCase() === sku.toLowerCase());
+            if (!exact) {
+                const structured = {
+                    type: "not_found",
+                    code: "product_sku_not_found",
+                    message: `No product with SKU ${sku}`,
+                };
+                return {
+                    content: [{ type: "json", json: { error: structured } }],
+                    isError: true,
+                    structuredError: structured,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "json",
+                        json: { product: exact },
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return mapSdkErrorToToolResult(err);
+        }
+    },
+};
+export default findProductBySku;
+//# sourceMappingURL=find_product_by_sku.js.map

package/dist/tools/tasks/find_product_by_sku.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_product_by_sku.js","sourceRoot":"","sources":["../../../src/tools/tasks/find_product_by_sku.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yCAAyC;AACzC,8CAA8C;AAC9C,EAAE;AACF,yBAAyB;AACzB,gFAAgF;AAChF,6EAA6E;AAC7E,2EAA2E;AAC3E,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;SAC/B,GAAG,CAAC,GAAG,EAAE,0BAA0B,CAAC;SACpC,QAAQ,CAAC,gCAAgC,CAAC;CAC9C,CAAC,CAAC;AAeH,MAAM,gBAAgB,GAAe;IACnC,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,MAAM;IACZ,mDAAmD;IACnD,YAAY,EAAE,IAAI;IAClB,WAAW,EACT,kbAAkb;IACpb,cAAc,EAAE,cAAc;IAC9B,WAAW;IAEX,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG;QACpB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAsB,EAAE;gBAC9D,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;aACnD,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,KAAK;gBAAE,MAAM,MAAM,CAAC,KAAK,CAAC;YAErC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAoB,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;gBACzB,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAC5C,CAAC;YAEF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,UAAU,GAAoB;oBAClC,IAAI,EAAE,WAAW;oBACjB,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,uBAAuB,GAAG,EAAE;iBACtC,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;oBACxD,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,UAAU;iBAC5B,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;qBACzB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/tools/tasks/fulfill_order.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const fulfillOrder: ToolModule;
+export default fulfillOrder;
+//# sourceMappingURL=fulfill_order.d.ts.map

package/dist/tools/tasks/fulfill_order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfill_order.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/fulfill_order.ts"],"names":[],"mappings":"AAoBA,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAkCxB,QAAA,MAAM,YAAY,EAAE,UA2GnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/tools/tasks/fulfill_order.js

@@ -0,0 +1,121 @@
+// =============================================================================
+// src/tools/tasks/fulfill_order.ts
+// Wave: W6 — Stream B (task-shaped MCP tools)
+//
+// Endpoint mapping note:
+//   The snapshot does not expose a generic /v1/fulfillment/quotes endpoint.
+//   Instead we use the `ship-now` flow:
+//     1) GET  /v1/orders/{id}                                    — order detail
+//     2) GET  /v1/fulfillment/ship-now/{orderId}/draft          — draft + carrier
+//                                                                   options
+//     3) POST /v1/fulfillment/ship-now/{orderId}/rates/{processorCode}
+//                                                                — rate quotes
+//                                                                   (one carrier)
+//     4) POST /v1/fulfillment/ship-now/{orderId}/print           — submit shipment
+//     5) GET  /v1/fulfillment/ship-now/{orderId}/tracking        — tracking
+//   Carrier selection: if `preferred_carrier` is supplied we use it as
+//   processorCode; otherwise we pick the first carrier the draft proposes.
+// =============================================================================
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    order_id: z.string().min(1).describe("Order id to fulfill."),
+    preferred_carrier: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Optional carrier processor code (e.g. 'usps', 'ups', 'fedex'). When omitted, the cheapest available carrier from the draft is used."),
+});
+const fulfillOrder = {
+    name: "fulfill_order",
+    kind: "task",
+    // Marks an order shipped and pushes tracking to the marketplace; irreversible from the buyer's view.
+    destructiveHint: true,
+    description: "Fulfills an order end-to-end: reads the order, generates a ship-now draft, queries carrier rates (using the preferred carrier when supplied), submits the print/label call, and returns the resulting tracking info. This composes 4-5 SDK calls. Use this when a user asks to 'ship', 'fulfill', or 'create a label' for an order. If multiple carriers are available and no preference is given, the tool selects the first carrier the platform proposes.",
+    required_scope: "fulfillment:write",
+    inputSchema,
+    async handle(args, ctx) {
+        const parsed = inputSchema.parse(args);
+        try {
+            // 1) Read the order so we can echo basic details.
+            const orderRes = await ctx.client.raw.GET("/v1/orders/{id}", {
+                params: { path: { id: parsed.order_id } },
+            });
+            if (orderRes.error)
+                throw orderRes.error;
+            // 2) Get a ship-now draft (carrier candidates).
+            const draftRes = await ctx.client.raw.GET("/v1/fulfillment/ship-now/{orderId}/draft", { params: { path: { orderId: parsed.order_id } } });
+            if (draftRes.error)
+                throw draftRes.error;
+            const draft = (draftRes.data ?? {});
+            // 3) Pick a carrier.
+            let processorCode = parsed.preferred_carrier;
+            if (!processorCode) {
+                const first = draft.available_carriers?.[0];
+                processorCode =
+                    first?.processor_code ?? first?.carrier_code ?? first?.code;
+            }
+            if (!processorCode) {
+                return {
+                    content: [
+                        {
+                            type: "json",
+                            json: {
+                                error: {
+                                    type: "invalid_request",
+                                    code: "no_carrier_available",
+                                    message: "No carrier could be selected for this order. Pass `preferred_carrier` explicitly.",
+                                },
+                            },
+                        },
+                    ],
+                    isError: true,
+                    structuredError: {
+                        type: "invalid_request",
+                        code: "no_carrier_available",
+                        message: "No carrier could be selected for this order. Pass `preferred_carrier` explicitly.",
+                    },
+                };
+            }
+            // 4) Get rates for that carrier.
+            const ratesRes = await ctx.client.raw.POST("/v1/fulfillment/ship-now/{orderId}/rates/{processorCode}", {
+                params: {
+                    path: { orderId: parsed.order_id, processorCode },
+                },
+            });
+            if (ratesRes.error)
+                throw ratesRes.error;
+            const rates = (ratesRes.data ?? {});
+            // 5) Submit the print (creates the actual shipment).
+            const printRes = await ctx.client.raw.POST("/v1/fulfillment/ship-now/{orderId}/print", {
+                params: { path: { orderId: parsed.order_id } },
+            });
+            if (printRes.error)
+                throw printRes.error;
+            // 6) Pull tracking info.
+            const trackingRes = await ctx.client.raw.GET("/v1/fulfillment/ship-now/{orderId}/tracking", { params: { path: { orderId: parsed.order_id } } });
+            if (trackingRes.error)
+                throw trackingRes.error;
+            const tracking = (trackingRes.data ?? {});
+            return {
+                content: [
+                    {
+                        type: "json",
+                        json: {
+                            order_id: parsed.order_id,
+                            carrier: processorCode,
+                            rates_count: rates.rates?.length ?? 0,
+                            tracking,
+                            order: orderRes.data,
+                        },
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return mapSdkErrorToToolResult(err);
+        }
+    },
+};
+export default fulfillOrder;
+//# sourceMappingURL=fulfill_order.js.map

package/dist/tools/tasks/fulfill_order.js.map

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

package/dist/tools/tasks/get_inventory_across_warehouses.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const getInventoryAcrossWarehouses: ToolModule;
+export default getInventoryAcrossWarehouses;
+//# sourceMappingURL=get_inventory_across_warehouses.d.ts.map

package/dist/tools/tasks/get_inventory_across_warehouses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_inventory_across_warehouses.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/get_inventory_across_warehouses.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AA2BxB,QAAA,MAAM,4BAA4B,EAAE,UA8GnC,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/dist/tools/tasks/get_inventory_across_warehouses.js

@@ -0,0 +1,118 @@
+// =============================================================================
+// src/tools/tasks/get_inventory_across_warehouses.ts
+// Wave: W6 — Stream B (task-shaped MCP tools)
+//
+// Endpoint mapping note:
+//   We resolve the SKU -> product first (search /v1/catalog/products), then
+//   call /v1/catalog/products/{id}/warehouse-availability which returns a
+//   warehouse-keyed availability vector. We additionally GET
+//   /v1/inventory/warehouses to enrich each row with the warehouse name. So
+//   technically only 1 fan-out per warehouse is needed for "name" lookup,
+//   but the brief asked for "fan out one GET per warehouse" — we satisfy
+//   that semantic by calling /v1/inventory/warehouses/{id} for each
+//   warehouse in the availability response.
+// =============================================================================
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    sku: z.string().min(1).describe("SKU to look up across warehouses."),
+});
+const getInventoryAcrossWarehouses = {
+    name: "get_inventory_across_warehouses",
+    kind: "task",
+    // Reads inventory levels from multiple warehouses; no writes.
+    readOnlyHint: true,
+    description: "Aggregates on-hand / reserved / available inventory for a SKU across every warehouse. Resolves SKU to product id via /v1/catalog/products, fetches the per-warehouse vector via /v1/catalog/products/{id}/warehouse-availability, then fans out one GET /v1/inventory/warehouses/{id} per warehouse to enrich each row with the warehouse name. Returns a flat list. Use this when the user asks 'how many of SKU X do I have' or 'where is SKU X' — they want a per-warehouse view, not a single number.",
+    required_scope: "inventory:read",
+    inputSchema,
+    async handle(args, ctx) {
+        const parsed = inputSchema.parse(args);
+        try {
+            // 1) SKU -> product id.
+            const lookupRes = await ctx.client.raw.GET("/v1/catalog/products", {
+                params: { query: { search_term: parsed.sku, limit: 50 } },
+            });
+            if (lookupRes.error)
+                throw lookupRes.error;
+            const page = (lookupRes.data ?? {});
+            const product = page.data?.find((p) => typeof p.sku === "string" &&
+                p.sku.toLowerCase() === parsed.sku.toLowerCase());
+            if (!product?.id) {
+                const structured = {
+                    type: "not_found",
+                    code: "product_sku_not_found",
+                    message: `No product with SKU ${parsed.sku}`,
+                };
+                return {
+                    content: [{ type: "json", json: { error: structured } }],
+                    isError: true,
+                    structuredError: structured,
+                };
+            }
+            // 2) Warehouse availability for that product.
+            const availRes = await ctx.client.raw.GET("/v1/catalog/products/{id}/warehouse-availability", { params: { path: { id: product.id } } });
+            if (availRes.error)
+                throw availRes.error;
+            const avail = (availRes.data ?? {});
+            const rows = avail.warehouses ?? [];
+            // 3) Fan out one GET per warehouse for names.
+            const enriched = await Promise.all(rows.map(async (row) => {
+                const warehouseId = row.warehouse_id;
+                if (warehouseId === undefined || warehouseId === null) {
+                    return {
+                        warehouse_id: null,
+                        warehouse_name: null,
+                        on_hand: row.on_hand ?? 0,
+                        reserved: row.reserved ?? 0,
+                        available: row.available ?? 0,
+                    };
+                }
+                let name = null;
+                try {
+                    const whRes = await ctx.client.raw.GET("/v1/inventory/warehouses/{id}", {
+                        params: {
+                            path: { id: String(warehouseId) },
+                        },
+                    });
+                    if (!whRes.error) {
+                        const wh = (whRes.data ?? {});
+                        name = wh.name ?? null;
+                    }
+                }
+                catch {
+                    // Per-warehouse name fetch is best-effort; continue without it.
+                    name = null;
+                }
+                return {
+                    warehouse_id: warehouseId,
+                    warehouse_name: name,
+                    on_hand: row.on_hand ?? 0,
+                    reserved: row.reserved ?? 0,
+                    available: row.available ?? 0,
+                };
+            }));
+            return {
+                content: [
+                    {
+                        type: "json",
+                        json: {
+                            sku: parsed.sku,
+                            product_id: product.id,
+                            warehouses: enriched,
+                            totals: {
+                                on_hand: enriched.reduce((s, r) => s + r.on_hand, 0),
+                                reserved: enriched.reduce((s, r) => s + r.reserved, 0),
+                                available: enriched.reduce((s, r) => s + r.available, 0),
+                            },
+                        },
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return mapSdkErrorToToolResult(err);
+        }
+    },
+};
+export default getInventoryAcrossWarehouses;
+//# sourceMappingURL=get_inventory_across_warehouses.js.map