@5ss/ai-tools 3.6.0 → 3.7.1

package/dist/vendors/shipstation/index.js

@@ -2,30 +2,122 @@ import { t as ToolError } from "../../errors-DoSpNHvs.js";
 import { n as defineModule, r as defineTool } from "../../define-ieoksEQ0.js";
 import { n as requireAuth } from "../../provider-CgDAlg6K.js";
 import { t as HttpService } from "../../http-service-BMBIryAL.js";
+import { n as bytesToBase64, o as utf8ToBytes } from "../../bytes-BxpimpQx.js";
 import { z } from "zod";
 //#region src/vendors/shipstation/contracts.ts
-const shipstationAuthSchema = z.object({ api_key: z.string().min(1).describe("ShipStation V2 API key") });
+const shipstationAuthSchema = z.object({
+	v2_api_key: z.string().min(1).describe("ShipStation V2 API key"),
+	v1_api_key: z.string().min(1).describe("ShipStation V1 API key"),
+	v1_api_secret: z.string().min(1).describe("ShipStation V1 API secret")
+});
 const shipstationPageSchema = z.int().min(1).optional().describe("Provider page number, starting at 1");
 const shipstationPageSizeSchema = z.int().min(1).max(500).optional().describe("Records per page, from 1 to 500; defaults to 25");
+const shipstationMoneySchema = z.looseObject({
+	currency: z.string().min(1),
+	amount: z.number().nonnegative()
+});
+const shipstationRefundDetailsRawSchema = z.looseObject({
+	refund_status: z.string().nullable().optional(),
+	request_date: z.string().nullable().optional(),
+	amount_paid: shipstationMoneySchema.nullable().optional(),
+	amount_requested: shipstationMoneySchema.nullable().optional()
+});
 const shipstationLabelRawSchema = z.looseObject({
 	label_id: z.string().min(1),
 	shipment_id: z.string().nullable().optional(),
+	external_shipment_id: z.string().nullable().optional(),
 	external_order_id: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	service_code: z.string().nullable().optional(),
 	tracking_number: z.string().nullable().optional(),
 	created_at: z.string().nullable().optional(),
 	modified_at: z.string().nullable().optional(),
 	ship_date: z.string().nullable().optional(),
+	shipment_cost: shipstationMoneySchema.nullable().optional(),
+	insurance_cost: shipstationMoneySchema.nullable().optional(),
+	voided: z.boolean().nullable().optional(),
 	voided_at: z.string().nullable().optional(),
+	refund_details: shipstationRefundDetailsRawSchema.nullable().optional(),
 	status: z.string().nullable().optional()
 });
 const shipstationShipmentRawSchema = z.looseObject({
 	shipment_id: z.string().min(1),
 	external_order_id: z.string().nullable().optional(),
 	shipment_number: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	service_code: z.string().nullable().optional(),
+	store_id: z.string().nullable().optional(),
 	created_at: z.string().nullable().optional(),
 	modified_at: z.string().nullable().optional(),
 	shipment_status: z.string().nullable().optional()
 });
+const shipstationFulfillmentRawSchema = z.looseObject({
+	fulfillment_id: z.string().min(1),
+	shipment_id: z.string().nullable().optional(),
+	shipment_number: z.string().nullable().optional(),
+	tracking_number: z.string().nullable().optional(),
+	carrier_code: z.string().nullable().optional(),
+	fulfillment_provider_code: z.string().nullable().optional(),
+	created_at: z.string().nullable().optional(),
+	ship_date: z.string().nullable().optional()
+});
+const shipstationCarrierServiceRawSchema = z.looseObject({
+	service_code: z.string().min(1),
+	name: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	carrier_code: z.string().nullable().optional(),
+	domestic: z.boolean().nullable().optional(),
+	international: z.boolean().nullable().optional()
+});
+const shipstationCarrierPackageRawSchema = z.looseObject({
+	package_code: z.string().min(1),
+	name: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	carrier_code: z.string().nullable().optional()
+});
+const shipstationCarrierOptionRawSchema = z.looseObject({
+	name: z.string().min(1),
+	description: z.string().nullable().optional(),
+	default_value: z.union([
+		z.string(),
+		z.number(),
+		z.boolean()
+	]).nullable().optional()
+});
+const shipstationCarrierRawSchema = z.looseObject({
+	carrier_id: z.string().min(1),
+	carrier_code: z.string().nullable().optional(),
+	account_number: z.string().nullable().optional(),
+	nickname: z.string().nullable().optional(),
+	friendly_name: z.string().nullable().optional(),
+	primary: z.boolean().nullable().optional(),
+	connection_status: z.string().nullable().optional(),
+	services: z.array(shipstationCarrierServiceRawSchema).optional(),
+	packages: z.array(shipstationCarrierPackageRawSchema).optional(),
+	options: z.array(shipstationCarrierOptionRawSchema).optional()
+});
+const shipstationOrderRawSchema = z.looseObject({
+	orderId: z.int(),
+	orderNumber: z.string().nullable().optional(),
+	orderKey: z.string().nullable().optional(),
+	orderStatus: z.string().nullable().optional(),
+	createDate: z.string().nullable().optional(),
+	modifyDate: z.string().nullable().optional(),
+	orderDate: z.string().nullable().optional(),
+	paymentDate: z.string().nullable().optional(),
+	shipByDate: z.string().nullable().optional(),
+	storeId: z.int().nullable().optional()
+});
+const shipstationStoreRawSchema = z.looseObject({
+	storeId: z.int(),
+	storeName: z.string().nullable().optional(),
+	marketplaceId: z.int().nullable().optional(),
+	marketplaceName: z.string().nullable().optional(),
+	active: z.boolean().nullable().optional(),
+	createDate: z.string().nullable().optional(),
+	modifyDate: z.string().nullable().optional(),
+	autoRefresh: z.boolean().nullable().optional()
+});
 const shipstationPaginationSchema = z.object({
 	total: z.int().nonnegative(),
 	page: z.int().min(1),
@@ -47,7 +139,7 @@ const shipstationListLabelsPageInputSchema = z.strictObject({
 	warehouse_id: z.string().min(1).optional().describe("ShipStation warehouse id filter"),
 	created_at_start: z.iso.datetime({ offset: true }).optional().describe("Include labels created at or after this ISO 8601 timestamp"),
 	created_at_end: z.iso.datetime({ offset: true }).optional().describe("Include labels created at or before this ISO 8601 timestamp"),
-	refund_status: z.string().min(1).optional().describe("Label refund status filter"),
+	refund_status: z.string().min(1).optional().describe("Comma-separated label refund statuses"),
 	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction; defaults to desc"),
 	sort_by: z.enum([
 		"modified_at",
@@ -84,6 +176,75 @@ const shipstationListShipmentsPageOutputSchema = z.object({
 	items: z.array(shipstationShipmentRawSchema),
 	pagination: shipstationPaginationSchema
 });
+const shipstationListFulfillmentsPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	ship_to_name: z.string().min(1).optional().describe("Recipient name filter"),
+	ship_to_country_code: z.string().length(2).optional().describe("Two-letter destination country code"),
+	shipment_number: z.string().min(1).optional().describe("Shipment number filter"),
+	shipment_id: z.string().min(1).optional().describe("Shipment id filter"),
+	fulfillment_id: z.string().min(1).optional().describe("Fulfillment id filter"),
+	batch_id: z.string().min(1).optional().describe("Batch id filter"),
+	order_source_id: z.string().min(1).optional().describe("Order source id filter"),
+	fulfillment_provider_code: z.string().min(1).optional().describe("Fulfillment provider code filter"),
+	tracking_number: z.string().min(1).optional().describe("Tracking number filter"),
+	ship_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest fulfillment ship time"),
+	ship_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest fulfillment ship time"),
+	create_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest fulfillment creation time"),
+	create_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest fulfillment creation time"),
+	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction"),
+	sort_by: z.literal("created_at").optional().describe("Fulfillment field used to sort the provider slice")
+});
+const shipstationListFulfillmentsPageOutputSchema = z.object({
+	items: z.array(shipstationFulfillmentRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationCarrierIdInputSchema = z.strictObject({ carrier_id: z.string().min(1).describe("ShipStation V2 carrier id") });
+const shipstationListCarriersOutputSchema = z.object({ items: z.array(shipstationCarrierRawSchema) });
+const shipstationGetCarrierOutputSchema = shipstationCarrierRawSchema;
+const shipstationListCarrierServicesOutputSchema = z.object({ items: z.array(shipstationCarrierServiceRawSchema) });
+const shipstationListCarrierPackagesOutputSchema = z.object({ items: z.array(shipstationCarrierPackageRawSchema) });
+const shipstationListCarrierOptionsOutputSchema = z.object({ items: z.array(shipstationCarrierOptionRawSchema) });
+const shipstationListOrdersPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	customer_name: z.string().min(1).optional().describe("Customer name filter"),
+	item_keyword: z.string().min(1).optional().describe("Order item SKU, description, or option filter"),
+	create_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest ShipStation creation time"),
+	create_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest ShipStation creation time"),
+	modify_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest modification time"),
+	modify_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest modification time"),
+	order_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest order time"),
+	order_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest order time"),
+	order_number: z.string().min(1).optional().describe("Order number prefix filter"),
+	order_status: z.enum([
+		"awaiting_payment",
+		"awaiting_shipment",
+		"pending_fulfillment",
+		"shipped",
+		"on_hold",
+		"cancelled",
+		"rejected_fulfillment"
+	]).optional().describe("Order status filter"),
+	payment_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest payment time"),
+	payment_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest payment time"),
+	store_id: z.int().optional().describe("V1 store id filter"),
+	sort_by: z.enum([
+		"OrderDate",
+		"ModifyDate",
+		"CreateDate"
+	]).optional().describe("Order sort field"),
+	sort_dir: z.enum(["ASC", "DESC"]).optional().describe("Order sort direction")
+});
+const shipstationListOrdersPageOutputSchema = z.object({
+	items: z.array(shipstationOrderRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationListStoresInputSchema = z.strictObject({
+	show_inactive: z.boolean().optional().describe("Include inactive stores"),
+	marketplace_id: z.int().optional().describe("Marketplace type id filter")
+});
+const shipstationListStoresOutputSchema = z.object({ items: z.array(shipstationStoreRawSchema) });
 const shipstationListLabelsResponseSchema = z.looseObject({
 	labels: z.array(shipstationLabelRawSchema),
 	total: z.int().nonnegative(),
@@ -96,30 +257,73 @@ const shipstationListShipmentsResponseSchema = z.looseObject({
 	page: z.int().min(1),
 	pages: z.int().nonnegative()
 });
+const shipstationListFulfillmentsResponseSchema = z.looseObject({
+	fulfillments: z.array(shipstationFulfillmentRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListCarriersResponseSchema = z.looseObject({ carriers: z.array(shipstationCarrierRawSchema) });
+const shipstationListCarrierServicesResponseSchema = z.looseObject({ services: z.array(shipstationCarrierServiceRawSchema) });
+const shipstationListCarrierPackagesResponseSchema = z.looseObject({ packages: z.array(shipstationCarrierPackageRawSchema) });
+const shipstationListCarrierOptionsResponseSchema = z.looseObject({ options: z.array(shipstationCarrierOptionRawSchema) });
+const shipstationListOrdersResponseSchema = z.looseObject({
+	orders: z.array(shipstationOrderRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListStoresResponseSchema = z.array(shipstationStoreRawSchema);
 //#endregion
 //#region src/vendors/shipstation/client.ts
-/**
-* ShipStation V2 vendor client.
-* Host: `new ShipstationClient(auth)`. Agent tools: `fromContext(ctx)`.
-*/
-const SHIPSTATION_API_BASE = "https://api.shipstation.com/v2";
+const SHIPSTATION_V2_API_BASE = "https://api.shipstation.com/v2";
+const SHIPSTATION_V1_API_BASE = "https://ssapi.shipstation.com";
 const DEFAULT_PAGE_SIZE = 25;
+function parseInput(schema, input, message) {
+	const parsed = schema.safeParse(input);
+	if (!parsed.success) throw new ToolError(message, {
+		code: "bad_input",
+		details: { issues: parsed.error.issues.map((issue) => issue.message) }
+	});
+	return parsed.data;
+}
+function parseResponse(schema, data, message) {
+	const parsed = schema.safeParse(data);
+	if (!parsed.success) throw new ToolError(message, {
+		code: "upstream",
+		details: { issues: parsed.error.issues.map((issue) => issue.message) }
+	});
+	return parsed.data;
+}
+function v1Authorization(apiKey, apiSecret) {
+	return `Basic ${bytesToBase64(utf8ToBytes(`${apiKey}:${apiSecret}`))}`;
+}
 var ShipstationClient = class ShipstationClient {
-	#http;
+	#v2;
+	#v1;
 	constructor(auth, options = {}) {
 		const parsed = shipstationAuthSchema.safeParse(auth);
 		if (!parsed.success) throw new ToolError("Invalid ShipStation auth credentials", {
 			code: "bad_auth",
 			details: { issues: parsed.error.issues.map((issue) => issue.message) }
 		});
-		this.#http = new HttpService({
+		this.#v2 = new HttpService({
 			...options,
-			baseURL: SHIPSTATION_API_BASE,
+			baseURL: SHIPSTATION_V2_API_BASE,
 			headers: {
 				Accept: "application/json",
-				"API-Key": parsed.data.api_key
+				"API-Key": parsed.data.v2_api_key
 			},
-			label: "ShipStation"
+			label: "ShipStation V2"
+		});
+		this.#v1 = new HttpService({
+			...options,
+			baseURL: SHIPSTATION_V1_API_BASE,
+			headers: {
+				Accept: "application/json",
+				Authorization: v1Authorization(parsed.data.v1_api_key, parsed.data.v1_api_secret)
+			},
+			label: "ShipStation V1"
 		});
 	}
 	static fromContext(ctx) {
@@ -129,79 +333,169 @@ var ShipstationClient = class ShipstationClient {
 			...ctx.signal && { signal: ctx.signal }
 		});
 	}
-	/** One GET /labels request with provider pagination and filters. */
+	/** One V2 GET /labels request with provider pagination and filters. */
 	async listLabelsPage(input = {}) {
-		const parsedInput = shipstationListLabelsPageInputSchema.safeParse(input);
-		if (!parsedInput.success) throw new ToolError("Invalid ShipStation labels page input", {
-			code: "bad_input",
-			details: { issues: parsedInput.error.issues.map((issue) => issue.message) }
-		});
-		const page = parsedInput.data.page ?? 1;
-		const pageSize = parsedInput.data.page_size ?? DEFAULT_PAGE_SIZE;
-		const { data } = await this.#http.get("/labels", {
+		const parsedInput = parseInput(shipstationListLabelsPageInputSchema, input, "Invalid ShipStation labels page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v2.get("/labels", {
 			label: "ShipStation listLabelsPage",
 			query: {
-				...parsedInput.data,
+				...parsedInput,
 				page,
 				page_size: pageSize
 			}
 		});
-		const parsedResponse = shipstationListLabelsResponseSchema.safeParse(data);
-		if (!parsedResponse.success) throw new ToolError("ShipStation returned an invalid labels page", {
-			code: "upstream",
-			details: { issues: parsedResponse.error.issues.map((issue) => issue.message) }
-		});
+		const response = parseResponse(shipstationListLabelsResponseSchema, data, "ShipStation returned an invalid labels page");
 		return {
-			items: parsedResponse.data.labels,
+			items: response.labels,
 			pagination: {
-				total: parsedResponse.data.total,
-				page: parsedResponse.data.page,
-				pages: parsedResponse.data.pages,
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
 				page_size: pageSize,
-				has_more: parsedResponse.data.page < parsedResponse.data.pages
+				has_more: response.page < response.pages
 			}
 		};
 	}
-	/** One GET /shipments request with provider pagination and filters. */
+	/** One V2 GET /shipments request with provider pagination and filters. */
 	async listShipmentsPage(input = {}) {
-		const parsedInput = shipstationListShipmentsPageInputSchema.safeParse(input);
-		if (!parsedInput.success) throw new ToolError("Invalid ShipStation shipments page input", {
-			code: "bad_input",
-			details: { issues: parsedInput.error.issues.map((issue) => issue.message) }
-		});
-		const page = parsedInput.data.page ?? 1;
-		const pageSize = parsedInput.data.page_size ?? DEFAULT_PAGE_SIZE;
-		const { data } = await this.#http.get("/shipments", {
+		const parsedInput = parseInput(shipstationListShipmentsPageInputSchema, input, "Invalid ShipStation shipments page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v2.get("/shipments", {
 			label: "ShipStation listShipmentsPage",
 			query: {
-				...parsedInput.data,
+				...parsedInput,
 				page,
 				page_size: pageSize
 			}
 		});
-		const parsedResponse = shipstationListShipmentsResponseSchema.safeParse(data);
-		if (!parsedResponse.success) throw new ToolError("ShipStation returned an invalid shipments page", {
-			code: "upstream",
-			details: { issues: parsedResponse.error.issues.map((issue) => issue.message) }
+		const response = parseResponse(shipstationListShipmentsResponseSchema, data, "ShipStation returned an invalid shipments page");
+		return {
+			items: response.shipments,
+			pagination: {
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
+				page_size: pageSize,
+				has_more: response.page < response.pages
+			}
+		};
+	}
+	/** One V2 GET /fulfillments request with provider pagination and filters. */
+	async listFulfillmentsPage(input = {}) {
+		const parsedInput = parseInput(shipstationListFulfillmentsPageInputSchema, input, "Invalid ShipStation fulfillments page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v2.get("/fulfillments", {
+			label: "ShipStation listFulfillmentsPage",
+			query: {
+				...parsedInput,
+				page,
+				page_size: pageSize
+			}
 		});
+		const response = parseResponse(shipstationListFulfillmentsResponseSchema, data, "ShipStation returned an invalid fulfillments page");
 		return {
-			items: parsedResponse.data.shipments,
+			items: response.fulfillments,
 			pagination: {
-				total: parsedResponse.data.total,
-				page: parsedResponse.data.page,
-				pages: parsedResponse.data.pages,
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
 				page_size: pageSize,
-				has_more: parsedResponse.data.page < parsedResponse.data.pages
+				has_more: response.page < response.pages
 			}
 		};
 	}
+	/** V2 GET /carriers. */
+	async listCarriers() {
+		const { data } = await this.#v2.get("/carriers", { label: "ShipStation listCarriers" });
+		return { items: parseResponse(shipstationListCarriersResponseSchema, data, "ShipStation returned an invalid carriers response").carriers };
+	}
+	/** V2 GET /carriers/{carrier_id}. */
+	async getCarrier(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}`, { label: "ShipStation getCarrier" });
+		return parseResponse(shipstationCarrierRawSchema, data, "ShipStation returned an invalid carrier");
+	}
+	/** V2 GET /carriers/{carrier_id}/services. */
+	async listCarrierServices(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}/services`, { label: "ShipStation listCarrierServices" });
+		return { items: parseResponse(shipstationListCarrierServicesResponseSchema, data, "ShipStation returned invalid carrier services").services };
+	}
+	/** V2 GET /carriers/{carrier_id}/packages. */
+	async listCarrierPackages(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}/packages`, { label: "ShipStation listCarrierPackages" });
+		return { items: parseResponse(shipstationListCarrierPackagesResponseSchema, data, "ShipStation returned invalid carrier packages").packages };
+	}
+	/** V2 GET /carriers/{carrier_id}/options. */
+	async listCarrierOptions(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}/options`, { label: "ShipStation listCarrierOptions" });
+		return { items: parseResponse(shipstationListCarrierOptionsResponseSchema, data, "ShipStation returned invalid carrier options").options };
+	}
+	/** One legacy V1 GET /orders request. */
+	async listOrdersPage(input = {}) {
+		const parsedInput = parseInput(shipstationListOrdersPageInputSchema, input, "Invalid ShipStation orders page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v1.get("/orders", {
+			label: "ShipStation listOrdersPage",
+			query: {
+				page,
+				pageSize,
+				...parsedInput.customer_name && { customerName: parsedInput.customer_name },
+				...parsedInput.item_keyword && { itemKeyword: parsedInput.item_keyword },
+				...parsedInput.create_date_start && { createDateStart: parsedInput.create_date_start },
+				...parsedInput.create_date_end && { createDateEnd: parsedInput.create_date_end },
+				...parsedInput.modify_date_start && { modifyDateStart: parsedInput.modify_date_start },
+				...parsedInput.modify_date_end && { modifyDateEnd: parsedInput.modify_date_end },
+				...parsedInput.order_date_start && { orderDateStart: parsedInput.order_date_start },
+				...parsedInput.order_date_end && { orderDateEnd: parsedInput.order_date_end },
+				...parsedInput.order_number && { orderNumber: parsedInput.order_number },
+				...parsedInput.order_status && { orderStatus: parsedInput.order_status },
+				...parsedInput.payment_date_start && { paymentDateStart: parsedInput.payment_date_start },
+				...parsedInput.payment_date_end && { paymentDateEnd: parsedInput.payment_date_end },
+				...parsedInput.store_id !== void 0 && { storeId: parsedInput.store_id },
+				...parsedInput.sort_by && { sortBy: parsedInput.sort_by },
+				...parsedInput.sort_dir && { sortDir: parsedInput.sort_dir }
+			}
+		});
+		const response = parseResponse(shipstationListOrdersResponseSchema, data, "ShipStation returned an invalid orders page");
+		return {
+			items: response.orders,
+			pagination: {
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
+				page_size: pageSize,
+				has_more: response.page < response.pages
+			}
+		};
+	}
+	/** Legacy V1 GET /stores. */
+	async listStores(input = {}) {
+		const parsedInput = parseInput(shipstationListStoresInputSchema, input, "Invalid ShipStation stores input");
+		const { data } = await this.#v1.get("/stores", {
+			label: "ShipStation listStores",
+			query: {
+				...parsedInput.show_inactive !== void 0 && { showInactive: parsedInput.show_inactive },
+				...parsedInput.marketplace_id !== void 0 && { marketplaceId: parsedInput.marketplace_id }
+			}
+		});
+		return { items: parseResponse(shipstationListStoresResponseSchema, data, "ShipStation returned an invalid stores response") };
+	}
 };
 //#endregion
 //#region src/vendors/shipstation/module.ts
+const emptyInputSchema = z.strictObject({}).describe("No input fields");
 const shipstationListLabelsTool = defineTool({
 	id: "shipstation-list-labels",
 	name: "shipstationListLabels",
-	description: "List one page of ShipStation labels. Filter by creation time, status, carrier, service, tracking number, shipment, warehouse, batch, rate, or refund status.",
+	description: "List one V2 page of ShipStation labels, including shipping and insurance cost, carrier, service, tracking, void, and refund data.",
 	inputSchema: shipstationListLabelsPageInputSchema,
 	outputSchema: shipstationListLabelsPageOutputSchema,
 	sideEffect: "read",
@@ -213,6 +507,7 @@ const shipstationListLabelsTool = defineTool({
 		"labels",
 		"shipping",
 		"tracking",
+		"costs",
 		"fulfillment"
 	],
 	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listLabelsPage(input)
@@ -220,7 +515,7 @@ const shipstationListLabelsTool = defineTool({
 const shipstationListShipmentsTool = defineTool({
 	id: "shipstation-list-shipments",
 	name: "shipstationListShipments",
-	description: "List one page of ShipStation shipments. Filter by creation, modification, or payment time plus status, order, store, recipient, item, batch, pickup, or shipment identifiers.",
+	description: "List one V2 page of ShipStation shipments. Filter by time, status, order, store, recipient, item, batch, pickup, or shipment identifiers.",
 	inputSchema: shipstationListShipmentsPageInputSchema,
 	outputSchema: shipstationListShipmentsPageOutputSchema,
 	sideEffect: "read",
@@ -236,10 +531,146 @@ const shipstationListShipmentsTool = defineTool({
 	],
 	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listShipmentsPage(input)
 });
+const shipstationListFulfillmentsTool = defineTool({
+	id: "shipstation-list-fulfillments",
+	name: "shipstationListFulfillments",
+	description: "List one V2 page of completed ShipStation fulfillments with shipment, provider, tracking, creation, and ship-date filters.",
+	inputSchema: shipstationListFulfillmentsPageInputSchema,
+	outputSchema: shipstationListFulfillmentsPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"fulfillments",
+		"shipments",
+		"tracking"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listFulfillmentsPage(input)
+});
+const shipstationListCarriersTool = defineTool({
+	id: "shipstation-list-carriers",
+	name: "shipstationListCarriers",
+	description: "List connected V2 ShipStation carrier accounts and their available shipping capabilities.",
+	inputSchema: emptyInputSchema,
+	outputSchema: shipstationListCarriersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: ["carriers", "shipping"],
+	execute: async (_input, ctx) => ShipstationClient.fromContext(ctx).listCarriers()
+});
+const shipstationGetCarrierTool = defineTool({
+	id: "shipstation-get-carrier",
+	name: "shipstationGetCarrier",
+	description: "Get one connected V2 ShipStation carrier account and its capabilities.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationGetCarrierOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: ["carriers", "shipping"],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).getCarrier(input)
+});
+const shipstationListCarrierServicesTool = defineTool({
+	id: "shipstation-list-carrier-services",
+	name: "shipstationListCarrierServices",
+	description: "List shipping services available through one V2 ShipStation carrier account.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationListCarrierServicesOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"carriers",
+		"services",
+		"shipping"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listCarrierServices(input)
+});
+const shipstationListCarrierPackagesTool = defineTool({
+	id: "shipstation-list-carrier-packages",
+	name: "shipstationListCarrierPackages",
+	description: "List package types available through one V2 ShipStation carrier account.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationListCarrierPackagesOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"carriers",
+		"packages",
+		"shipping"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listCarrierPackages(input)
+});
+const shipstationListCarrierOptionsTool = defineTool({
+	id: "shipstation-list-carrier-options",
+	name: "shipstationListCarrierOptions",
+	description: "List advanced options available through one V2 ShipStation carrier account.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationListCarrierOptionsOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"carriers",
+		"options",
+		"shipping"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listCarrierOptions(input)
+});
+const shipstationListOrdersTool = defineTool({
+	id: "shipstation-list-orders",
+	name: "shipstationListOrders",
+	description: "List one legacy V1 page of ShipStation sales orders. Filter by creation, modification, order, or payment time plus customer, item, number, status, or store.",
+	inputSchema: shipstationListOrdersPageInputSchema,
+	outputSchema: shipstationListOrdersPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"orders",
+		"sales",
+		"stores"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listOrdersPage(input)
+});
+const shipstationListStoresTool = defineTool({
+	id: "shipstation-list-stores",
+	name: "shipstationListStores",
+	description: "List installed legacy V1 ShipStation stores, optionally including inactive stores or one marketplace.",
+	inputSchema: shipstationListStoresInputSchema,
+	outputSchema: shipstationListStoresOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"stores",
+		"orders",
+		"marketplaces"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listStores(input)
+});
 const shipstationModule = defineModule({
 	id: "shipstation",
 	title: "ShipStation",
-	description: "ShipStation V2 vendor pack for paginated label and shipment reads.",
+	description: "Hybrid ShipStation pack: V2 shipping operations plus legacy V1 sales orders and stores.",
 	runtime: "both",
 	auth: {
 		type: "custom",
@@ -250,12 +681,26 @@ const shipstationModule = defineModule({
 	tags: [
 		"labels",
 		"shipments",
-		"tracking",
-		"fulfillment"
+		"fulfillments",
+		"carriers",
+		"orders",
+		"stores",
+		"tracking"
 	],
-	tools: [shipstationListLabelsTool, shipstationListShipmentsTool]
+	tools: [
+		shipstationListLabelsTool,
+		shipstationListShipmentsTool,
+		shipstationListFulfillmentsTool,
+		shipstationListCarriersTool,
+		shipstationGetCarrierTool,
+		shipstationListCarrierServicesTool,
+		shipstationListCarrierPackagesTool,
+		shipstationListCarrierOptionsTool,
+		shipstationListOrdersTool,
+		shipstationListStoresTool
+	]
 });
 //#endregion
-export { ShipstationClient, shipstationAuthSchema, shipstationLabelRawSchema, shipstationListLabelsPageInputSchema, shipstationListLabelsPageOutputSchema, shipstationListLabelsResponseSchema, shipstationListLabelsTool, shipstationListShipmentsPageInputSchema, shipstationListShipmentsPageOutputSchema, shipstationListShipmentsResponseSchema, shipstationListShipmentsTool, shipstationModule, shipstationPaginationSchema, shipstationShipmentRawSchema };
+export { ShipstationClient, shipstationAuthSchema, shipstationCarrierIdInputSchema, shipstationCarrierOptionRawSchema, shipstationCarrierPackageRawSchema, shipstationCarrierRawSchema, shipstationCarrierServiceRawSchema, shipstationFulfillmentRawSchema, shipstationGetCarrierOutputSchema, shipstationGetCarrierTool, shipstationLabelRawSchema, shipstationListCarrierOptionsOutputSchema, shipstationListCarrierOptionsResponseSchema, shipstationListCarrierOptionsTool, shipstationListCarrierPackagesOutputSchema, shipstationListCarrierPackagesResponseSchema, shipstationListCarrierPackagesTool, shipstationListCarrierServicesOutputSchema, shipstationListCarrierServicesResponseSchema, shipstationListCarrierServicesTool, shipstationListCarriersOutputSchema, shipstationListCarriersResponseSchema, shipstationListCarriersTool, shipstationListFulfillmentsPageInputSchema, shipstationListFulfillmentsPageOutputSchema, shipstationListFulfillmentsResponseSchema, shipstationListFulfillmentsTool, shipstationListLabelsPageInputSchema, shipstationListLabelsPageOutputSchema, shipstationListLabelsResponseSchema, shipstationListLabelsTool, shipstationListOrdersPageInputSchema, shipstationListOrdersPageOutputSchema, shipstationListOrdersResponseSchema, shipstationListOrdersTool, shipstationListShipmentsPageInputSchema, shipstationListShipmentsPageOutputSchema, shipstationListShipmentsResponseSchema, shipstationListShipmentsTool, shipstationListStoresInputSchema, shipstationListStoresOutputSchema, shipstationListStoresResponseSchema, shipstationListStoresTool, shipstationModule, shipstationMoneySchema, shipstationOrderRawSchema, shipstationPaginationSchema, shipstationRefundDetailsRawSchema, shipstationShipmentRawSchema, shipstationStoreRawSchema };
 
 //# sourceMappingURL=index.js.map